Skip to content
This repository was archived by the owner on Nov 29, 2023. It is now read-only.

Commit 6ca48c2

Browse files
nirmitpatelnirmitpatel
authored
Merge pull request #809 from Bandwidth/MV-7602
MV-7602: Updating CSP Campaign doc
2 parents 7a3b731 + 79a7422 commit 6ca48c2

File tree

1 file changed

+84
-18
lines changed

1 file changed

+84
-18
lines changed

‎site/docs/messaging/campaign-management/csp/campaign-api.mdx

Lines changed: 84 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -44,9 +44,9 @@ This walks through how to programmatically provision, manage and view your campa
4444
* You have [registered a brand](../reseller-brand-api)
4545

4646
## Important Notes
47-
* We only support campaigns that have been approved by all carriers participating through TCR.
47+
* We only support campaigns that have been approved by all carriers participating through TCR.
4848
While provisioning your campaigns through Bandwidth /campaigns API, they will automatically provision to all participating carriers.
49-
* If you get a '403 Unauthorized' error response while making an HTTP Request to any of the Import endpoints,
49+
* If you get a '403 Unauthorized' error response while making an HTTP Request to any of the Import endpoints,
5050
you will need to reach out to the Implementation team to get the Campaign Management role assigned to your API User.
5151
* TCR currently has rate limits set on their HTTP REST endpoints. During high volume events, it is possible our APIs will be rate limited and respond with '429 Too Many Requests'.
5252

