3CX is an open standards IP PBX that offers complete Unified Communications, out of the box. Suitable for any business size or industry 3CX can accommodate to your every need; from mobility and status to advanced contact center features and more, at a fraction of the cost.
3CX makes installation, management and maintenance of your PBX so easy that you can effortlessly manage it yourself, whether on an appliance or server at your premise or in the cloud. 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!
NOTE: you'll need to acquire a license when installing this version of 3CX. You'll be prompted to fill out a form and include your email address so they can verify your email and send you the license key. |
Instructions for Configuring a 3CX V18 PBX Credentials Trunk
In this guide you will:
Pre-requisites
Have created a 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.
Have created a messaging profile with API V2 version selected on your Telnyx Mission Control Portal account, assigned this messaging profile to a DID in order to send and receive messages.
Have created a V2 API Key on your Telnyx Mission Control Portal account which will be used within the 3CX portal.
Note that during installation, 3CX will provide you with a username and password. You will need these to log into the web interface.
Note:
3CX will detect your pubic IP address and you can specify if this is a static or dynamic IP.
You can configure your 3CX with an FQDN; 3CX will provide you with one - they do this to ensure your FQDN is set to resolve to your Public IP and for generating certificates.
You'll then choose your default network adapter and decide whether you want the extensions to use the local IP of your PBX or the FQDn you created.
At the end, you'll choose your preferred http/https port numbers which will be used to allow you to access the 3CX web interface via your FQDN or Public IP. |
1. Perform the basic setup
In this step, you'll do a basic configuration before creating your Telnyx SIP trunk.
1.1 Login
Log into 3CX with the username and password provided to you during the installation process.
1.2 Extensions
On the Extension Length tab, specify your extension length by choosing how many digits your extension should have (default is 3). Note that this CANNOT be changed later.
Click Next.
1.3 Admin Email
On the Admin Email tab and enter an email you want to use to receive system notifications and other important information.
Click Next.
1.4 Timezone
On the Timezone tab, set your timezone.
Click Next.
1.5 Operator
On the Operator tab, you can specify a default operator extension. This will be the default destination for all inbound calls, as well as a voicemail extension and messages.
Click Next.
1.6 Allowed Countries
On the Allowed Countries tab, you can select all regions permitted for outgoing call.
Click Next.
1.7 Prompt Set
On the Prompt set tab, you can select the language spoken by your automated prompts.
Click Next.
1.8 Registration
On the Registration tab, enter your personal detail to register your setup.
2. Configure your PBX
In this step, you'll configure everything needed to start making and receiving calls with 3CX through Telnyx, including network settings, SIP trunks, inbound/outbound routes etc.
2.1. Confirm your network settings
Click on the Ports tab and ensure your SIP port is set to 5060.
Click on the Public IP tab and ensure that your Public IP is correct and that you have selected the proper Network card Interface.
Click on the Settings tab and click on Network Settings and then on the Public IP tab. Find the External IP Configuration section and ensure that the connection IP on the portal matches the Static Public IP.
2.2. Create a Telnyx SIP Trunk
SIP Trunk Settings
Click on SIP Trunks in the left-hand navigation menu.
Click + Add SIP Trunk near the top of the screen.
A new pop up will open. Enter/select the following:
Select Country: Worldwide
NOTE: 3CX are removing third party providers from the country dropdown which means you will need to follow this article for generic setup.
Select Provider in your Country: Telnyx LLC
Main Trunk No: <Enter the number which you have purchased on your Telnyx Mission Control Portal>
Click OK. This will open the trunk configuration window.
Trunk Details
Click on the the General tab and find Trunk Details
Enter name of Trunk: Telnyx LLC
Registrar/Server/Gateway Hostname or IP: sip-anycast1.telnyx.com:5060 or sip.telnyx.com:5060
Outbound Proxy: sip.telnyx.com
Number of SIM Calls: <set your preferred amount of simultaneous calls>
Trunk Authentication
Find the Authentication section:
Type of Authentication: Register/Account based
Authentication ID (aka SIP user ID): <You need to use the username from the connection which you have created in the Telnyx portal>
Authentication Password: <You need to use password from the connection which you have created in the Telnyx portal>
Trunk Routes
Continue below to the Route to section.
Main Trunk number :<By default number will be shown. You need cross verify with the number which you have purchased on telnyx portal>
Specify the extension number the calls should go to.
Destination for calls during the office hours : <Based on your requirement>
Destination for calls outside the office hours : <Based on your requirement>
Trunk DIDs
Click on the DID's tab.
Add the DID's using the plus sign that will be associated with this Trunk.
Trunk Caller ID
Click on the Caller ID tab.
Enable inbound caller ID to e164 format and select United States as the country if this is your preference.
Trunk Options
Click on the Options tab.
By default, incoming and outgoing calls will be allowed on this trunk.
By default, pbx delivers audio is enabled under advanced.
By default, SRTP mode is disabled under advanced.
By default, re-register timeout is set to 120 under advanced.
Consider your preferred transport, IP mode and codec list of priorities.
There are generally no changes required to the Inbound Parameters tab.
Select the "Outbound Parameters"
SIP Field
Contact: User Part: Select Custom Field from the Variable dropdown. Leave the custom value blank.
From: Display Name" and From: User part select OriginatorCallerID from the Variable dropdown.
Click Apply.
2.3. Enable messaging on SIP Trunk
Click on the SMS tab.
Enable the SMS checkbox.
Enter your Telnyx V2 API Key that you created here.
Copy the webhook url 3CX provides you and place it into the messaging profile webhook url field you created.
Click OK to make the IP trunk live for both calls and messaging.
2.4. Configure inbound voice rules
Click on "Inbound Rules" from the navigation menu on the left.
Click on "+Add DID Rule" near the top of the screen.
Find the General section and ensure the following:
Name: IB_Telnyx (or any name that can identify your inbound rule)
Find the Route calls to section and ensure that:
Destination for calls during office hours: Extension and ensure that your desired extension is selected (is usually 000).
2.5. Configure outbound voice rule
Click on Outbound Rules from the navigation menu on the left.
Click on +Add near the top of the screen.
Find the General section and ensure the following:
Name: OB_Telnyx (or any name that can identify your outbound rule)
Find the Apply this rule to these calls section and fill in the following:
Calls to numbers starting with prefix : <leave empty>
Calls from extension(s) : <You need to give the extension numbers>
NOTE: ‘000’ is the extension I have used as an example.
Calls to Numbers with a length of : <leave empty>
Find the Make outbound calls on section. This is where you will configure your routes. You can configure up to 3 routes for calls. The second and third route will be used as backup. For each route, digits can be stripped or added. Strip Digits 0 on Route 1 and Strip Digits 1 digit for remaining 2 routes.
This is also one of the many ways an outbound caller ID can be applied within 3CX. If you choose to apply an outbound caller ID on your Outbound Route, it will be applied to all calls that proceed through this route.
Note: If you choose not to add an outbound caller ID on your outbound route, you can instead apply it for each user or extension.
If a caller ID is not set through 3CX, it is likely that the calls will reach us without a caller ID. If this is the case, you may choose to apply a Caller ID Override from your SIP Connection’s outbound options in the Telnyx Portal. Otherwise, your calls will be rejected. Please review our caller ID number policy for accepted formats. |
Depending on your use case, you may have specific dialling format rules and 3CX provides a great overview here.
After completing this configuration, click "OK".
An important example of an outbound rule
The outbound rule feature in 3cx is a powerful tool for configuring your 3CX phone system that extra mile allowing you to create much more complex rules – allowing you to not only select backup routes which come into effect when other routes fail, but also to select a different set of routes, depending on the type of number being dialed. Below you will find an example outbound rule for handling 911 Emergency Calls:
For additional outbound rule examples which you may find useful please see the following support article from 3CX.
2.6. Configure extension for inbound and outbound messaging.
An existing extension/user will have been created during the initial setup.
Visit the "users" section where you can add more extensions or edit existing extensions.
In our example below, we're going to click into extension 101 so we can enable messaging on the extension which is associated with one of the numbers we configured in our inbound routes.
You will be brought to the "General" tab.
Visit the end of the page and make sure to assign the DID to the extension. Previously in Update 5 you would have to enable SMS on the associated DID but this is no longer a requirement.
Click OK at the top of the page which will make inbound and messaging live for the extension.
2.7. Access 3CX Native WebClient to send and receive messages.
During the extension creation process at the initial setup, you would have received an email from 3CX "Your User Account on your New 3CX System" with a link to their webclient along with the extensions username and password.
Visit the link and login.
This is an app you can use on the web for making and receiving calls/sms for each given extension that is created.
Once logged in visit the contacts section.
Click “+” icon to add a contact.
Enter in the name and mobile number of the contact.
Click the “save” icon on the top right.
Once the contacts are saved, you can now use them in the chat section.
Visit the chat section
Click “+” symbol
and then “Send SMS”
choose the contact you want to send an SMS to.
type your message and hit enter to send.
The message will send to the destination.
Once the destination responds, you’ll see it in the chat.
That's it, you've now completed the configuration of 3CX V18 v5 PBX Credential Trunk and can now make and receive calls & messages 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:
3CX's help section for extra support!
Latest information on Update 6.