Telnyx with FusionPBX Setup Guide
The Telnyx network offers unparalleled security, reliability and call quality. That’s because we’re a true carrier, and unlike many CPaaS providers, we don’t rely on middlemen to provide core communications functionality and routing.
We built our SIP services so that you can easily integrate Telnyx with any platform to get your business communications set up quickly. Whether you’re looking to integrate with hardware or cloud-based solutions we want to empower you to make and receive calls globally with the network built for reliable, enterprise-grade voice services.
This guide shows you how to connect your Telnyx numbers to FusionPBX. FusionPBX is a highly available single or domain based multi-tenant PBX, carrier grade switch, call center server, fax server, voip server, voicemail server, conference server, voice application server, appliance framework and more. FusionPBX is a Unix-based system that’s suitable for businesses and organizations of all sizes.
Configure this PBX for making and receiving calls over the internet through a next-generation carrier like Telnyx!
What you’ll need to get started:
- A Telnyx account
- Sign up here with your email address, or register with your Google, Facebook or GitHub account - it only takes a few seconds.
- A download of FusionPBX.
How it works
A Telnyx Elastic SIP Trunk is used to connect your IP-based communications infrastructure to the PSTN, so you can make and receive calls globally with our private IP network. We handle all the complexity in routing calls and delivering crystal clear conversations. To connect your Telnyx numbers to your FusionPBX platform we need to establish a SIP interface which is completed in these steps:
- Set up your Telnyx SIP Trunk Connection.
- Authenticate your SIP Trunk with FusionPBX.
- Configure your FusionPBX profile for Inbound and Outbound calling.
Getting Started with Your Telnyx Mission Control Portal
There are four steps needed to set up your Telnyx Mission Control Portal account so that it’s ready to be configured to your PBX phone system, softphone client or softswitch of your choice.
Level 1 Verification:
To complete the below steps, you'll need to be Level 1 verified. Most users will already be Level 1 verified following email confirmation on signup. To check, visit the ‘My Account’ section of your portal account, and navigate to ‘Verifications’. More information on account verification can be found here.
Next, you need to set up a connection to authenticate your client (FusionPBX) with our sip proxy (sip.telnyx.com).
These steps will walk through the setup of a credentials based connection.
- Go to ‘Connections’ from the side navigation.
- Click the "+ Add Connection" button near the top right corner of the page.
- Enter the name you wish to have for your connection.
- Select "Credentials" as the "Connection Type".
- A username and password will automatically be generated but you change the credentials by clicking the "edit" button to the left. Please make sure you use strong credentials.
- Click "Set Credentials".
- Click "Done".
Note: Once your credential-based Connection is created, you can display the username and password by clicking the eye icon under the "Auth Detail" column.
A DID is required in order to receive inbound calls to your client. After you purchase a DID on your account, you'll have to assign the connection you wish to receive inbound calls to. Information on assigning DIDs to a connection and DID features can be found here. More details on our number search feature can be found here.
An outbound profile is required in order to make outbound calls. More information on creating an outbound profile and its features are explained here.
Need additional support to get started?
Setup FusionPBX for Your Telnyx Connection
Setting up SIP Trunk configurations on the FusionPBX platform is pretty simple. To connect a SIP Trunk, we need to specify inbound and outbound signaling for Telnyx, set up authentication, add our numbers and set up some headers.
Before you can configure the SIP trunk itself, you need to install FusionPBX. You can find a FusionPBX installation guide here.
We recommend using Debian as the operating system for running FusionPBX. The Debian version we used for testing FusionPBX was Debian-9.9.
For the purposes of this article, we used a program called VirtualBOX VM to set up a Debian Virtual Machine. Follow these steps to install the virtual machine on your computer. There are other programs you can use to install a virtual machine. Or, if you don't want to use a virtual machine, you can skip these steps and go straight installation of the FusionPBX.
Install VirtualBox VM
- Download the Debian network installer from the Debian website.
- Open VirtualBox and click the “New” icon in the menu bar. Click “Continue” to move past the welcome screen.
- In the “Name and operating system” window, enter or select the following details:
- Name: Enter any name you want.
- Type: Select “Linux”.
- Version: Select “Debian (64 bit)”.
- Click “Continue”.
- In the “Memory size” window, use the default setting for the base memory. Click “Continue”.
- In the “Hard disk” window, select “Create a virtual hard disk now”. Click “Create”.
- Use the default setting, “VirtualBox Disk Image (VDI)” for the file format.
- In the “Storage on physical hard disk” window, select “Dynamically allocated”. Click “Continue”.
- In the “File location and size” window, use the default settings. Click “Create”.
- This will take you to the “Oracle VM VirtualBox Manager” screen.
- Click the “Settings” icon.
- Click on “Storage” from the left hand menu.
- Select the Debian file you downloaded earlier in the “Controller: IDE” field under “Storage Devices”.
- Click on “Network” in the left hand menu. Open the Debian VM install ISO image. The installer will start the Debian Linux installation on the virtual machine.
- Follow the installation wizard prompts to complete the installation.
- Go to the VirtualBox home page and click your Debian virtual machine to turn it on.
- Follow the prompts to set the basic configuration for your virtual machine (language, time zone, etc.).
Once you’ve created and configured your virtual machine, you can install FusionPBX. FusionPBX can be installed in many different operating systems. However, the remainder of this guide will work in Debian. If you’re using a different operating system, the installation steps may be slightly different.
If you installed Debian from scratch, you will have created a root password. This is the password you will enter to run the command “su root” in the terminal.
Follow the FusionPBX install script to install FusionPBX.
You can watch a video demonstration of the FusionPBX installation here.
Write down your username and password that you create during the installation. You’ll need these to login to FusionPBX and configure your Telnyx SIP trunk.
In order to install FusionPBX and its related packages and dependancies, you will need to run the below commands as root within your terminal.
- Upgrade the packages
apt-get update && apt-get upgrade -y
- Install packages
apt-get install -y git lsb-release
- Get the install script
cd /usr/src && git clone https://github.com/fusionpbx/fusionpbx-install.sh.git
- Change the working directory
- At the end of the install script you will be instructed to go to the IP address of the server in your web browser to finish the install in the FusionPBX GUI.
- Once you have opened a browser with the URL the terminal gave you, you should see a GUI where you will go on to configure FusionPBX.
- On the language selection screen, choose your language and click next.
- Your event socket settings will be automatically detected so you can click next again.
- For Admin Configuration, you will need to enter a username and password as your login credentials for FusionPBX.
- On the database configuration page, any writing in bold indicates that you must fill it in. At this point you will need to go back to the terminal and grab the details you would have seen, just above the server IP, that relate to the database username and password.
- Click next.
Configure Your Telnyx SIP Trunk
Once you’ve installed FusionPBX, you can configure your PBX to make and receive calls through Telnyx.
- Login to FusionPBX with your FusionPBX username and password.
- Click on the “Advanced” icon on the right side of the top menu bar.
- Select “Upgrade” from the dropdown list.
- Tick the “App Defaults” box. Click “Execute” in the lower right corner.
- Click the “Accounts” icon in the top menu bar.
- Select “Gateway”. Enter the following details:
- Gateway: Telnyx
- Username: Enter the username from your Telnyx credentials based connection.
- Password: Enter the password from your Telnyx credentials based connection.
- From User: Enter the username from your Telnyx credentials based connection.
- From Domain: sip.telnyx.com
- Proxy: sip.telnyx.com
- Realm: blank
- Click “Save”. You’ll see a window that verifies your FusionPBX server has registered with the Telnyx domain.
- Click the “Accounts” icon in the top menu again, then select "Extensions".
- Click “Add”.
- Create any extensions that you need. Once an extension is created, you can click on that extension and change the voicemail password for the extension. The account code for the extension is your server’s IP address. It should be automatically filled.
- Click the “Dialplan” icon in the top menu bar. Select “Destinations”.
- Click “Add”.
- Add the number you purchased in the Telnyx Mission Control Portal to the “Destination” field. Add “+1” to the beginning of the phone number.
- Enter “public” in the “Context” field.
- In the “Actions” section, select the extension you want from the extensions you created earlier.
- Click “Save”.
- Click the “Dialplan” icon in the top menu bar again. Select “Inbound Routes”.
- The inbound routes should be added automatically, based on the destinations you created.
- Click on the phone numbers you created as inbound routes. Ensure that the number format is set to “E164” on the connection you created in the Telnyx Mission Control Portal.
- Click on the “Dialplan” icon in the top menu bar one more time. Select “Outbound Routes”.
- Click “Add”.
- Enter or select the following details for the outbound route:
- Select “Telnyx” from the “Gateway” dropdown list.
- Select “North America” from the “Dialplan Expression” dropdown list. You may choose other regions, if you need.
- Click “Save”.
- Click the “Status” icon in the top menu bar. Select “Registrations”.
- Use the interface to register your devices with the extensions you created. All your registered devices should show up on the “Registrations” page. Once your devices are registered, you can make and receive calls from those devices.
That's it! You've completed FusionPBX configuration and all your calls will be routed through your Telnyx SIP trunk.
A little disclaimer: This guide has been developed by our product team to help you get started on the Telnyx platform. It isn’t necessarily supported or verified by the other platform and may vary based on platform version but we are confident in its accuracy.