Guide to setting up the FreeSWITCH-based multi-tenant PBX, FusionPBX
FusionPBX is a FreeSWITCH-based multi-tenant PBX that provides a robust set of features for business phone systems.
Using SignalWire services with FusionPBX allows you to leverage our high call quality and low rates.
The following are assumed for this tutorial:
- You already have a SignalWire Space set up
- You have purchased a US/Canadian DID
- You have created a SIP endpoint
- You have set the number purchased above to point to this SIP endpoint for handling voice calls, and for it’s CallerID. Take note of the username and password you enter.
FusionPBX GUI setup
From your FusionPBX installation's web GUI go to
Accounts > Gateways. This is where you will use the credentials you previously created.
Next, click the ADD button at the top left.
Enter the following information in the
- Gateway: This is a label. In this example we will define this as signalwire
- Username: Your username as created in the SIP endpoint on SignalWire
- Password: The password you set above
- Proxy: YOURSPACE-SIPDOMAIN.sip.signalwire.com (Replace with your proxy address)
- Register: True
*Note: The Proxy address can be found in the SignalWire dashboard by going to
SIP > SIP Settings tab as shown below.
Click the Advanced button to expand additional settings
- Register Transport: TLS (This can also be TCP but is better to be secure with TLS)
- Ping: 90
- Profile: internal
- Enabled: True Click save at the top right corner.
Your form should look similar to the following.
*Note: In order to use TLS on your FusionPBX installation, SSL certificates like Let's Encrypt need to be configured. How to do this can be found in the FusionPBX member documentation
You should now have a gateway registered(REGED) as shown in the image below.
*Note: You may have to click Start to initiate registration.
Making outbound calls over SignalWire
After the gateway is configured in your FusionPBX installation and registered we can now configure an outbound route.
Dialplan > Outbound Routes and click the ADD button at the top right.
Fill in the form with a few simple settings:
- Gateway: Select signalwire from the drop down list
- Dialplan Expression: Choose North America (This can be typed in manually or you can pick other areas also)
Check your form is similar to the following, and click
Setting up an extension to receive a call over SignalWire
Accounts > Extensions. Here you can create an extension. This is needed to point your registered peer to so you can receive calls.
Create an extension by clicking the
Add button at the top right. In this example we will create extension
900 and click
Save at the top right.
Dialplan > Destinations from your FusionPBX installation. We will now create an inbound route to connect the SignalWire peer and the extension you just created.
Create a destination by clicking the +ADD button at the top right.
Fill in the form with the necessary information
- Destination: Your SignalWire phone number, without the
- Caller ID Name: This is optional (also see the documentation for Caller ID settings on SignalWire)
- Caller ID Number: This is optional
- Actions: 900 (This is where the call will go to). The actions can be an extension, IVR, Time condition, etc.
Click the Save button at the top right, after checking your form looks similar to the following.
Setting up the "SIP to user" FusionPBX feature
This is a very important step. This must be set in order to receive calls to your FusionPBX installation.
In the menu, look for
Advanced > Default Settings and click the
Add button on the top right.
In the form, enter the following information:
- Category: dialplan
- Subcategory: destination
- Type: text
- Enabled: True
- Description: optional
Check the form looks similar to the following, then click
Save. After saving, click the top right
This should give you a base FusionPBX setup that can make and receive calls using SignalWire. Let us know what cool things you build with it.