@@ -91,7 +91,7 @@ HTTP/1.1 429 Too Many Requests
9191
| `Usecase` | Yes | Campaign usecase. Must be of defined valid types |
9292
| `SubUsecases` | No (Required for some usecases) | Campaign sub-usecases. Must be of defined valid types |
9393
| `ResellerId` | No | Alphanumeric identifier of the reseller that you want to associate with this campaign. |
94-
| `Description` | Yes | Summary description of this campaign. Max length 4096 |
94+
| `Description` | Yes | Summary description of this campaign. Min length 40. Max length 4096 |
9595
| `EmbeddedLink` | No | Does message generated by the campaign include URL link in SMS? Default false |
9696
| `EmbeddedPhone` | No | Does message generated by the campaign include phone number in SMS? Default false |
9797
| `NumberPool` | No | Does campaign utilize pool of phone numbers? Default false |
@@ -100,13 +100,18 @@ HTTP/1.1 429 Too Many Requests
100100
| `SubscriberOptIn` | No | Does campaign require subscriber to opt-in before SMS is sent to subscriber? Default false |
101101
| `SubscriberOptOut` | No | Does campaign support subscriber opt-out keyword(s)? Default false |
102102
| `SubscriberHelp` | No | Have you implemented a response to the HELP keyword informing customers of how they can contact the message sender? Default false |
103-
| `Sample1` | Yes | Message sample. Some campaign tiers require 1 or more message samples. Max length 1024 |
104-
| `Sample2` | No (Required for some usecases) | Message sample. Some campaign tiers require 2 or more message samples. Max length 1024 |
105-
| `Sample3` | No (Required for some usecases) | Message sample. Some campaign tiers require 3 or more message samples. Max length 1024 |
106-
| `Sample4` | No (Required for some usecases) | Message sample. Some campaign tiers require 4 or more message samples. Max length 1024 |
107-
| `Sample5` | No (Required for some usecases) | Message sample. Some campaign tiers require 5 message samples. Max length 1024 |
108-
| `MessageFlow` | No | Message flow description. Max length 2048 |
109-
| `HelpMessage` | Yes | Help message of the campaign. Max length 255 |
103+
| `Sample1` | Yes | Message sample. Some campaign tiers require 1 or more message samples. Min length 20. Max length 1024 |
104+
| `Sample2` | No (Required for some usecases) | Message sample. Some campaign tiers require 2 or more message samples. Min length 20. Max length 1024 |
105+
| `Sample3` | No (Required for some usecases) | Message sample. Some campaign tiers require 3 or more message samples. Min length 20. Max length 1024 |
106+
| `Sample4` | No (Required for some usecases) | Message sample. Some campaign tiers require 4 or more message samples. Min length 20. Max length 1024 |
107+
| `Sample5` | No (Required for some usecases) | Message sample. Some campaign tiers require 5 message samples. Min length 20. Max length 1024 |
108+
| `MessageFlow` | Yes | Message flow description. Min length 40. Max length 2048 |
109+
| `HelpMessage` | Yes | Help message of the campaign. Min length 20. Max length 320 |
110+
| `HelpKeywords` | No | Help keywords of the campaign. Max length 320. TCR will default the value to HELP. Multiple keywords are comma separated without space. |
111+
| `OptinMessage` | No | Opt-In message of the campaign. Min length 20. Max length 320 |
112+
| `OptinKeywords` | No | Opt-In keywords of the campaign. Max length 320. Multiple keywords are comma separated without space. |
113+
| `OptoutMessage` | Yes | Opt-Out message of the campaign. Min length 20. Max length 320 |
114+
| `OptoutKeywords` | No | Opt-Out keywords of the campaign. Max length 320. TCR will default the value to STOP. Multiple keywords are comma separated without space. |
110115
| `AffiliateMarketing` | No | Is affiliate marketing being used (or was used in the creation of the campaign)? Default false |
111116
| `ReferenceId` | No | Caller supplied campaign reference ID. If supplied, the value must be unique across all submitted campaigns. Can be used to prevent duplicate campaign registrations. Max length 50 |
112117
| `AutoRenewal` | Yes | Campaign subscription auto-renewal status. Default true |
@@ -140,6 +145,13 @@ Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
140145
<AffiliateMarketing>false</AffiliateMarketing>
141146
<AgeGated>false</AgeGated>
142147
<AutoRenewal>true</AutoRenewal>
148+
<MessageFlow>This is a sample Message Flow of my campaign.</MessageFlow>
149+
<HelpKeywords>HELP</HelpKeywords>
150+
<HelpMessage>This is a sample Help Message of my campaign.</HelpMessage>
151+
<OptinKeywords>START,YES</OptinKeywords>
152+
<OptinMessage>This is a sample Opt-In Message of my campaign.</OptinMessage>
153+
<OptoutKeywords>STOP,NO</OptoutKeywords>
154+
<OptoutMessage>This is a sample Opt-Out Message of my campaign.</OptoutMessage>
143155
</Campaign>
144156
```
145157

@@ -171,6 +183,13 @@ Location: https://dashboard.bandwidth.com/api/accounts/{accountId}/campaignManag
171183
<SubscriberHelp>true</SubscriberHelp>
172184
<Sample1>Test Sample</Sample1>
173185
<AffiliateMarketing>false</AffiliateMarketing>
186+
<MessageFlow>This is a sample Message Flow of my campaign.</MessageFlow>
187+
<HelpKeywords>HELP</HelpKeywords>
188+
<HelpMessage>This is a sample Help Message of my campaign.</HelpMessage>
189+
<OptinKeywords>START,YES</OptinKeywords>
190+
<OptinMessage>This is a sample Opt-In Message of my campaign.</OptinMessage>
191+
<OptoutKeywords>STOP,NO</OptoutKeywords>
192+
<OptoutMessage>This is a sample Opt-Out Message of my campaign.</OptoutMessage>
174193
<MnoMetadataList>
175194
<MnoMetadata>
176195
<MnoId>10017</MnoId>
@@ -236,13 +255,13 @@ Location: https://dashboard.bandwidth.com/api/accounts/{accountId}/campaignManag
236255
| Campaign | Mandatory | Editable | Description |
237256
|:---------------------------|:----------|:---------|:------------------------------------------------------|
238257
| `ResellerId` | No | Yes | Alphanumeric identifier of the reseller that you want to associate with this campaign. |
239-
| `Sample1` | No | Yes | Message sample. Some campaign tiers require 1 or more message samples. Max length 1024 |
240-
| `Sample2` | No (Required for some usecases) | Yes | Message sample. Some campaign tiers require 2 or more message samples. Max length 1024 |
241-
| `Sample3` | No (Required for some usecases) | Yes | Message sample. Some campaign tiers require 3 or more message samples. Max length 1024 |
242-
| `Sample4` | No (Required for some usecases) | Yes | Message sample. Some campaign tiers require 4 or more message samples. Max length 1024 |
243-
| `Sample5` | No (Required for some usecases) | Yes | Message sample. Some campaign tiers require 5 message samples. Max length 1024 |
244-
| `MessageFlow` | No | Yes | Message flow description. Max length 2048 |
245-
| `HelpMessage` | No | Yes | Help message of the campaign. Max length 255 |
258+
| `Sample1` | No | Yes | Message sample. Some campaign tiers require 1 or more message samples. Min length 20. Max length 1024 |
259+
| `Sample2` | No (Required for some usecases) | Yes | Message sample. Some campaign tiers require 2 or more message samples. Min length 20. Max length 1024 |
260+
| `Sample3` | No (Required for some usecases) | Yes | Message sample. Some campaign tiers require 3 or more message samples. Min length 20. Max length 1024 |
261+
| `Sample4` | No (Required for some usecases) | Yes | Message sample. Some campaign tiers require 4 or more message samples. Min length 20. Max length 1024 |
262+
| `Sample5` | No (Required for some usecases) | Yes | Message sample. Some campaign tiers require 5 message samples. Min length 20. Max length 1024 |
263+
| `MessageFlow` | Yes | Yes | Message flow description. Min length 40. Max length 2048 |
264+
| `HelpMessage` | Yes | Yes | Help message of the campaign. Min length 20. Max length 320 |
246265
| `AutoRenewal` | No | Yes | Campaign subscription auto-renewal status. Default true |
247266
| `BrandId` | Yes | No | Alphanumeric identifier of the brand associated with this campaign |
248267
| `Vertical` | Yes | No | Business/industry segment of this campaign. Must be of defined valid types |
@@ -259,6 +278,11 @@ Location: https://dashboard.bandwidth.com/api/accounts/{accountId}/campaignManag
259278
| `SubscriberHelp` | No | No | Have you implemented a response to the HELP keyword informing customers of how they can contact the message sender? Default false |
260279
| `AffiliateMarketing` | No | No | Is affiliate marketing being used (or was used in the creation of the campaign)? Default false |
261280
| `ReferenceId` | No | No | Caller supplied campaign reference ID. If supplied, the value must be unique across all submitted campaigns. Can be used to prevent duplicate campaign registrations. Max length 50 |
281+
| `HelpKeywords` | No | Yes | Help keywords of the campaign. Max length 320. TCR will default the value to HELP. Multiple keywords are comma separated without space. |
282+
| `OptinMessage` | No | Yes | Opt-In message of the campaign. Min length 20. Max length 320 |
283+
| `OptinKeywords` | No | Yes | Opt-In keywords of the campaign. Max length 320. Multiple keywords are comma separated without space. |
284+
| `OptoutMessage` | Yes | Yes | Opt-Out message of the campaign. Min length 20. Max length 320 |
285+
| `OptoutKeywords` | No | Yes | Opt-Out keywords of the campaign. Max length 320. TCR will default the value to STOP. Multiple keywords are comma separated without space. |
262286

263287
### Examples
264288

@@ -306,6 +330,13 @@ Location: https://dashboard.bandwidth.com/api/accounts/{accountId}/campaignManag
306330
<SubscriberHelp>true</SubscriberHelp>
307331
<Sample1>test update sample</Sample1>
308332
<AffiliateMarketing>false</AffiliateMarketing>
333+
<MessageFlow>This is a sample Message Flow of my campaign.</MessageFlow>
334+
<HelpKeywords>HELP</HelpKeywords>
335+
<HelpMessage>This is a sample Help Message of my campaign.</HelpMessage>
336+
<OptinKeywords>START,YES</OptinKeywords>
337+
<OptinMessage>This is a sample Opt-In Message of my campaign.</OptinMessage>
338+
<OptoutKeywords>STOP,NO</OptoutKeywords>
339+
<OptoutMessage>This is a sample Opt-Out Message of my campaign.</OptoutMessage>
309340
</Campaign>
310341
</CampaignResponse>
311342
```
@@ -379,6 +410,13 @@ Location: https://dashboard.bandwidth.com/api/accounts/{accountId}/campaignManag
379410
<SubscriberHelp>true</SubscriberHelp>
380411
<Sample1>test update sample</Sample1>
381412
<AffiliateMarketing>false</AffiliateMarketing>
413+
<MessageFlow>This is a sample Message Flow of my campaign.</MessageFlow>
414+
<HelpKeywords>HELP</HelpKeywords>
415+
<HelpMessage>This is a sample Help Message of my campaign.</HelpMessage>
416+
<OptinKeywords>START,YES</OptinKeywords>
417+
<OptinMessage>This is a sample Opt-In Message of my campaign.</OptinMessage>
418+
<OptoutKeywords>STOP,NO</OptoutKeywords>
419+
<OptoutMessage>This is a sample Opt-Out Message of my campaign.</OptoutMessage>
382420
<MnoMetadataList>
383421
<MnoMetadata>
384422
<MnoId>10035</MnoId>
@@ -493,6 +531,13 @@ Location: https://dashboard.bandwidth.com/api/accounts/{accountId}/campaignManag
493531
<SubscriberHelp>true</SubscriberHelp>
494532
<Sample1>test</Sample1>
495533
<AffiliateMarketing>false</AffiliateMarketing>
534+
<MessageFlow>This is a sample Message Flow of my campaign.</MessageFlow>
535+
<HelpKeywords>HELP</HelpKeywords>
536+
<HelpMessage>This is a sample Help Message of my campaign.</HelpMessage>
537+
<OptinKeywords>START,YES</OptinKeywords>
538+
<OptinMessage>This is a sample Opt-In Message of my campaign.</OptinMessage>
539+
<OptoutKeywords>STOP,NO</OptoutKeywords>
540+
<OptoutMessage>This is a sample Opt-Out Message of my campaign.</OptoutMessage>
496541
<MnoStatusList>
497542
<MnoStatus>
498543
<MnoName>ATT</MnoName>
@@ -530,6 +575,13 @@ Location: https://dashboard.bandwidth.com/api/accounts/{accountId}/campaignManag
530575
<Sample1>test</Sample1>
531576
<Sample2>test 15</Sample2>
532577
<AffiliateMarketing>false</AffiliateMarketing>
578+
<MessageFlow>This is a sample Message Flow of my campaign.</MessageFlow>
579+
<HelpKeywords>HELP</HelpKeywords>
580+
<HelpMessage>This is a sample Help Message of my campaign.</HelpMessage>
581+
<OptinKeywords>START, YES</OptinKeywords>
582+
<OptinMessage>This is a sample Opt-In Message of my campaign.</OptinMessage>
583+
<OptoutKeywords>STOP, NO</OptoutKeywords>
584+
<OptoutMessage>This is a sample Opt-Out Message of my campaign.</OptoutMessage>
533585
<MnoStatusList>
534586
<MnoStatus>
535587
<MnoName>ATT</MnoName>
@@ -613,6 +665,13 @@ Location: https://dashboard.bandwidth.com/api/accounts/{accountId}/campaignManag
613665
<SubscriberHelp>true</SubscriberHelp>
614666
<Sample1>test</Sample1>
615667
<AffiliateMarketing>false</AffiliateMarketing>
668+
<MessageFlow>This is a sample Message Flow of my campaign.</MessageFlow>
669+
<HelpKeywords>HELP</HelpKeywords>
670+
<HelpMessage>This is a sample Help Message of my campaign.</HelpMessage>
671+
<OptinKeywords>START,YES</OptinKeywords>
672+
<OptinMessage>This is a sample Opt-In Message of my campaign.</OptinMessage>
673+
<OptoutKeywords>STOP,NO</OptoutKeywords>
674+
<OptoutMessage>This is a sample Opt-Out Message of my campaign.</OptoutMessage>
616675
<MnoStatusList>
617676
<MnoStatus>
618677
<MnoName>ATT</MnoName>
@@ -649,6 +708,13 @@ Location: https://dashboard.bandwidth.com/api/accounts/{accountId}/campaignManag
649708
<SubscriberHelp>true</SubscriberHelp>
650709
<Sample1>test</Sample1>
651710
<AffiliateMarketing>false</AffiliateMarketing>
711+
<MessageFlow>This is a sample Message Flow of my campaign.</MessageFlow>
712+
<HelpKeywords>HELP</HelpKeywords>
713+
<HelpMessage>This is a sample Help Message of my campaign.</HelpMessage>
714+
<OptinKeywords>START,YES</OptinKeywords>
715+
<OptinMessage>This is a sample Opt-In Message of my campaign.</OptinMessage>
716+
<OptoutKeywords>STOP,NO</OptoutKeywords>
717+
<OptoutMessage>This is a sample Opt-Out Message of my campaign.</OptoutMessage>
652718
<MnoStatusList>
653719
<MnoStatus>
654720
<MnoName>ATT</MnoName>
@@ -842,4 +908,4 @@ There are many line options you can add to a TN. This section showed just how to
842908

843909
For more info on TNs, please see [Number Management](../../../../numbers).<br/>
844910

845-
---
911+
---

0 commit comments

Comments
 (0)