How to create a 10DLC campaign
If your business is sending outbound text messages using 10-digit long code (10DLC) Local phone numbers in the US, you're required to register for 10DLC. In this guide, we'll show you how to complete the second step of this process by registering campaigns, using tools provided in the Telnyx Mission Control Portal.
Pre-requisites
Every campaign must be associated with a brand. If you haven't already registered your brand, you'll need to do that before you can activate a campaign and send messages. Follow this guide to complete this first step before moving onto creating a campaign.
Additionally, you will want to ensure that your brand has a good Trust Score, as A2P 10DLC message throughput is determined based on your Trust Score and your Campaign Use Case. Learn more on throughput and Trust Scores in this article.
Creating a 10DLC campaign in the Mission Control Portal
Once you’ve created a Business Brand in Mission Control Portal, head to the Messaging section > Compliance > and then to the 10DLC Campaigns tab. From here, you can get started on creating a campaign.
Creating a 10DLC campaign using the Telnyx API
If you'd prefer to create your brand using a simple API command, you can find details in our API reference documentation.
Information you'll need to register your 10DLC campaigns
A campaign contains information about the messages you intend to send. You'll be asked for the following information when registering a 10DLC campaign.
What is message flow?
When adding a new campaign, "Message Flow" refers to the process of how users opt into the campaign. For example, users might visit a website and add their phone number to agree to receive messages. This information needs to be added when registering a 10DLC campaign.
Please note that the length of the "Message Flow" description should be between 40 and 2048 characters.
Item | Description |
Brand | The 10DLC brand you want to associate this campaign with. |
Use case | The use case that best matches your campaign:
Messages sent that do not align with your registered use case may be subject to fines and throughput limitations and blocks. |
Vertical | The industry vertical which best matches your business. |
Campaign description | The description of your campaign. |
Sample messages | Sample content that represents the messages you plan to send to end users. You may add multiple sample messages. You need one sample message for each selected use case. A marketing use case requires 2 sample messages. A Mixed use case requires a minimum of 2 sample messages but should have one for each selected use case.
Messages sent that do not align with the registered sample message can be flagged for review. |
Campaign and content attributes | Indicate which content attributes you will or will not be providing:
|
Message Flow | The customers need to add information of how the users opt in to the campaign.
Example: The users visit the website and add their phone number to agree receiving the messages. |
Opt-in Keywords | Required field. Example: START, JOIN, YES
|
Opt-in Message | Please follow this format: |
Opt-out Keywords | Example: STOP |
Opt-out Message | Please follow this format: |
Help Keywords | The end users should be able to text in a keyword to receive help. Those keywords must be provided as part of the campaign registration request.
Example keyword: HELP |
Help Message | Please follow this format: |
Field | Min length | Max length |
Campaign description | 40 | 4096 |
Help message | 20 | 320 |
Message Flow | 40 | 2048 |
Opt in Message | 20 | 320 |
Opt out Message | 20 | 320 |
Opt-in Keywords |
| 255 |
Opt-out Keywords |
| 255 |
Help Keywords |
| 255 |
Next steps after registering your campaign
The next step after you’ve registered your campaign is it will be reviewed and either approved or declined. We will send automatic status update emails for every campaign to the username email on the account. If you would like for more email addresses to receive 10dlc status notifications please ask your CSM to add the email. If you have no csm you can request the addition by messaging 10dlcquestions@telnyx.com. Once you have received the "Approved" status notification for the campaign you assign numbers to it and begin sending! Congrats :).
Note: If you are receiving an "invalid date" or TCR Creation Failed status for your campaign in the Telnyx portal then this indicates that TCR (the regulating body of US local text messaging) has rejected the campaign due to a technical issue with your submission such as a character requirement was missed or the wrong number of sample messages was added (you must have at least one sample message per use case selected so if you select Mixed and then have 5 sub Use Cases then you must have 5 sample messages). It is different than a carrier rejection. If you are having this issue please reach out to us at 10dlcquestions@telnyx.com and we will work with our messaging team to identify the failure reason. Then we will communicate the failure reason to you and the campaign will need to be re-created.
If you have any messaging compliance questions please reach out to us at 10dlcquestions@telnyx.com.