Skip to main content
Connect your Telnyx account to run Text agents over SMS from your Telnyx numbers. Messages go through your own Telnyx account and appear in your Telnyx messaging logs.

Before you start

You need:
  • A Telnyx account with at least one number that has SMS capability.
  • Your Telnyx API Key and Public Key (Mission Control → Account settings → Keys & Credentials).
  • For US local (10-digit) numbers, an approved 10DLC registration in Telnyx. Toll-free numbers need toll-free verification.

Set up Telnyx SMS

1

Connect Telnyx in Callers

Open App Center, find Telnyx, and connect it. In the Connect Telnyx window, enter the API Key and Public Key. Set the Messages Per Second (MPS) Limit to your messaging throughput (0.1–1000, default 1), then click Connect. See Telnyx SMS connection.
2

Sync your numbers

Your Telnyx numbers appear on the Phone numbers page and in the agent’s Channels window. Click Refresh to sync numbers you add later.
3

Create a Text agent

Create an agent and pick SMS as the channel, or switch an existing agent to Text in General Settings.
4

Assign numbers

In the agent header click Channels → Text Channels, choose Telnyx, and select one or more numbers. Save the agent.
5

Test and start

Click Test, enter your own mobile number, and click Start Chatting. When the chat looks right, start the agent.

Messaging profile

When you save a Text agent with Telnyx numbers, Callers creates a Telnyx messaging profile for that agent, named after the agent ID and name. It assigns the numbers to the profile and sets the profile’s webhook so replies reach the agent. You don’t need to create a profile or webhook yourself.
The messaging profile Callers creates allows destinations in the United States only. To message contacts in other countries, open the profile in Telnyx Mission Control and add those countries to its allowed destinations.

Settings reference

Sending hours, follow-ups, chat window, and message delay are covered in Text agent settings.

Opt-outs

Telnyx handles carrier opt-out keywords such as STOP on your numbers. If Telnyx rejects a message because the recipient has opted out, Callers ends the chat and marks the contact Unsubscribed instead of retrying. The agent also marks a contact Unsubscribed when they ask to stop in their own words. See Text message opt-outs and Compliance.

Troubleshooting

Add the destination countries to the agent’s messaging profile in Telnyx Mission Control. The profile Callers creates allows only US destinations.
  • Check that your Telnyx balance is funded and the number has messaging enabled.
  • For US local numbers, confirm your 10DLC campaign is approved and the number is assigned to it.
  • Check the Telnyx messaging logs for the error code.
Click Refresh. Check that the API key is valid and not revoked, and that the numbers have SMS capability.
Make sure the number is assigned to the messaging profile Callers created for this agent. If you moved it to another profile in Telnyx, save the agent again in Callers.

Telnyx integration

SIP voice and SMS connection details.

Text agent settings

Schedule, follow-ups, chat window, message delay.

Twilio SMS

Use Twilio numbers instead.

Telnyx messaging docs

Profiles, registration, and error codes.