Asterisk

Written By Maruf Ansari

Last updated 27 days ago

Asterisk is one of the most widely used open-source phone systems, and Kickcall connects to it natively using SIP trunking — a direct, reliable signaling link that lets calls flow between your Asterisk system and your agent.

Because this is a native integration, Kickcall handles most of the underlying setup for you. Unlike a typical SIP trunk, you won't need to provide a phone number or whitelist any IP addresses for inbound calls — your agent is identified by a unique Agent ID instead, and the required routing is configured automatically in the background.

Setting up the connection has two independent parts, covered in this guide:

Inbound (Origination) — calls arriving at your agent. This takes a single copy-and-paste step on your end.
Outbound (Termination) — calls your agent places out through your Asterisk system. This needs a few details about your Asterisk server.

Getting started

Open Connect Phone. From your agent, go to Configure → Connect Phone.
Choose Connect with Asterisk. Select the Connect with Asterisk card — described as routing calls from Asterisk to your agent using SIP trunking — and select Get Started.

Connect Phone — choosing “Connect with Asterisk”

Inbound configuration (Origination)

This half handles calls arriving at your agent — for example, a customer calling your business number. Turn on the toggle at the top of this section to enable it.

Locate your Origination URI. When you open the Asterisk configuration screen, Kickcall has already generated an Agent ID and, from it, an Origination URI for your agent. Both fields are pre-filled — you don't need to enter anything.
Copy the Origination URI. Select the copy icon next to the Origination URI field to copy it.
Paste it into your Asterisk dialplan or trunk. In your Asterisk system, use this URI as the destination for calls you want routed to your agent, then select Save Configuration.

Inbound Configuration — Agent ID and Origination URI are generated for you

No phone number or IP address needed. Unlike a standard SIP trunk, you won't be asked to enter a phone number or whitelist any IP addresses for inbound calls. Your Agent ID uniquely ties the Origination URI to your agent, and Kickcall applies the matching configuration on its side automatically — there's no additional field to complete.

Outbound configuration (Termination)

This half handles the other direction — calls your agent places out through your Asterisk system, for example to reach a customer. Turn on the toggle at the top of this section to configure it.

Your Agent ID is already filled in here too. What's left is to tell Kickcall where your Asterisk server is, and how to reach it.

Required field

Field	Purpose
Hostname or IP	The address your agent sends outbound calls to — your Asterisk server's hostname or IP address. Enter this without the `sip:` prefix.

Optional fields

These help Kickcall route calls correctly or authenticate with your Asterisk server, if it requires it. Leave any of these blank if they don't apply to your setup.

Field	Purpose
Destination Country	Two-letter country code for where the call terminates — used to help route the call correctly.
Username / Password	Credentials your Asterisk server may require to accept outbound calls from your agent.
Media Encryption	Whether call media is encrypted in transit. Set to match what your Asterisk server expects.
Transport	The SIP transport protocol used to reach your server. Auto lets Kickcall detect this for you.
Outbound Proxy	An intermediate SIP proxy your calls should route through first, if your setup uses one.
Auth Username	A separate authentication identity, if your server requires one distinct from the username above.

Some Asterisk setups only accept traffic from approved IP addresses. If yours does, whitelist the following subnets on your firewall so outbound calls from your agent aren't blocked. This is only needed for outbound calls — there's nothing to whitelist for inbound.

Please refer to the IP Whitelist document for the current list of ranges to add. Outbound calls may fail to connect until all listed ranges are whitelisted on your side.

Save your configuration

Once you've entered your Hostname or IP (and any optional fields your setup needs), select Save Configuration.

Quick reference

Aspect	Inbound	Outbound
Phone number needed?	No — not required	No — Hostname/IP is used instead
IP whitelisting needed?	No — handled automatically	Only if your firewall requires it — whitelist our subnets
What you provide	Nothing — copy the generated Origination URI	Hostname/IP, plus optional credentials and routing settings
Identified by	Your unique Agent ID	Your unique Agent ID

What happens next

Once both halves are configured and saved:

Inbound calls sent to your Origination URI will reach your agent immediately.
Outbound calls placed by your agent will route through the Asterisk server you specified.
You can come back and update your Outbound settings at any time if your Asterisk server's address or credentials change.

Frequently Asked Questions

Do I need to give Kickcall a phone number for this to work?

No. Because this is a native Asterisk integration, your agent is identified by its Agent ID rather than a phone number — you don't need to provide one for inbound calls.

Do I need to whitelist any IP addresses?

No. IP whitelisting for inbound calls is handled automatically in the background as part of this integration — there's nothing to configure on your end.

What do I actually need to do for inbound calls?

Just one thing: copy the Origination URI shown on the Asterisk configuration screen and use it as the destination for calls in your Asterisk dialplan or trunk.

Is outbound calling required?

No, it's optional. If you only want your agent to receive calls, you can leave Outbound Configuration turned off. Turn it on when you're ready for your agent to also place outbound calls.

What's the only required field for outbound calls?

Hostname or IP — the address of your Asterisk server. Everything else in Outbound Configuration, including Destination Country, Username, Password, Media Encryption, Transport, Outbound Proxy, and Auth Username, is optional and only needed if your setup requires it.

What should I enter for Hostname or IP?

Your Asterisk server's hostname or IP address only — do not include the sip: prefix.

What does the Transport field's "Auto" option do?

It lets Kickcall automatically detect the correct SIP transport protocol for your server, so in most cases you won't need to change this setting.

Can I change these settings later?

Yes. You can return to Connect Phone at any time to update your Outbound Configuration if your Asterisk server details change.

Do I need to whitelist any IPs for outbound calls?

Only if your Asterisk setup restricts traffic to approved IP addresses. If it does, add 143.223.88.0/21, 161.115.160.0/19, and 153.57.128.0/18 to your allow-list so outbound calls aren't blocked. If your setup doesn't use IP-based restrictions, there's nothing to do here.

More in Native Carrier:

Was this helpful?

Still need help? Ask the team