Skip to main content

​
Overview

Telnyx SMS integration enables your Callers text campaigns to send and receive text messages through the Telnyx messaging platform. Telnyx offers competitive per-message pricing, high throughput, and global carrier connectivity - making it an excellent choice for large-scale text campaigns.
If you already have Telnyx connected for SIP voice campaigns, you can use the same account for text campaigns. You will need to ensure your numbers have messaging capability enabled.

​
Prerequisites

  • A Telnyx account
  • Access to the Telnyx Mission Control Portal
  • A Telnyx phone number with SMS capabilities
  • Your Telnyx API Key and Public Key

​
Step 1: Create or Verify Your Telnyx Account

  1. Go to Telnyx and click Sign Up.
  2. Complete the registration form and verify your email address.
  3. Add a payment method and fund your account.

​
Step 2: Generate Your API Key and Public Key

  1. Log in to the Telnyx Mission Control Portal.
  2. Navigate to Auth > API Keys.
  3. Click Create API Key.
  4. Give the key a name and copy the API key.
  5. In the same Auth > API Keys section, copy your Public Key.

​
Step 3: Purchase an SMS-Enabled Number

  1. In the Telnyx Portal, go to Numbers > Search & Buy.
  2. Search for numbers in your desired area code or country.
  3. Filter results to show only numbers with SMS capability.
  4. Select and purchase your desired number(s).
For US messaging, Telnyx supports local numbers, toll-free numbers, and short codes. Local numbers require 10DLC registration for A2P messaging.

​
Step 4: Register for 10DLC (US Numbers)

If you are sending SMS to US phone numbers using a local (10-digit) number, you must register for A2P 10DLC. Contact our support team for help with the registration process.

​
Step 5: Connect Telnyx to Callers

  1. Log in to your Callers dashboard.
  2. Navigate to the App Center tab in the left sidebar.
  3. Find the Telnyx integration and click Connect.
  4. Enter your Telnyx API Key and Public Key in the fields provided.
  5. Click Connect to complete the integration.
  6. Your Telnyx phone numbers will appear in the numbers list.

​
Step 6: Configure a Text Campaign with Telnyx

  1. Create a new campaign and select Text as the campaign type.
  2. In Campaign Setup, under the Channel section, select Telnyx SMS as your messaging provider.
  3. Choose the Telnyx phone number(s) to use for this campaign.
A Telnyx Messaging Profile is automatically created when you save a text campaign with a selected Telnyx phone number. No manual setup is required.

​
Compliance and Opt-Out Management

Callers handles SMS compliance automatically when using Telnyx:
  • STOP/UNSUBSCRIBE: Contacts who reply STOP are automatically opted out.
  • HELP: Contacts who reply HELP receive your configured help response.

​
Troubleshooting

  • Verify your Telnyx account has sufficient funds.
  • Check that your phone number has messaging enabled in the Telnyx Portal.
  • Confirm your Messaging Profile is correctly configured.
  • For US numbers, verify your 10DLC campaign registration is approved.
  • Check the Telnyx Portal messaging logs for error details.
  • Ensure your API key is valid and has not been revoked.
  • Verify the numbers have SMS capability (not voice-only).
  • Verify the webhook URL in your Telnyx Messaging Profile matches the one provided by Callers.
  • Check that your number is assigned to the correct Messaging Profile.

​
Next Steps