How to create a 10DLC campaign
If your business is sending application-to-person (A2P) text messages using 10-digit long code (10DLC) numbers in the US, you're required to register for 10DLC in order to avoid fees and penalties from mobile network operators. A2P messaging is defined as any messaging from or on behalf of a business, regardless of volume. 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 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.
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.
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. |
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.
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 | The opt in keywords the users need to text in order to start receiving messages from the campaign.
If your campaign does not support opt-in keywords, you do not need to provide this. |
Opt-in Message | If your campaign supports opt-in keywords to start receiving messages from this campaign, you need to provide the auto response that will be sent to the end users when they opt in. The opt-in response should include the Brand name, confirmation of the opt-in process for recurring messages from the campaign, how to get help, and opt-out language.
Example: “Your Brand: You have been opted-in. For help, reply HELP. Reply STOP to opt-out".
If you do not support opt-in messages, you do not need to provide this. |
Opt-out Keywords | Provide the keywords the users need to text in order to stop receiving messages from the campaign. Those keywords must be provided as part of the campaign registration process. |
Opt-out Message | The auto response that will be sent to the end users when they opt-out in order to confirm that no further messages will be sent from your campaign to their numbers.
Example: "You have successfully been unsubscribed from Your Brand. You will not receive any more messages from this number." |
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 | The auto response that will be sent to the end users when they send the HELP keyword.
Example: “Your Brand. Please visit example.com/help to get support. To opt-out, reply STOP."" |
Length requirements introduced to data fields
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" 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.