Skip to main content

Telnyx

Navigate to SMS Management

Add an SMS provider​

  • Log into your Vodia Tenant portal.

  • Click Trunks on the left menu then SMS Management

  • Under the Providers tab click the [+ | Add] button

  • Complete the information.

  • Name: Provide a name (for your purposes)

  • Provider: Select Telnyx

  • Application Secret: Paste your Telnyx API Key (V2). You can create this in the Telnyx portal under Account Settings > Keys & Credentials > API Keys. The key begins with KEY and is shown in full only once at creation, so copy it immediately. For example -

    KEY019EADCFDA2EB179C4ED6DCDFF8217FF0123456789ABCDEF...
    note

    Use an API Key, not a Messaging Profile Secret. The API Key authenticates against the Telnyx V2 Messages API (https://api.telnyx.com/v2/messages). A Messaging Profile Secret will fail authentication.

  • Click [Save].

Add your SMS numbers​

Now you need to add your DIDs into the Numbers tab.

  • Under the section SMS Management (Trunks on the left menu then SMS Management)
  • Click the Numbers tab and click the [+ | Add] button.
  • Provide a name (for your purposes)
  • Enter your phone number in E.164 format (e.g., +12025551234)
  • Policy: If you have any policy in place, choose it. (optional)
  • Provider: Choose the provider name you have created.
  • URL prefix for receiving messages: Enter something you will use for your SMS callback URL. Eg: telnyxw12319321n123
  • Source: It could be your extension number.
  • Destination: It could be your extension number.
  • Click [Save].

Configure Telnyx Messaging Profile and Webhook​

To send and receive SMS messages, your number must be attached to a Messaging Profile, and that profile must point its inbound webhook at your PBX:

  1. Log into the Telnyx Portal
  2. Navigate to Messaging > your Messaging Profile
  3. Confirm your sending number (in E.164 format) is assigned to this profile under Numbers > My Numbers
  4. Set the Inbound Settings:
    • Webhook URL: Your PBX URL with the prefix you specified above, for example: https://your-pbx-domain.com/telnyxw12319321n123
    • Webhook API Version: Select API v2
  5. Click Save

Your Telnyx SMS integration is now configured and ready to use.

10DLC registration (US local numbers)​

If you are sending from a US local (10DLC) number to US destinations, US carriers require the number to be registered under a 10DLC campaign before messages will be delivered. Without registration, messages are accepted by Telnyx but fail at the carrier with error 40010 (Not 10DLC registered).

To register:

  1. In the Telnyx portal, navigate to Messaging > 10DLC
  2. Register a Brand
  3. Create a Campaign describing your messaging use case
  4. Assign your sending number's Messaging Profile to the campaign

Registration can take from minutes to several days depending on carrier vetting. Toll-free and non-US numbers do not require 10DLC registration.