Setting up a SIP Trunk with Voyced in FreeSWITCH
Supports inbound and outbound calling using Voyced as an external provider.
What You’ll Need
Before starting, make sure you have:
-
FreeSWITCH server admin/root access
-
Your Voyced SIP credentials:
-
Account / DID:
Your-Voyced-DID -
Service password:
YourServicePassword -
SIP server:
sip.voyced.eu
-
-
An internet connection with SIP (UDP) ports open in your firewall
Requirements Before You Begin
-
Ensure your FreeSWITCH server has a public IP or is correctly NAT configured.
-
Allow inbound/outbound SIP traffic on UDP port 5060 and RTP ports (usually 16384–32768).
-
Disable any SIP ALG on your router/firewall.
-
Confirm DNS resolution works so your PBX can resolve
sip.voyced.eu. -
Have a basic understanding of editing FreeSWITCH XML configuration files.
Step 1: Locate the External SIP Profile
FreeSWITCH uses SIP profiles located in:
(or /usr/local/freeswitch/conf/sip_profiles/external/ depending on your install).
Step 2: Create the Voyced Gateway File
Create a new XML file called:
inside the /external/ directory.
Step 3: Add Voyced Gateway Configuration
Paste the following into voyced.xml:
Step 4: Set Codec Preferences
Voyced supports:
-
PCMA (alaw)
-
PCMU (ulaw)
In /etc/freeswitch/vars.xml, make sure:
Step 5: Outbound Route (Dialplan)
In /etc/freeswitch/dialplan/public/ create a file, for example:
Add:
Step 6: Inbound Route (Dialplan)
In /etc/freeswitch/dialplan/public/ create or edit:
Example:
Replace 1000@domain.com with your local FreeSWITCH user/extension.
Step 7: Apply and Reload
Run:
Step 8: Testing
-
Make an outbound call to verify your gateway is working.
-
Call your Voyced DID from a mobile/landline to test inbound routing.
Troubleshooting
-
Gateway not registering → Check username/password and firewall rules.
-
No audio → Check NAT/RTP port forwarding.
-
404 inbound → Ensure the inbound route matches the exact DID format Voyced sends.
✅ Tip:
Once working, you can duplicate the gateway for multiple Voyced DIDs by creating new XML gateway files with different names but the same proxy and unique credentials.
Last updated: 10/08/2025
© Voyced
All information provided is copyrighted and purely informative in nature. It is maintained by Voyced with the greatest of care using reliable sources only.
Given the fast evolution of the telecom sector, Voyced does not offer any guarantee about the accuracy and completeness of the information offered.
We explicitly do not give anyone permission to use this information in any other way than to inform themselves about what (legal) requirements there may be and they need to comply with when registering Services and/or DIDs with Voyced.
