This article lists the requirements needed to set up your Telnyx Mission Control Portal account so that it's ready to be configured with your messaging system.
Telnyx Mission Control for Messaging
We recommend first reading on our Acceptable Use Policy for Messaging.
If you would prefer a guided setup and know some programming concepts check out our messaging "Learn & Build" after steps 1 & 2.
Let's get you set up!, you will need:
In order to assign a connection/messaging profile on a DID or a connection on an outbound voice profile, you'll need to be Level 1 verified. More information on account verification can be found here.
You will need to add a payment method to your account in order to top up your balance. This will be necessary to purchase numbers, send messages, make/receive calls etc.
Further details on how to add a payment method can be found in our Billing support article.
3. Messaging Profile Setup
A messaging profile is a record that contains all the basic settings for your messages. Telnyx's messaging features are completely programmatic, as such you will need a webhook URL in order to receive inbound messages and track outbound messages. You can find how to create a messaging profile here.
A DID (or TN, telephone number) is required in order to send and receive messages. There are several types of numbers and requirements for each:
Regular number (a.k.a. 10-Digit Long Code): A regular number, such as your cellphone, including it's country code: +1 234 567 8910, +52 2345 1232, etc.
Toll free number: A national number that allows caller fees to be passed on to the receiver (except for messaging).
Short code: An special type of number, you have probably received 2FA codes on your cellphone from these.
Numbers also need to explicitly be SMS and/or MMS enabled. Each of them has different requirements and pricing depending on their locations. Please note that if you acquire a number without SMS capabilities we will not be able to add them further on.
Alternatively you can port a number into Telnyx, learn how here.
Once you have added a DID on your account, you'll have to assign the messaging profile via the numbers main page or the number configuration page.
If you can't assign a messaging profile and you see the column showing Not SMS Capable this is likely because the number you have acquired is not capable of sending or receiving messages. Please make sure when searching and purchasing numbers that the messaging features icon shows SMS Available as seen in this picture.
If you come across the error: "Could not enable messaging on the number." when assigning a messaging profile to a number that is SMS capable, this may be related to the underlying provisioning with the central authority that handles the carrier NetNumber ID routing updates across the industry. If this error persists, please contact our support team so they can assist you further.
More details on our number search feature can be found here.
Determine your type of traffic.
Messaging is categorized in 2 types, A2P or Application-to-Person and P2P or Person-to-Person, more information here.
If your traffic is A2P, please check on the local regulations for messaging.
In the US and Canada, we strongly recommend optionally registering for 10DLC (soon mandatory) or mandatory registering Toll-Free Messaging, for these there might be additional lead time of up to 4 weeks or more depending on your use case and required documents.
We recommend that you also check out these related articles
If you wish to increase your default sending rate, you will first need to obtain Level 2 Verification.
As always! Feel free to search our knowledge base or reach out to us via email, chat or telephone if you need additional assistance and/or have other questions.