Skip to main content
Use your Telnyx numbers with Callers agents. Voice calls run over a Telnyx SIP connection that you add as a SIP trunk in Callers. To send text messages from Telnyx numbers, also connect your Telnyx account in the App Center (see Telnyx SMS).

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

  1. 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.
  2. Assign a number to an incoming agent and call it to test inbound.
See Test your connection for result codes.

Telnyx SMS

To send and receive text messages with your Telnyx numbers, connect your Telnyx account in the App Center:
  1. Open App Center, find Telnyx, and click +.
  2. Enter your Telnyx API Key and Public Key (from Account settings → Keys & Credentials in Mission Control).
  3. Set Messages Per Second (MPS) Limit to your messaging throughput (0.1–1000, default 1), then click Connect.
Your Telnyx numbers then appear on the Phone numbers page. Click Refresh to sync new numbers. See Telnyx SMS to build a text agent.
The Telnyx App Center connection is enabled per account. If you don’t see it, email to turn it on.

Troubleshooting

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.
Recheck the credentials. A 403 can also mean the destination isn’t allowed in your outbound voice profile.
Lower Calls Per Second (CPS) Limit to match your Telnyx account’s limit.

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.