Carriers

VICIdial carrier setup: add a SIP trunk in 4 steps

VICIdial carrier setup in the Trustane console: pick the provider, sign in or allow by IP, a dial prefix checked as you type, and the exact entry VICIdial gets.

By Published Updated 7 min read
Glowing cable icon on a dark blue grid

To the point

VICIdial carrier setup in admin.php means writing the account entry and the dialplan entry yourself. In the Trustane console, Carriers, then Add carrier, takes 4 steps and writes both for you:

  1. Provider: Twilio, Telnyx, RingCentral or any other SIP provider.
  2. Connect: the SIP server with a username and password, or by IP. On a PJSIP server, a Telnyx API key or a Twilio Account SID and Auth Token is enough: Trustane sets it up on your account.
  3. Calls: the dial prefix, checked on the server as you type, and what the carrier receives.
  4. Review: each step, and the exact carrier entry and dial plan VICIdial gets.

Plays from YouTube when you press Play. Google's privacy policy applies.

Our video on YouTube

The pictures come from our demo account. The SIP server 198.51.100.25 is in an address range kept for documentation, and the username is made up.

Open Carriers

  1. Open your server, then Carriers. Each carrier has a row: its state now, whether it makes or takes calls, and the campaigns that dial through it.
  2. Click Add carrier.
The Carriers list with one carrier, Demo Telco, reachable, and the Add carrier button marked
Carriers: one row per carrier, and Add carrier

1. Pick the provider

The Provider step: Twilio, Telnyx, RingCentral and Other SIP provider
Four choices: Twilio, Telnyx, RingCentral or any other SIP provider

You are not asked whether the carrier is PJSIP or chan_sip. The console uses the server's own: PJSIP where the server takes it, chan_sip where it takes only that.

Twilio or Telnyx with an API key

On a PJSIP server, Twilio and Telnyx offer With your API key. Give Telnyx its API key, or Twilio its Account SID and Auth Token, and press Fetch:

  • Telnyx: a new connection for this server that signs in, or this server added to an IP connection you already have, in the region you pick.
  • Twilio: a new trunk for this server, or one you already have, with this server's credentials and IP.
  • Numbers: the account's numbers are listed with their country and where their calls go now. The ones you tick move onto the carrier and arrive on Numbers, not routed yet.
Telnyx picked: With your API key, and the Telnyx API key field
With your API key: Trustane sets it up and fetches the numbers

Enter the settings is there if you would rather set it up in Twilio or Telnyx yourself.

RingCentral

Paste the phone's SIP details from RingCentral's admin portal (Phones & Devices, the phone, Set up manually using SIP). The username, password, authorization ID, domain and outbound proxy are filled from them.

2. Connect

For any other provider:

  1. Name: your name for the carrier. VICIdial's carrier ID is made from it.
  2. Username and password when the provider gave you a SIP login: the carrier signs in with it. Pick IP address instead when the provider allows calls by your server's IP.
  3. SIP server: a host name or IP, with :port if it is not 5060.
  4. Username and Password.
The Connect step filled in: Main carrier, Username and password, SIP server 198.51.100.25, username atlas01 and a hidden password
Connect: the name, how it signs in, the SIP server and the login

With IP address, the console shows your server's IP with a copy button, to give the provider. In the picture it is blurred.

IP address picked: Give the provider this server's IP, with the address and a copy button
IP address: the provider trusts this server's IP

More settings holds what some providers ask for: the carrier ID, the transport, whether it signs in, an auth username, the addresses calls come in from, an outbound proxy, the From user and From domain, and the codecs. ulaw and alaw are ticked to start; g729, g722 and opus are there to add.

More settings: Carrier ID MAIN_CARRIER, Transport UDP, From user, and the codecs ulaw and alaw ticked
More settings, for providers that ask for them

3. Calls: the dial prefix

