Summary
This article is intended to assist in configuring a trunk on your Asterisk based PBX system to connect to your VoicePulse FIVE Gateway. If you have not yet created a VoicePulse FIVE Gateway, please read and follow the steps in Getting Started 1: Initial Configuration and Outbound calling.
Note: This article assumes that you are able to connect to your PBX system either via the GUI interface or the command line if there isn't a GUI and are familiar enough with the system to configure the necessary settings (e.g. adding a SIP Trunk, Extension, Inbound, and Outbound routes).
Asterisk PBX (NO GUI)
If you chose to use "IP Authentication" when you created your VoicePulse Endpoint you can skip "Step 1: Registering your PBX with your VoicePulse Gateway" and continue to "Step 2: Configuring your Peer Details".
- Login to your server via an SSH client such as Putty
- cd to the directory where you have your Asterisk config files (generally /etc/asterisk)
Step 1: Registering your PBX with your VoicePulse Gateway
If you have not written down the username and password you entered when you created your VoicePulse FIVE Endpoint as well as the Hostname you entered when your created your VoicePulse FIVE Gateway, log into your account portal and take note of this info before continuing.
The following line will register your PBX with your VoicePulse gateway. In your sip.conf file under [general] add the following;
register => [EndPointUsername]:[EndPointPassword]@[GatewayHostname].proxy.voicepulse.com
(example)
Step 2: Configuring your Peer details
You will now need to add your VoicePulse FIVE Gateway as a peer. In your sip.conf add a peer that resembles the following;
[Five]
type=peer
context=default
host=myhostname.proxy.voicepulse.com
username=myusername
secret=mypassword
qualify=yes
disallow=all
allow=ulaw
dtmfmode=rfc2833
rfc2833compensate=yes
insecure=port,invite
trustrpid=yes
(example)
Note: If you chose "IP Authentication" when you created your VoicePulse FIVE Endpoint your peer details will resemble the example below.
[Five]
type=peer
context=default
host=myhostname.proxy.voicepulse.com
qualify=yes
disallow=all
allow=ulaw
dtmfmode=rfc2833
rfc2833compensate=yes
insecure=port,invite
trustrpid=yes
Step 3. Save and Reload
Save the changes you made to your sip.conf file and either restart Asterisk or do a "sip reload" from the Asterisk CLI.
Your Trunk should now be correctly configured to connect to your VoicePulse Gateway. You can now complete your Inbound and Outbound configuration settings as per your business requirements. You can continue on to Getting Started 3: Configuring your FIVE account to receive Inbound calls to finish your FIVE configuration and add Inbound calling to your account.
FreePBX, Trixbox, PBX-in-a-Flash, Elastix (GUI)
If you chose to use "IP Authentication" when you created your VoicePulse Endpoint you can skip "Step 2: Registering your PBX with your VoicePulse Gateway" and continue to "Step 3: Configuring your Peer Details".
Step 1: General Settings and Dial Rules
- Login to your server via the web interface using a browser
- Click on Trunks > Add SIP Trunk
- Enter a Trunk name
- Outbound CallerID: 0000000000 (10-digits only) The name you set here will NOT be sent when you call regular PSTN lines.
- Maximum Channels: Enter the number of channels you added to your VoicePulse FIVE Trunk.
(Example) Note: Replace "7323395100" in the example below with the 10 digit phone number you want to be sent as your CallerID.
(Example)Note: Replace "732" in the example below with your local area code.
Step 2: Registering your PBX with your VoicePulse Gateway
At the bottom of your Trunk configuration page you will see a "Registration" section similar to the image below. In the Registration text box enter the following;
[EndPointUsername]:[EndPointPassword]@[GatewayHostname].proxy.voicepulse.com
(Example)
Step 3: Configuring your Peer details
You will now need to add your VoicePulse FIVE Gateway as a peer.
In the text box next to "Trunk Name" enter a name for your trunk.
In the peer details section enter the following;
type=peer
context=from-pstn
host=myhostname.proxy.voicepulse.com
username=myusername
secret=mypassword
qualify=yes
disallow=all
allow=ulaw
dtmfmode=rfc2833
rfc2833compensate=yes
insecure=port,invite
trustrpid=yes
(Example)
Note: If you chose "IP Authentication" when you created your VoicePulse FIVE Endpoint your peer details above will not have a username or secret.
type=peer
context=from-pstn
host=myhostname.proxy.voicepulse.com
qualify=yes
disallow=all
allow=ulaw
dtmfmode=rfc2833
rfc2833compensate=yes
insecure=port,invite
trustrpid=yes
(Example)
Once you have made the above changes click "Submit changes" at the bottom of the page, then click "Apply changes" at the top of the page.
Note: Your changes will not take affect until you hit "Apply changes" after clicking "Submit".
Your Trunk should now be correctly configured to connect to your VoicePulse Gateway. You can now complete your Inbound and Outbound configuration settings as your business requires. You can continue on to Getting Started 3: Configuring your FIVE account to receive Inbound calls to finish your FIVE configuration and add Inbound calling to your account..