> ## Documentation Index
> Fetch the complete documentation index at: https://docs.callers.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Telnyx SMS

> Complete guide to setting up Telnyx as your SMS messaging provider for text campaigns in Callers.

## 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.

<Info>
  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.
</Info>

## 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](https://telnyx.com/) 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](https://portal.telnyx.com/).
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).

<Note>
  For US messaging, Telnyx supports local numbers, toll-free numbers, and short codes. Local numbers require 10DLC registration for A2P messaging.
</Note>

## 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](mailto:support@callers.ai) for help with the registration process.

## Step 5: Connect Telnyx to Callers

1. Log in to your [Callers dashboard](https://app.callers.ai/).
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.

<Info>
  A Telnyx Messaging Profile is automatically created when you save a text campaign with a selected Telnyx phone number. No manual setup is required.
</Info>

## 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

<AccordionGroup>
  <Accordion title="Messages are not being delivered">
    * 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.
  </Accordion>

  <Accordion title="Telnyx numbers are not appearing in Callers">
    * Ensure your API key is valid and has not been revoked.
    * Verify the numbers have SMS capability (not voice-only).
  </Accordion>

  <Accordion title="Inbound messages are not being received">
    * 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.
  </Accordion>
</AccordionGroup>

## Next Steps

* [Configure campaign settings](/documentation/text-campaigns/text-campaign-setup) for message timing and availability.
* Review [Telnyx's messaging documentation](https://developers.telnyx.com/docs/messaging) for advanced configuration options.