How to connect a FreePBX PBX to 2talk

Follow this quick start guide to connect a FreePBX PBX to 2talk.

2talk Portal Instructions

Choose between a Peering Trunk or a Registered Trunk. Once selected follow the instructions for the chosen method.

Configuring a peering SIP trunk

Configure an account peering trunk, or set peering IPs in the number manager, in the 2talk portal.

Configuring a registered SIP trunk

Pilot: Under "Outbound Calls" -> "Outbound Trunking" tick the "Enable Outbound Trunking" box.

DDIs: Under "Inbound Calls" -> "Forwarding and Trunking" set "Send inbound calls to registered number" to the pilot and tick the "Preserve DDI" box.

FreePBX Web UI instructions

Settings not listed here should be left as the defaults.

 

Configuring a trunk - peering SIP trunk:

Select "Connectivity" > "Trunks" > "Add Trunk" > "Add SIP (chan_pjsip) Trunk".
Configure the following parameters:
"Trunk Name" input the pilot number or a descriptive name of your choice.
"Outbound CallerID" input the pilot number in NSN+0 format and enclosed in angle brackets, e.g. "<0xxxxxxxx>".

Select "pjsip Settings" > "General".
Configure the following parameters:
"Authentication" select "None".
"Registration" select "None".
"SIP Server" input the SIP proxy, either your whitelabelled SIP proxy registrar domain or "sip.2talk.co.nz".
"SIP Server Port" input "5060".

Select "pjsip Settings" > "Advanced".
Configure the following parameters:
"From User" input the pilot number in NSN+0 format, e.g. "0xxxxxxxx".
"Contact User" input the pilot number in NSN+0 format, e.g. "0xxxxxxxx".
"Send RPID/PAI" select "Send P-Asserted-Identity header".

Submit and apply changes.

 

Configuring a trunk - registered SIP trunk:

Select "Connectivity" > "Trunks" > "Add Trunk" > "Add SIP (chan_pjsip) Trunk".
Configure the following parameters:
"Trunk Name" input the pilot number or a descriptive name of your choice.
"Outbound CallerID" input the pilot number in NSN+0 format and enclosed in angle brackets, e.g. "<0xxxxxxxx>".

Select "pjsip Settings" > "General".
Configure the following parameters:
"Username" input the pilot number in NSN+0 format, e.g. "0xxxxxxxx".
"Auth username" input the pilot number in NSN+0 format, e.g. "0xxxxxxxx".
"Secret" input the password you assigned the pilot in the 2talk portal.
"Authentication" select "Outbound".
"Registration" select "Send".
"SIP Server" input the SIP proxy, either your whitelabelled SIP proxy registrar domain or "sip.2talk.co.nz".
"SIP Server Port" input "5060".

Select "pjsip Settings" > "Advanced".
Configure the following parameters:
"From User" input the pilot number in NSN+0 format, e.g. "0xxxxxxxx".
"Contact User" input the pilot number in NSN+0 format, e.g. "0xxxxxxxx".
"Send RPID/PAI" select "Send P-Asserted-Identity header".

Submit and apply changes.

 

Configuring extensions (DDIs):
Select "Applications" > "Extensions" > "Add Extension" > "Add New SIP [chan_pjsip] Extension".
Configure the following parameters:
"User Extension" input an extension number to your preference.
"Display Name" input a descriptive name for the extension.
"Outbound CLI" input the DDI number in NSN+0 format and enclosed in angle brackets, e.g. "<0xxxxxxxx>".
"Secret" input a secure password of your choosing in order for the extension to register to your PBX.

Select "Find Me/Follow Me".
Ensure "Change External CID Configuration" > "Mode" is set to "Default".

Submit and apply changes

 

Configuring call routing:
Inbound and outbound routing configuration will differ between deployments, particularly if multiple trunks are configured on the PBX. 
The following configuration has been provided as a starting point to route all inbound calls to an extension and all outbound calls via the trunk. 
For more complex requirements this configuration can be modified or replaced, see the FreePBX wiki and community group pages for more information on call routing configuration.

Configuring call routing - inbound route:

Select "Connectivity" > "Inbound Routes" > "Add Inbound Route".
Configure the following parameters:
"Description" input a description to your preference, e.g. "All In".
"Set Destination" select "Extensions", then select the extension configured above.

Configuring call routing - outbound route:

Select "Connectivity" > "Outbound Routes" > "Add Outbound Route".
Configure the following parameters:
"Route Name" input a description to your preference, e.g. "All Out".
"Trunk Sequence for Matched Routes" select the trunk configured above.
Select "Dial Patterns".
Configure the following parameters:
Click the "+" symbol to the right of "CallerID".
In the first row "Match Pattern" input "[*#]X.".
In the second row "Match Pattern" input "X.".

Submit and apply changes