Prerequisites for Configuring a Vicidial IP Trunk  

VICIdial is an enterprise class, open source, contact center suite in use by many large call centers around the world. It has over fourteen thousand(14,000) registered installations in over 100 countries around the world. The official releases of VICIdial have been downloaded over twenty five thousand(25,000) times in the last year alone.

This article guides you on how to configure this PBX for making and receiving calls over the internet through a next generation carrier like Telnyx!

You'll need to have created an IP based connection on your Telnyx Mission Control Portal account, assigned this connection to a DID and outbound profile in order to make and receive calls


Instructions for Configuring a Vicidial IP Trunk


VICIdial’s latest version is available to download from here.


You can view the installation notes and get support here.

Video Walkthrough for Configuring a Vicidial IP Trunk

Coming soon! This walkthrough will demonstrate setting up an IP based connection with VICIdial. We'll also show you how to assign this connection to a newly purchased DID which will allow you to receive inbound calls. Then we'll walk you through how to assign the connection to an outbound profile such that you can make outbound calls!

Step by Step Guide for Configuring A Vicidial IP Trunk


Purchase a Number:

  1. Visit the NUMBERS page via the navigation menu on the left-hand side.

  2. Select the SEARCH NUMBERS tab.

  3. Select your search type: (NPA-NXX, Region, Toll Free or Advanced).

  4. Input your search criteria and click SEARCH.

  5. Results will display below.

  6. Click "+ ADD TO CART" to select the number(s) you'd like to purchase.

  7. Click on the Shopping Cart to view your selected numbers and check out.

  8. Once purchased, your numbers will be visible on the "My Numbers" tab within the NUMBERS page.

Set Up Your Connection:

  1. Visit the CONNECTIONS page via the navigation menu on the left hand side.

  2. Click the "ADD CONNECTION" button (located towards the top right corner).

  3. Input a name for the connection.

  4. Select "IP Address" for your Authentication Method and input the IP Address of your VICIdial instance.

  5. Click the "CREATE" button to finish creating your connection.

Provision Your Number: (assign to a connection)

  1. Go back to the NUMBERS page via the navigation menu on the left hand side.

  2. Select the MY NUMBERS tab (you may have defaulted to this already).

  3. Click the "Select Connection" drop-down next to your number. You should see the connection you just created - select it.

  4. Your number is now all set on the portal.

Create an Outbound Profile:

  1. Visit the OUTBOUND section via the navigation menu on the left hand side.

  2. Click the "+ ADD OUTBOUND PROFILE" button (located towards the top right corner).

  3. Select the connection you created via the "Select Connection" drop-down.

  4. Choose the "Traffic Type" and "Service Plan" that meets your needs.

  5. Click "ADD".

  6. You are now setup for outbound calling on the portal.

You are now all set on the Mission Control Portal side and are ready to configure your Telnyx trunk within your VICIdial system.



Log into the Vicidial web portal and going to Admin==>Carriers==>Add new carrier.

  • Enter the following information:

Carrier ID: TelnyxCarrier
Name: telnyxRegistration
String : leave blank.
Template ID: NONE
Account Entry: [telnyx]
Protocol: SIP
Global String: Telnyx=SIP/telnyx

Dial Plan:
exten => _9NXXXXXXXXXX,1,AGI(agi://
exten => _9NXXXXXXXXXX,2,Dial(${Telnyx}/${EXTEN:1},60,tTor)
exten => _9NXXXXXXXXXX,3,Hangup

In this case, 9 is the prefix that will be dialed to send calls to Telnyx's trunk.


That's it, you've now completed the configuration of VICIdial and can now make and receive calls by using Telnyx as your SIP provider!

Additional Resources

Review our getting started with guide to make sure your Telnyx Mission Control Portal account is setup correctly!

Checkout VICIdial’s support section for extra support!

Can't find what you're looking for?

Our knowledge base is currently undergoing a makeover which will include more up to date videos to match our ever growing platform!

Can't find what you're looking for? Click the chat bubble at your lower right hand corner and start a chat!

Did this answer your question?