These instructions will walk you through how to configure FreeSWITCH to Voyant Trunking and the Voyant Admin Portal. This is a basic guide and will not cover setting up the base PBX or the setup of your extensions and subscriber numbers in detail. Further setup may require you to contact your PBX vendor support, directly, or utilize your PBX vendor forum/community pages.
Note: This guide assumes the FreeSWITCH is already set up and installed, and that the user has administrator account access to both FreeSWITCH and the Voyant Admin Portal.
Known Limitations and Caveats
This guide does not configure internal profiles or dial plans. It is assumed that the user understands how to configure FreeSWITCH to complete call routing in tandem with this guide to add Voyant SIP Trunking.
Setting up the Voyant Trunk
After logging into the Voyant Admin Portal navigate to “SIP Trunking” → “Trunks”.
Press the “Add New Trunk” button. On this screen you will configure the details necessary to create and enable the SIP Trunk for use.
Enter a friendly name for the SIP Trunk in the “Enter SIP Trunk Name” box as well as a SIP Domain Name for use in registering to this trunk. The SIP Domain Name will create a custom SRV record, which will be used to connect to this trunk while also providing redundancy between Voyant SBCs.
Select the “Create New Endpoint” button to bring up the Endpoint creation wizard.
From here select the option for “Registration” and enter a friendly name for the Endpoint, as well as a username that will be used to register. By default inbound and outbound calling are enabled; however, they can be changed at this time.
Once done, press the “Add Endpoint” button.
After closing this screen, you are returned to the main SIP Trunk Creation Screen. If you are satisfied with your choices press the “Create SIP Trunk” button at the bottom of the page.
Connecting to the Voyant Trunk
Configure your SIP profile for the Voyant Trunk
<!-- Directory where your VOYANT GATEWAY configuration(s) will reside -->
<X-PRE-PROCESS cmd="include" data="voyant/*xml"/>
<param name="context" value="public"/>
<param name="rfc2833-pt" value="101"/>
<param name="codec-prefs" value="PCMU,G729"/>
<param name="inbound-codec-negotiation" value="greedy"/>
<param name="unregister-on-options-fail" value="true"/>
<param name="pass-rfc2833" value="true"/>
<param name="inbound-late-negotiation" value="true"/>
<param name="nonce-ttl" value="60"/>
<param name="auth-calls" value="false"/>
<param name="rtp-timeout-sec" value="300"/>
<param name="rtp-hold-timeout-sec" value="1800"/>
<param name="challenge-realm" value="auto_from"/>
<param name="caller-id-type" value="pid"/>
Configure your gateway for inbound and outbound:
<!-- Username configured in the Voyant Portal -->
<param name="username" value="voyant-username-here"/>
<!-- Password assigned or configured in the Voyant Portal -->
<param name="password" value="your-password-here"/>
<!-- Your Voyant SIP Domain Name -->
<param name="proxy" value="mydomain.st.sip.global"/>
<param name="register" value="true"/>
Confirm trunk registration within the FreeSWITCH CLI with “sofia status gateway voyant”
The “State” and “Status” will confirm successful registration.
Your Voyant Trunk is now ready to be used with FreeSWITCH.
Note: Your dial plan must be configured for E.164 format (+1NPANXXNXXX) for inbound calls as well as outbound calls and the caller ID presentation.