Pick Both, Outbound or Inbound. For outbound, the carrier needs a dial prefix. In VICIdial, a campaign reaches a carrier by its Dial Prefix: the campaign puts the prefix before the number, and the carrier's dial plan takes the numbers that start with it and drops the prefix.

  1. Dial prefix: 1 to 4 digits, not starting with 0 or 8, which start VICIdial's own extensions, or 1, which is how a campaign with no prefix dials. The console suggests a free one, and checks what you type on the server: against every carrier's dial plan, and against what Asterisk already reaches with it. Here 9 is taken by the carrier DEMOTELCO, so it offers 7.

    Dial prefix 9: Taken by DEMOTELCO, with a link to use 7
    9 is taken on this server, so it offers 7
  2. Tech prefix: digits the carrier wants before each number, if it wants any.
  3. Number sent as: as dialled, 15551234567, or with a plus, +15551234567.
  4. Campaigns to move to it, once it works: tick the campaigns that should dial through the new carrier.

The line above the campaigns shows the result: the campaign dials 715551234567, and MAIN_CARRIER gets 15551234567. Inbound calls go to your Numbers, where you add each number.

Dial prefix 7, Free on this server; Campaign dials 715551234567, MAIN_CARRIER gets 15551234567; BLENDED ticked
7 is free; what the carrier receives; the campaign to move

4. Review, then Add carrier

Review lists what happens, in order: the PJSIP carrier MAIN_CARRIER, signing in as atlas01; Asterisk loading it; outbound, 7 and the number to 198.51.100.25; inbound calls to your Numbers; and BLENDED moving to 7 once it works.

What VICIdial gets opens the exact text the console writes into VICIdial: the carrier's account entry and its three dial plan lines. The password shows as ********.

Review: the five steps, and What VICIdial gets open with the PJSIP wizard lines, the password masked, and the dial plan for 7
Review: what happens, and the exact entry and dial plan

Add carrier writes the carrier to VICIdial, and Asterisk loads it in about a minute. The sheet stays open and shows its state as Asterisk reports it: Signed in, Reachable, Sign-in refused or Not reachable. Once Asterisk has loaded it, Move BLENDED to it sets the campaign's dial prefix. Wait until it is signed in or reachable first, or calls on that campaign fail.

Carriers made in admin.php

A carrier made in admin.php shows in the same list. Right-click it and pick Take over… to open it in the same steps. Saving rewrites it the way the console writes carriers, and Review lists every line it has now that is not kept. Setting up a PJSIP carrier in VICIdial on Asterisk 22 shows admin.php's carrier fields and what VICIdial does with each.

Questions people ask

PJSIP or chan_sip?

The server's own. The console offers PJSIP where VICIdial and Asterisk on the server take it, and chan_sip where they take only that. Asterisk 21 removed chan_sip, so moving a carrier from chan_sip to PJSIP explains what changes.

Can I change a carrier later?

Yes. Right-click it and pick Change. Its ID stays. If the change takes away a prefix that campaigns dial with, Review names those campaigns and offers to move them.

Why does the dial prefix not start with 0, 1 or 8?

Numbers starting with 0 or 8 are VICIdial's own extensions, and 1 is the country code a campaign with no prefix dials, so the console refuses all three and suggests 9, then 7, 6, 5 and on.

Next steps

VICIdial is a trademark of its owner. Trustane is an independent hosting provider. Twilio, Telnyx and RingCentral are trademarks of their owners. Trustane is not affiliated with them.

Sources

  1. Trustane console, the Add a carrier wizard
  2. Trustane console, the carriers list and its row menu
  3. Trustane console, what is written for a carrier and the form's limits
  4. Trustane console, the dial prefix check and the write to VICIdial
  5. Trustane console, setting up Twilio and Telnyx by API
  6. VICIdial agent screen, the Manual and 3-Way Dial Prefix fallback

Trustane

Managed VICIdial hosting

Run it on cores of your own

Managed VICIdial, billed by the hour against a balance you top up.

Or try one server free for 7 days, no top-up.