Before you start
- A Telnyx account with access to the Mission Control Portal.
- One or more Telnyx numbers with voice enabled.
Step 1: Create a SIP connection in Telnyx
1
Create a credentials-based connection
In Mission Control, go to Voice → SIP Trunking and create a SIP connection that uses credentials authentication. Set a username and password and note them.
2
Assign your numbers
Go to Numbers → My Numbers and, for each number, set Connection to the SIP connection you created.
3
Enable outbound destinations
In the connection’s outbound settings, assign an outbound voice profile that allows the countries your agents will call.
With a credentials connection, Telnyx delivers inbound calls to the registered device. Callers registers with Telnyx when Require SIP Register is on (Step 2), which is what lets your Telnyx numbers ring your incoming agents. Check the registration status in the connection’s settings in Mission Control.
Step 2: Add the SIP connection in Callers
Go to App Center → SIP Integration → + and fill in:
Add an Outgoing gateway with the Telnyx endpoint closest to you:
Use port 5060 with UDP or TCP, or 5061 with TLS. Add a second outgoing gateway with another region for redundancy if you like.
Click Next and add your Telnyx numbers in E.164 format, for example
+12025550123.
Step 3: Test
- Open the SIP connection and click Test SIP. Pick a Telnyx number in Call from and your phone in Call to. A 200 result means Telnyx accepted the call.
- Assign a number to an incoming agent and call it to test inbound.
Telnyx SMS
To send and receive text messages with your Telnyx numbers, connect your Telnyx account in the App Center:- Open App Center, find Telnyx, and click +.
- Enter your Telnyx API Key and Public Key (from Account settings → Keys & Credentials in Mission Control).
- Set Messages Per Second (MPS) Limit to your messaging throughput (0.1–1000, default 1), then click Connect.
The Telnyx App Center connection is enabled per account. If you don’t see it, email to turn it on.
Troubleshooting
Inbound calls don't reach the agent
Inbound calls don't reach the agent
Check that Require SIP Register is on and the registration shows as active in Mission Control. Check that the number is assigned to the Telnyx connection, added to the Callers SIP connection, and assigned to an incoming agent.
Test SIP returns 401 or 403
Test SIP returns 401 or 403
Recheck the credentials. A 403 can also mean the destination isn’t allowed in your outbound voice profile.
Calls fail during busy periods
Calls fail during busy periods
Lower Calls Per Second (CPS) Limit to match your Telnyx account’s limit.
Related
SIP trunk setup
Reference for every SIP setting.
Telnyx SMS
Build a text agent on Telnyx.
Telephony overview
Compare connection options.
Phone numbers & caller ID
Assign numbers to agents.