Why Build Out A New Trunk?

In order to enable SMS for SIPTrunk.com trunks, they must be built out as a generic SIP Trunk rather than the standard pre-defined build. The instructions below will aid in building a generic trunk for SIPTrunk.com users, but also will have tips for those who have an existing SIPTrunk so that they can swap over to the SMS enabled trunk with minimal issues. 

Building out the New SIP Trunk

1. Login to the bvoip phone system.
2. Click on the Call Flow drop-down menu.
   
3. Go to the SIP Trunks menu item. 
4. Click on the Add SIP trunk+ button. The page will refresh with setup details.
   
5. In the Country drop-down, select Generic.
   
6. In the Provider drop-down, select Generic Sip Trunk.
7. In the Main Trunk Number field, provide the trunk number as found in the SIP Trunk provider's portal.
8. Click on the +Create button. The page will refresh to reflect more setup options on the General tab.
9. Scroll down to the Trunk Details section.
   
10. In the Trunk Name field, input SIPTrunk with SMS for the name.
11. In the Registrar/Server/Gateway field, input gw.siptrunk.com with the Auto Discovery box checked.
12. In the Outbound proxy field, input gw1.siptrunk.com.
13. Scroll down to Authentication section. 
     
14. In the Authentication ID field, copy and paste Trunk Number from SIP Provider. For those with an existing SIPTrunk, add a capital C at the end of the trunk number in this field. 
15. In the Authorize Password field, paste the password from SIP Provider.
16. Go to the Options tab.
    
17. Scroll down to the Advanced section.
18. Enable the Alternative Proxy option. When enabled, a textbox will appear. Input gw2.siptrunk.com in the field. This will enable failover to the redundant gateway.
19. Go to the Inbound Parameters tab.
    
20. Change the CallerNum caller's number (default: From->user) parameter to Contact: User Part. 
21. Change the CallerName caller's name (default: From->display name) parameter to From: Display Name
22. Change the CalledNum number that has been dialed (default: To->user) parameter to Request-Line URI: User Part.
23. Click the Save button.

Activating the SMS Functionality

1. Log into the SIPTrunk.com portal.
    
2. Click on the My SIP Trunking section.
   
3. Go to the Messaging tab. 
4. Click on the Webhooks button. A pop-up window will appear.  
5. Click on the Create new Webhook button.
    
6. In the URL field, enter the copied Webhook URL received from the bvoip support team. Note: Please submit a ticket with bvoip support to obtain this URL. 
    
7. In the Description field, enter a description.
8. Click the Create button. The Webhook is now created and you can close the window
9. Under the Assign WebHook column, use the drop-down to assign a DID to the Webhook.
10. Click on the API Keys button. A pop-up window will appear.
11. Click on the Create new API Key button.
    
12. In the Description field, enter a description.
    
13. Click the Create button.  Make sure to save the Secret Key for any future use.
14. In the confirmation pop-up, copy the 3CX API Token. 
15.  Reach out to bvoip support, providing the API Key and Provider URL to be added to your trunk in the back end.

Swapping Out the Trunks

To swap out the trunks, you will need to disable the non-SMS trunk before enabling the SMS enabled trunk. 

Disabling the Non-SMS Trunk

1. Click on the Call Flow drop-down menu.
   
2. Go to the SIP Trunks menu item. 
3. Click on the Edit button beside the non-SMS SIPTrunk.
4. Go to the Authentication section.
   
5. In the Authentication ID field, add a capital X to the end of the ID. 
6. Click the Save button.

Activating the SMS Enabled Trunk

1. Click on the Call Flow drop-down menu.
   
2. Go to the SIP Trunks menu item. 
3. Click on the Edit button beside the SMS enabled SIPTrunk.
4. Go to the Authentication section.
5. In the Authentication ID field, remove the capital C to the end of the ID. 
6. Click the Save button. The calls will now filter through this trunk setup and not the disabled one.