The default behavior of FreePBX, starting at version 12, is to use chan_pjsip for endpoints and trunks. Sections of this article will cover installations of FreePBX configured with either chan_pjsip or chan_sip. Selection of either chan_pjsip or can_sip from within your distribution can be found in the Admin Web tool under Settings -> Advanced Settings -> Dialplan and Operational -> SIP Channel Driver. The Admin Web tool may be viewed by visiting: http://[ip of your freepbx]/admin
To configure FreePBX to work with Digium's SIP Trunking service, you should make configuration changes in 3 areas:
Connectivity -> Trunks
Connectivity -> Inbound Routes
Connectivity -> Outbound Routes
Each of these is configured using the Admin Web tool provided by FreePBX.
For more information about the configuration of FreePBX, please see the FreePBX wiki.
First, you need to create a FreePBX Trunk for your Digium SIP Trunking account.
On the Connectivity -> Trunks page, select Add SIP (chan_pjsip) Trunk
To configure a Digium SIP Trunking account, make modifications to the following options:
General Settings
Trunk Name: digium-siptrunk
Outbound CallerID: your_digium_number, e.g. 2565551234
CID Options: Force Trunk CID
Dialed Number Manipulation Rules (This entire section can be left at defaults)
PJSIP Settings
Configuration Mode: Advanced
Username: your_digium_username
Secret: your_digium_password
SIP Server: sip.digiumcloud.net
SIP Server Port: 5060
Client URI: sip:your_digium_username@sip.digiumcloud.net
Server URI: sip:sip.digiumcloud.net
AOR Contact: sip:sip.digiumcloud.net:5060
Contact User: your_digium_username
Codecs: Select g722, ulaw, g729
Note 1: G729 should typically only be allowed if you've installed Digium's G.729 Add-on for Asterisk. G.729 is a licensed algorithm that cannot be distributed or used freely without this add-on.G.729 should be used on
Note 2: Session timers is not supported by our servers, you will need to disable this feature by setting timer=no your PJSIP channel driver configuration.
Once the Trunk has been configured with these settings, click the Submit Changes button at the bottom of the screen and then, when it displays at the top of the screen, the red Apply Changes button.
If you are not using chan_pjsip, you may instead create a FreePBX Trunk using chan_sip.
On the Connectivity -> Trunks page, select Add SIP (chan_sip) Trunk
To configure a Digium SIP Trunking account, make modifications to the following options:
General Settings
Trunk Name: digium-siptrunk
Outbound CallerID: your_digium_number, e.g. 2565551234
CID Options: Force Trunk CID
Dialed Number Manipulation Rules (This entire section can be left at defaults)
Outgoing Settings
Trunk Name: digium-siptrunk
PEER Details:
type=peer
directmedia=no
host=sip.digiumcloud.net
defaultuser=your_digium_username
fromuser=your_digium_username
secret=your_digium_password
insecure=invite
trustrpid=yes
sendrpid=pai
disallow=all
allow=g722
allow=ulaw
allow=g729
session-timers=refuse
G729 should typically only be allowed if you've installed Digium's G.729 Add-on for Asterisk. G.729 is a licensed algorithm that cannot be distributed or used freely without this add-on.G.729 should be used on
Incoming Settings (USER Details: blank out this section)
Registration
Register String: your_digum_username:your_digium_password@sip.digiumcloud.net:5060/your_digium_username
Once the Trunk has been configured with these settings, click the Submit Changes button at the bottom of the screen and then, when it displays at the top of the screen, the red Apply Changes button.
Once a Trunk has been created, you should next create an Inbound Route in order to handle calls coming from Digium's SIP Trunking service to your FreePBX system.
To make these configuration changes, visit the Connectivity -> Inbound Routes page.
To configure a Digium SIP Trunking account, make modifications to the following options:
Add Incoming Route
Description: calls-from-your_digium_number
DID Number: your_digium_number, e.g. 2565551234
Options (This entire section can be left at defaults)
Privacy (This entire section can be left at defaults)
Call Recording (This entire section can be left at defaults)
CID Lookup Source (This entire section can be left at defaults)
Fax Detect (This entire section can be left at defaults)
Language (This entire section can be left at defaults)
Superfecta CID Lookup (This entire section can be left at defaults)
Set Destination: Choose an IVR or Extension or any other destination to which you want to send Inbound Calls on this Digium SIP Trunk
Once the Inbound Route has been configured with these settings, click the Submit Changes button at the bottom of the screen and then, when it displays at the top of the screen, the red Apply Changes button.
Once an Inbound Route has been created, you should next create an Outbound Route in order to send calls from internal extensions out to Digium's SIP Trunking service.
To make these configuration changes, visit the Connectivity -> Outbound Routes page.
To configure a Digium SIP Trunking account, make modifications to the following options:
Outbound Route (Route Name: digium-outbound)
Additional Settings (This entire section can be left blank)
Dial Patterns that will use this Route
Leave Prepend and Prefix blank and add match patterns for:
International Dialing: 011. (Don't forget the trailing period in this pattern)
10-digit dialing: NXXNXXXXXX
1+ 10-digit dialing: 1NXXNXXXXXX
Trunk Sequence for Matched Routes
0: digium-siptrunk
Optional Destination on Congestion (This entire section can be left blank)
Once the Inbound Route has been configured with these settings, click the Submit Changes button at the bottom of the screen and then, when it displays at the top of the screen, the red Apply Changes button.