How to register a campaign for 10DLC

Note: This information is subject to change based on the requirements of The Campaign Registry.

This article explains how to register your campaign(s) for 10DLC in the Bandwidth Dashboard. To learn more about campaigns, see Registering brands and campaigns for 10DLC. For an overview of 10DLC, check out our 10DLC Overview.

Registering a campaign

1. Log into the Bandwidth Dashboard and select Campaigns in the top navigation bar.

Note: If you don't see the Campaigns tab, your account may not yet be enabled. Please open a support ticket or reach out to your Account Manager for assistance.

2. Click Campaigns in the sub-navigation bar. You'll see a list of campaigns that have been previously registered on your account.
3. Click + New Campaign or Create a New Campaign to begin the campaign registration process.

4. Select the brand you want to associate with your campaign.

5. Select your campaign use case and click Next.

• • If you have a standard use case, select an option from the Standard Campaign Type column. You only need to select one to proceed to the next section.
  • If you have a special use case, select an option from the Special Campaign Type column. Please note that these use cases need to go through the Mobile Network Operator (MNO) manual approval processes and may not be registered for some time.

Note: Bandwidth will no longer be supporting the Sole Proprietor use case for those customers registering through us as of 11/1.  

Note: If you select Low Volume Mixed or Mixed, you'll see additional use cases displayed below. You must select two or more to continue to the next step.

 

6. Enter your campaign details and click Create.

Note: Please don't include emojis when entering sample messages, as this can cause an error.

 

The following fields are required as of November 17:

• optoutMessage
• messageFlow 
• helpMessage

The following fields will remain optional:

• optinKeywords
• optinMessage
• optoutKeywords 
  • TCR will implement a new default value of STOP. You will be able to replace the default value.
• helpKeywords 
  • TCR will implement a new default value of HELP. You will be able to replace the default value.

The following length requirements will take effect on November 17:

* Denotes a change from the current length requirement. Error 501 will be returned if these length requirements are not respected.

Field	Minimum Characters	Maximum Characters
description	40*	4096
sample	20*	1024
messageFlow	40*	2048
helpMessage	20*	320*
helpKeywords	0	320*
optinKeywords	0	320*
optoutKeywords	0	320*
optinMessage	20*	320*
optoutMessage	20*	320*

7. Once you've successfully registered your campaign, you'll be brought back to the My Campaigns page.

Campaign and MNO statuses

You can view the statuses of your campaigns on the My Campaigns page.

Campaign status

The campaign status can be either Active or Expired. Immediately after the campaign is registered, its status will be set to Active. It'll become Expired only if you deactivate the campaign yourself or if the auto-renewal is turned off for the campaign.

MNO status

The MNO (carrier) status can be either Review, Registered, Rejected, or Suspended. For standard use cases, all MNO statuses will be set to Registeredimmediately after registering a campaign. For special use cases, all MNO statuses will be set to Review and will be subject to a manual review process. An MNO can suspend and/or unsuspend a campaign at any time at their discretion.

Note: Campaign status and MNO status are entirely independent of each other. A campaign can have an Active status but still be in Review, Rejected, or Suspended status by one or more MNOs. If the campaign has an Expired status or if any of the MNO statuses aren't set to Registered, then the campaign can't be associated with a TN in our system. If a campaign has already been associated with TN(s) and then becomes Expired or Suspended, it'll be removed from those TN(s).

Error messages

We have some asynchronous processing that happens behind the scenes after registering a campaign. In the event of a processing delay, the campaign in question will have an error message displayed next to it on the My Campaigns page. Processing should be complete within one hour. If your campaign is experiencing a processing delay, it won't be eligible to be assigned to a TN until the delay is resolved.

Campaign details

While on the My Campaigns page, you can click on a campaign ID to view the Carrier Term Preview and the Campaign Details sections.

Editing a campaign

To edit your campaign, click the Edit Campaign button above the Carrier Term Preview section. You can only edit the Automatically renew campaign, Campaign Details, Message Flow and the Sample Messages sections. 

Campaign Vetting

With the introduction of the new Campaign Vetting process, you may find that your campaign is in a Pending, Declined, or Accepted state when you look at the Campaign Details. In the My Campaigns page, you will be able to see the status in the "Vetting" column as noted below:

If your campaign is declined, you will see the status in the My Campaigns page along with the decline reason. If you click the campaign ID, you can get more details about the decline reason.

