A2P 10DLC
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
| On January 26, 2023, a new A2P 10DLC Campaign vetting process came into effect. For details on the change, see this article. This change is relevant to customers using long code numbers to send messages to the United States under the A2P 10DLC framework. This change does not apply to Toll-Free messaging.Effective January 26, 2023, newly registered A2P Campaigns are subject to a manual vetting process. T o help ensure your Campaigns are approved in this vetting process, please follow these best practices when submitting new Campaigns. | Campaign Field | Description | Requirements |
|---|---|---|---|
| Message Flow | The primary purpose of the Message Flow (or Call to Action) and required disclosures is to ensure the end user consents to receive text messages and understands the nature of the program. The Message Flow must be accessible by a 3rd party reviewer so it can be verified. | Explain if the Call to Action is behind a login, not yet published publicly, is verbal, on paper. Provide a screenshot of the Call to Action in such cases. Host the screenshot on a publicly accessible website (like OneDrive or Google Drive) and provide the URL in this field. | |
| Campaign Description | Provide a clear and comprehensive overview of the campaign’s objectives and interactions the end-user would experience after opting in. | If the Campaign pertains to Loan Arrangement or Direct Lending, specify such so that Twilio A2P Ops can update your Campaign to reflect. | |
| Terms and Conditions | Provide publicly accessible terms of service | Boilerplate terms of service that cover minimum requirements from the carriers can be found in our support article. | |
| Opt-in Message Confirmation | Required for all Opt-in methods | A confirmation message must be delivered immediately after the Consumer opts into the program.Message must containProgram or product descriptionCustomer care contact informationOpt-out instructionsProduct Quantity or recurring messages program disclosure“Message and data rates may apply” disclosure | |
| Sample Messages | Provide message examples highlighting the use case | Identify message sender (brand)Indicate templated fields with bracketsInclude opt-out language to at least 1 sample message |
| Best Practice | Examples |
|---|---|
| Consistency in brand, website, and sample messages | If your brand name is Acme, your website is www.acme.com, but your sample messages say, “Here’s your one-time passcode for logging into www.contoso.com,” your campaign will be rejected. |
| Consistency in sample messages and use cases | If you register a marketing campaign but sample messages say, “Here’s your one-time passcode: 123456”, your campaign will be rejected. |
| Consistency in email domain and company name | Your campaign will be rejected if you register a brand as LeadConnector Inc but provide an email address with the gmail domain names. *Note that this check only applies to large, well-known corporations that should have dedicated email domains |
| Make sure you submit real, working websites. | Indicating that your customers opt-in to your messages via the website, but providing a website address that does not work, will lead to campaign rejection. |
| Make sure the brand you register is the actual brand that you’re sending messages for | If ISV customers register a brand with your company’s information (e.g., a company that provides the tech for dental offices) but end up sending messages for your customers (e.g., individual dentist practices), your campaign will be rejected. |
| Make sure you create as few duplicative brands and campaigns as possible | Excessive brands with the same EIN and excessive campaigns with the same campaign attributes may be seen as high-risk and may result in campaign rejection |
| If you wish to send templated messages, please indicate the templated fields in sample messages with brackets to help reviewers better identify which parts are templated. | For example, please write, “Dental check due for [Mary Doe], Visit [www.contoso.com] to schedule an appointment or call [123-456-7890]” |
| Best Practice | Examples | |
|---|---|---|
| Make sure consumer opt-in is collected appropriately | If you indicate you collect opt-in via text messages, but your sample messages say, “Hi, is this the owner of 123 Oak Street? I’d like to discuss how I can help you sell your property”, it is clear that you have not collected appropriate consent before sending messages and your campaign will be rejected. | |
| Make sure opt-in language is available on your website if you indicated in the “message flow” field that a consumer opts into your campaign on your company website. | If your brand Acme uses its website, www.acme.com, to collect phone numbers but your website does not contain opt-in language such as “By providing your phone number, you agree to receive text messages from ACME. Message and data rates may apply. Message frequency varies.”, your campaign will be rejected. | |
| We recommend having opt-out language in at least one of your sample messages. | For example, please add language such as “Please reply STOP to opt-out” in one of your sample messages. | Note: The ecosystem constantly improves the vetting criteria as it comes across additional violations. Please do not consider the best practices listed above as a “catch-all” and guarantee approval as long as you follow them all; instead, consider them as a baseline that illustrates the general direction of compliant, high-quality messaging that the ecosystem is moving towards. |
| Opt-In Method | Example |
|---|---|
| Verbal | Salesmate IVR: “As part of our service we can send you automated monthly text alerts regarding Salesmate account payment activity. We will send two messages per month. Message and data rates may apply, depending on your mobile phone service plan. At any time you can get more help by replying HELP to these texts, or you can opt-out completely by replying STOP. Mobile Terms of Service are available at http://twil.io/terms and our Privacy Statement can be found at https://twil.io/privacy. Please reply with ‘yes’ or ‘no’ to indicate if you would like this service”. Salesmate Customer: “Yes please” Salesmate IVR: “Great! We will send you a text message to confirm your enrollment here shortly.” |
| Web Form | An embedded form on the end business’s website prompts end-users to enter their mobile handset phone number and opt into the texting campaign. Note checkbox should be selectable by the end-user for opting in. If the web opt-in is behind a login or not yet published, host a screenshot on a publicly accessible website (like OneDrive or Google Drive) and provide the URL in the Message Flow Field. |
| Paper Form | An in-store visitor completes a physical form that collects their phone number and their consent to subscribe to your texting campaign. Host a screenshot of the paper form on a publicly accessible website (like OneDrive or Google Drive) and provide the URL in the Message Flow Field. |
| Via Text | Host a screenshot of the campaign collateral on a publicly accessible website (like OneDrive or Google Drive) and provide the URL in the Message Flow Field. |
| Mobile QR Code | A QR code that links to an online form that prompts end-users to enter their mobile handset phone number and opt into the texting campaign. QR code can direct the mobile handset to their messaging application with a templated opt-in message or can lead to a web form as outlined above. If the QR code leads to an online form that is behind a login or not yet published, host a screenshot of the form on a publicly accessible website (like OneDrive or Google Drive) and provide the URL in the Message Flow Field. |
| Successful Example | Failed Example |
|---|---|
| 2FA use case is selected for any authentication or account verification such as OTP. | Higher Education is selected for any authentication or account verification such as OTP. Why is this rejected? If the use case does not match the intended use, the campaign will be rejected. |
| Successful Example | Failed Example |
|---|---|
| “Messages are sent by Acme to its existing customers. OTP Messages for MFA challenges for logging into the online portal to make changes to a user profile for security purposes. Customers confirm with an SMS when profile changes are made.” | “Blank” Why is this rejected? No information is provided for the campaign’s purpose. “This campaign sends messages to customers” Why is this rejected? It does not provide information on who is sending and receiving messages and why messages are being sent. |
| Successful Example | Failed Example |
|---|---|
| Message Flow: “Customers provide opt-in specifically when enrolling into our website or in person by requesting SMS capabilities within the store. Opt-in during website is a self-service process and occurs at acme.com/signup” Website Opt-in Language: “By submitting, you authorize ACME to send text messages with offers and other information. Message/data rates apply. Consent is not a condition of purchase. [Link to terms and conditions].” | Why is this rejected?Where and how the customer provides opt-in is unclear. |
| Successful Example | Failed Example |
|---|---|
| “ACME 2FA Notice: Here is your one-time password: 1234 Call [phone number] to report if this request was not made by you.” | “You have an upcoming appointment” Why is this rejected? If opt-out is not provided, the campaign will be rejected. |
| Successful Example | Failed Example |
|---|---|
| “START, OPTIN, UNSTOP, IN” | “Blank” Why is this rejected? Message flow indicates customers can opt-in through text but if no opt-in keywords are provided, the campaign will be rejected. |
| Successful Example | Failed Example |
|---|---|
| “You have successfully opted in for messages from ACME for account notifications. Message and data rates may apply. Reply Help for additional support. Reply STOP to unsubscribe.” | “You opted in for messages” Why is this rejected? Opt-in message does not contain any information on the brand and no information on the opt-out process, the campaign will be rejected. |
| Successful Example | Failed Example |
|---|---|
| “STOP, UNSUBSCRIBE, END, QUIT, HALT” | “Blank” Why is this rejected? Salesmate default Opt-out handling is disabled. As such, opt-outs must be handled via Salesmate Advanced Opt-Out or by your application. Specify the keywords you have configured for Opt-out handling. |
| Successful Example | Failed Example |
|---|---|
| ”You have successfully been unsubscribed from Acme Corporation. You will not receive any more messages from this number.” | “Opt-out successful. You will not receive any more messages from us.” Why is this rejected? If the opt-out message does not include the brand, the campaign will be rejected. |
| Successful Example | Failed Example |
|---|---|
| “HELP, ISSUE, FIX, RESOLVE, INQUIRY” | “Blank” Why is this rejected? Salesmate Default HELP keyword handling is disabled on the associated account. Customer must provide the keywords they have configured in Salesmate Advanced Opt-out or their own application. |
| Successful Example | Failed Example |
|---|---|
| ”Acme Corporation: Please visit www.acmecorporation.com to get support. To opt-out, reply STOP.” | “Blank” Why is this rejected? Salesmate Default HELP keyword handling is disabled on the associated account. Customer must provide the HELP messages that are sent in response to HELP keywords they have configured in Salesmate Advanced Opt-out or their own application. |