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!
Additional documentation:
Vicidial user manual (free version. Additionally, there is a paid version with higher resolution)
Instructions for configuring a Vicidial IP trunk
In this document you will
Pre-requisites
You'll need to have created an credentials-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
Make sure your Telnyx Mission Control Portal is set up properly
Video Walkthrough
Coming soon! Check back frequently as we update our documentation.
1. Configure your Telnyx Mission Control Portal to work with Vicidial
First, you'll need to purchase a number:
Visit the Numbers page via the navigation menu on the left-hand side.
Select the Search Numbers tab.
Select your search type: (NPA-NXX, Region, Toll Free or Advanced).
Input your search criteria and click Search.
Results will display below.
Click + Add to Cart to select the number(s) you'd like to purchase.
Click on the Shopping Cart to view your selected numbers and check out.
Once purchased, your numbers will be visible on the My Numbers tab within the Numbers page.
Next, you'll set up a connection:
Visit the Connections page via the navigation menu on the left hand side.
Click the Add Connection button (located towards the top right corner).
Input a name for the connection.
Select Credentials for your Authentication Method and input the desired user/password combination.
Click the Create button to finish creating your connection.
Now, you'll provision your number (assign to a connection):
Go back to the Numbers page via the navigation menu on the left hand side.
Select the My Numbers tab (you may have defaulted to this already).
Click the Select Connection drop-down next to your number. You should see the connection you just created - select it.
Your number is now all set on the portal.
And finally, you'll create your outbound profile:
Visit the Outbound section via the navigation menu on the left hand side.
Click the + Add Outbound Profile button (located towards the top right corner).
Select the connection you created via the Select Connection drop-down.
Choose the Traffic Type and Service Plan that meets your needs.
Click Add.
You are now setup for outbound calling on the portal.
2. Configure Vicidial
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]
Disallow: All
Allow: ulaw
Allow: g729
Type: friend
Host: sip.telnyx.com
Username: The username you set up in step 1
Password: The password you set up in step 1
dtmf mode: rfc2833
Context: default
Protocol: SIP
Global String: Telnyx=SIP/telnyx
Dial Plan:
โexten => _91NXXNXXXXXX,1,AGI(agi://127.0.0.1:4577/call_log)
exten => _91NXXNXXXXXX,2,Dial(${Telnyx}/${EXTEN:1},60,tTor)
exten => _91NXXNXXXXXX,3,Hangup
โ
In this case, 9 is the prefix that will be dialed to send calls to Telnyx's trunk.
Depending on your phone configuration, you may also wish to configure an outbound caller ID to be in accordance with our caller ID number policy. You can do this on a per-user or per-campaign basis.
To apply a per-user caller ID:
Open the Users tab in the Vicidial administration portal.
Select Modify next to the relevant user.
Select Apply the desired outbound caller ID in the Outbound CallerID field.
Click Submit.
To apply a caller ID on a campaign:
Select the Campaigns tab in the Vicidial administration portal.
Select Modify next to the campaign you want to have the caller ID.
Click the Detail tab and apply the desired caller ID in the Campaign CallerID field.
Click Submit.
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!
Additionally you can check out:
Vicidial user manual (free version. Additionally, there is a paid version with higher resolution)