The decline reason will tell you what needs to be adjusted on the campaign in order to get it approved by our aggregator. Once you've made all the edits to address the decline reasons, you will then need to Resubmit the campaign for vetting by selecting the RESUBMIT VETTING button. Please only select the resubmit button once you're done making all of your edits.

If your campaign ends up being accepted after you resubmit (or if the campaign was accepted on initial submission), you will see the Campaign Vetting status as REGISTERED and you will see the RESUBMIT VETTING button greyed out since you would not need to resubmit the campaign. 

Deactivating a campaign

To deactivate your campaign, click the Deactivate Campaign button located next to Edit Campaign. You'll be prompted with a warning message. To confirm that you want to delete your campaign, click Deactivate Forever.

Important: This action can't be reversed. Deactivating a campaign will change its campaign status to Expired and remove that campaign from all TNs in our system. Campaigns in Expired status can't be edited or reactivated. Please note that if you deactivate a campaign within 3 months of creating it, you'll still be charged for the full 3 months.

Importing a campaign

1. In the top navigation bar, select Campaigns. If your account is set up to import campaigns, you'll be routed to the Imported Campaigns page where you'll see a list of campaigns that have been previously imported to your account. 

2. Click New Imported Campaign. This will bring up a New Campaign modal.
3. Enter the ID of the campaign you want to import and click Import.

Assigning a campaign to a TN

This step is applicable if you're registering brands through Bandwidth or TCR.

1. Navigate to the Search Telephone Numbers section on the right side of the home page. 
2. Enter the phone number and click Search.

3. Click the blue phone number link. This will take you to the Phone Number Details page.

4. Once you're on the Phone Number Details page, scroll down to SMS Settings. 

5. Ensure that the SMS Enabled toggle is on and the Use location defaults toggle is off.
6. Use the A2P Campaign ID drop-down menu to select the campaign you want to assign to this TN. Once you do that, the A2PLC Message Class field will auto-populate with the message class assigned from TCR.
7. Click Save. The TN will be associated with the campaign ID and will be ready for use.

Note: If you don't see the Campaign ID in the drop-down menu, it's likely because: 1. It hasn't been registered with all Mobile Network Operators (MNOs); 2. It's been deactivated and is in Expired status; 3. The background processing for your Campaign has been delayed. This should be resolved within one hour of initial registration. For the full list of statuses and their descriptions, please see our campaign FAQs. For more info on TNs, please see our number ordering guide.

Removing a TN from a campaign

This step is applicable if you're registering brands through Bandwidth or TCR.

1. Follow steps 1-4 from above to navigate to the Phone Number Details page and down to the SMS Settings section.
2. Enable the Delete campaign from phone number toggle and click Save.

Bulk assigning a campaign to multiple TNs

1. In the top navigation bar, select Numbers and click My Numbers.
2. Select Line Features and click the download a template .csv file link. This will download the CSV file into your web browser.

Note: If you don’t see the file, please make sure your browser is set to allow pop-ups from the Bandwidth Dashboard and try again. If you still can’t locate it, check the Downloads section in your browser or the Downloads folder on your computer.

3. Once you open the template, you'll see sample data that shows how the file needs to be filled out for various features. Please erase all information in rows 3-6 before entering your own.
4. In the TN column, enter the phone number to which you want to assign the campaign. Please use the 10-digit format without spaces, parentheses, or dashes.
5. In the A2pSettings CampaignId column, enter the ID of the campaign that you want to assign to the number.
6. In the A2pSettings Action column, type asSpecified.

7. Once you're done, save the file in the .csv format and return to the Upload Line Features page.  
8. Drag and drop the file into the Choose a .csv file to import field or click Browse to search for it on your computer.
9. Enter an optional Customer order ID that can be used to identify any orders created as a result of this file import.
10. Click Import to upload your file and start processing your TNs. Upon successful completion, the TNs will have the appropriate campaign ID assigned and will be ready for use.

Note: If you encounter any errors when uploading the file, please double-check that the formatting is correct. Errors may occur due to an incorrect file type (anything other than .csv), spaces in the file name, or formatting issues in the file itself. 

Bulk removing multiple TNs from campaigns

1. Follow the steps in the previous section with one change to step 5. In this step, leave the CampaignId blank - this will delete the campaign from the TNs once uploaded.
2. See notes above for uploading the .csv file and any potential errors.

Questions? Please open a ticket with your Bandwidth Support Team or hit us up at (855) 864-7776!

< Back to 10DLC Overview