Skip to content

Commit 489a4dd

Browse files
committed
final commit
1 parent 0a595b5 commit 489a4dd

11 files changed

+142
-115
lines changed

articles/communication-services/quickstarts/sms/apply-for-short-code.md

Lines changed: 24 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Apply for a short code
33
titleSuffix: An Azure Communication Services quickstart
4-
description: Learn about how to apply for a short code.
4+
description: This article describes how to apply for a short code.
55
author: prakulka
66
manager: shahen
77
services: azure-communication-services
@@ -13,7 +13,8 @@ ms.service: azure-communication-services
1313
ms.subservice: sms
1414
ms.custom: mode-other
1515
---
16-
# Quickstart: Apply for a short code
16+
# Apply for a short code
17+
1718
[!INCLUDE [Short code eligibility notice](../../includes/public-preview-include-short-code-eligibility.md)]
1819

1920
## Prerequisites
@@ -22,18 +23,21 @@ ms.custom: mode-other
2223
- [An active Communication Services resource](../create-communication-resource.md).
2324

2425
## Get a short code
26+
2527
To begin provisioning a short code, go to your Communication Services resource on the [Azure portal](https://portal.azure.com).
2628

2729
:::image type="content" source="./media/apply-for-short-code/manage-phone-azure-portal-start1.png"alt-text="Screenshot showing a Communication Services resource's main page.":::
2830

2931
## Apply for a short code
32+
3033
Navigate to the **Short codes** panel in the resource menu and click **Get** to launch the short code program brief application wizard. For detailed guidance on how to fill out the program brief application, see the [program brief filling guidelines](../../concepts/sms/program-brief-guidelines.md). This quickstart covers the application for US short code.
3134

3235
For **UK short code**, fill out [UK short code application form](https://forms.office.com/r/VtfKFenZLF).
3336

3437
For **CA short code**, download and fill out [CA short code application form](https://www.txt.ca/wp-content/uploads/2022/10/DownloadShortcodeApplicationPdf_100522.pdf) and email the form to [[email protected]](mailto:[email protected]). Include **CA Short Code application** in subject line and details on subscription ID and Azure Communication Services resource ID in the body of the email.
3538

3639
## Short code prerequisites
40+
3741
The wizard on the **Short codes** panel presents a series of questions about the program and a description of content to be shared with the carriers for them to review and approve your short code program brief. Review the prerequisites tab for a list of the program content deliverables you need to attach with your application.
3842

3943
:::image type="content" source="./media/apply-for-short-code/prerequisites.png" alt-text="Screenshot showing prerequisites section.":::
@@ -42,12 +46,14 @@ The short code program brief registration requires details about your messaging
4246

4347
A short code program brief application consists of the following five sections:
4448

45-
### Program Details
49+
### Program Details
50+
4651
You first need to provide the program name and choose the country/region where you want to provision the phone number.
4752

4853
:::image type="content" source="./media/apply-for-short-code/program-details.png" alt-text="Screenshot showing program details section.":::
4954

5055
#### Select short code type
56+
5157
Configuring your short code is broken down into two steps:
5258
- Select a short code *type*
5359
- Select the short code *features*
@@ -60,23 +66,27 @@ After selecting a number type, you can then choose the message type and target d
6066
> Azure Communication Service supports multimedia messaging service (MMS) in private preview. Private preview includes access to SDKs and documentation for testing purposes that are not yet available publicly. Apply to become an early adopter by filling out the form for [preview access to Azure Communication Services](https://aka.ms/acs-tap-invite).
6167
6268
## Program content details
69+
6370
This section requires you to provide details about your program. These details include recurrence of the program, program call to action, type and description of program, privacy policy, and terms of the program.
6471

6572
:::image type="content" source="./media/apply-for-short-code/program-content-01.png" alt-text="Screenshot showing program content 1 section.":::
6673

6774
:::image type="content" source="./media/apply-for-short-code/program-content-02.png" alt-text="Screenshot showing program content 2 section.":::
6875

6976
### Contact Details
77+
7078
This section requires you to provide information about your company and customer care in the case that end users need help or support with the program.
7179

7280
:::image type="content" source="./media/apply-for-short-code/contact-details.png" alt-text="Screenshot showing contact details section.":::
7381

7482
### Volume Details
83+
7584
This section requires you to provide an estimate of the number of messages you plan to send per user per month and disclose any expected traffic spikes as part of the program.
7685

7786
:::image type="content" source="./media/apply-for-short-code/volume.png" alt-text="Screenshot showing volume details section.":::
7887

7988
### Template Information
89+
8090
This section captures sample messages related to opt-in, opt-out, and other message flows. This tab features a message samples view where you can review sample templates to help you create a template for your use case.
8191

8292
Azure communication service offers an opt-out management service for short codes that allows customers to configure responses to mandatory keywords STOP/START/HELP. Before provisioning your short code, you need to provide your preference to manage opt-outs. If you opt-in, the opt-out management service automatically uses your responses in the program brief for Opt-in/ Opt-out/ Help keywords in response to STOP/START/HELP keyword.
@@ -87,23 +97,28 @@ Azure communication service offers an opt-out management service for short codes
8797

8898
:::image type="content" source="./media/apply-for-short-code/templates-03.png" alt-text="Screenshot showing template 3 details section.":::
8999

90-
### Review
100+
### Review
101+
91102
Once completed, review the short code request details, fees, SMS laws and industry standards, and submit the completed application through the Azure portal.
92103

93104
:::image type="content" source="./media/apply-for-short-code/review.png" alt-text="Screenshot showing template details section.":::
94105

95106
The system automatically sends the program brief to the Azure Communication Services service desk for review. The service desk makes sure that the provided information is in the right format before sending it to all US mobile carriers for approval. The carriers then review the details of the short code program, a process that typically takes 8-12 weeks. Once carriers approve the program brief, you're notified via email. You can now start sending and receiving messages on this short code for your messaging programs.
96107

97108
## Troubleshooting
98-
#### Common questions and issues:
109+
110+
#### Common questions and issues
111+
99112
- **Purchasing short codes is supported in the US only. To purchase phone numbers, ensure that:**
100113
- The associated Azure subscription billing address is located in the United States. You can't move a resource to another subscription at this time.
101-
- Your Communication Services resource is provisioned in the United States data location. You can't move a resource to another data location at this time.
114+
- Your Communication Services resource is provisioned in the United States data location. You can't move a resource to another data location at this time.
115+
102116
- **Updating a short code application**
103117
- Once submitted, you can't edit, view, or cancel the short code application. If the Service desk team requires any updates to be made, you're notified via email and you're able to edit the application with the updates.
104-
- If you'd like a copy of your application or for any issues, [contact us](https://emails-ppe.azure.microsoft.com/redirect/?destination=https%3A%2F%2Fportal.azure.com%2F%23blade%2FMicrosoft_Azure_Support%2FHelpAndSupportBlade%2Foverview&p=bT0wMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDAmdT1hZW8tcHJldmlldyZsPXBvcnRhbC5henVyZS5jb20%3D).
105-
- **Cancelling a short code application**
106-
- Cancelling short code applications in the Azure portal isn't supported. If you'd like to cancel your application after submitting the program brief, [contact us](https://emails-ppe.azure.microsoft.com/redirect/?destination=https%3A%2F%2Fportal.azure.com%2F%23blade%2FMicrosoft_Azure_Support%2FHelpAndSupportBlade%2Foverview&p=bT0wMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDAmdT1hZW8tcHJldmlldyZsPXBvcnRhbC5henVyZS5jb20%3D)
118+
- If you'd like a copy of your application or for any issues, [contact us](https://emails-ppe.azure.microsoft.com/redirect/?destination=https%3A%2F%2Fportal.azure.com%2F%23blade%2FMicrosoft_Azure_Support%2FHelpAndSupportBlade%2Foverview&p=bT0wMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDAmdT1hZW8tcHJldmlldyZsPXBvcnRhbC5henVyZS5jb20%3D).
119+
120+
- **Cancel a short code application**
121+
- Azure portal doesn't support canceling a short code application. If you want to cancel your application after submitting the program brief, [contact us](https://emails-ppe.azure.microsoft.com/redirect/?destination=https%3A%2F%2Fportal.azure.com%2F%23blade%2FMicrosoft_Azure_Support%2FHelpAndSupportBlade%2Foverview&p=bT0wMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDAmdT1hZW8tcHJldmlldyZsPXBvcnRhbC5henVyZS5jb20%3D).
107122

108123
## Next steps
109124

articles/communication-services/quickstarts/sms/apply-for-ten-digit-long-code.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -123,7 +123,7 @@ Fill in the campaign and content attributes as follows:
123123
- **Subscriber Help**: Select **Yes** or **No** to indicate if subscriber help is available.
124124
- **Subscriber Help Answer**: If **Yes** is selected, provide the message for subscribers seeking assistance.
125125

126-
#### Additional attributes
126+
#### More attributes
127127

128128
- **Direct Lending or Loan Arrangement**: Indicate if the campaign involves any lending or loan arrangements.
129129
- **Embedded Link**: Select **Yes** or **No** to specify if the campaign includes an embedded link.
@@ -132,7 +132,7 @@ Fill in the campaign and content attributes as follows:
132132

133133
#### Terms and conditions
134134

135-
Affiliate marketing is not permitted on 10DLC numbers. Check the box to confirm that the campaign will not be used for Affiliate Marketing.
135+
Affiliate marketing isn't permitted on 10DLC numbers. Check the box to confirm that the campaign will not be used for Affiliate Marketing.
136136

137137
:::image type="content" source="./media/apply-for-brand-registration/campaign-registration-4.png" alt-text="Screenshot showing campaign registration form 4." lightbox="./media/apply-for-brand-registration/campaign-registration-4.png":::
138138

Lines changed: 24 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Apply for toll-free verification
3-
titleSuffix: An Azure Communication Services quickstart
4-
description: Learn about how to apply for toll-free verification
3+
titleSuffix: An Azure Communication Services article
4+
description: This article describes how to apply for toll-free verification.
55
author: prakulka
66
manager: sundraman
77
services: azure-communication-services
@@ -13,60 +13,72 @@ ms.service: azure-communication-services
1313
ms.subservice: sms
1414
ms.custom: mode-other
1515
---
16-
# Quickstart: Apply for toll-free verification
16+
17+
# Apply for toll-free verification
18+
1719
Get started with reliable SMS service using toll-free numbers by submitting a toll-free verification. Toll-free verification maximizes deliverability of messages with low to no traffic filtering.
1820

1921
## Prerequisites
20-
- [An active Communication Services resource.](../create-communication-resource.md)
21-
- [An SMS-enabled toll-free number](../telephony/get-phone-number.md)
22+
- [An active Communication Services resource.](../create-communication-resource.md).
23+
- [An SMS-enabled toll-free number](../telephony/get-phone-number.md).
2224

2325
### What is toll free verification?
24-
The toll-free verification process ensures that your services running on toll-free numbers (TFNs) comply with carrier policies and [industry best practices](../../concepts/sms/messaging-policy.md). This also provides relevant service information to the downstream carriers, reduces the likelihood of false positive filtering and wrongful spam blocks. For detailed process and timelines toll-free verification process check the [toll-free verification FAQ](../../concepts/sms/sms-faq.md#toll-free-verification).
26+
27+
The toll-free verification process ensures that your services running on toll-free numbers (TFNs) comply with carrier policies and [industry best practices](../../concepts/sms/messaging-policy.md). Toll-free verification also provides relevant service information to the downstream carriers, reduces the likelihood of false positive filtering and wrongful spam blocks. For detailed process and timelines toll-free verification process, see the [toll-free verification FAQ](../../concepts/sms/sms-faq.md#toll-free-verification).
2528

2629
Verification is **required** for best SMS delivery experience.
2730

2831
## Submit a toll-free verification
32+
2933
To begin toll-free verification, go to your Communication Services resource on the [Azure portal](https://portal.azure.com).
3034

3135
:::image type="content" source="./media/apply-for-toll-free-verification/manage-phone-azure-portal-start-1.png"alt-text="Screenshot showing a Communication Services resource's main page.":::
3236

3337
## Apply for a toll-free verification
34-
Navigate to the Regulatory Documents blade in the resource menu and click on "Add" button to launch the toll-free verification application wizard. For detailed guidance on how to fill out the program brief application check the [toll-free verification filling guidelines](../../concepts/sms/toll-free-verification-guidelines.md).
38+
39+
Navigate to the Regulatory Documents blade in the resource menu and click **Add** to launch the toll-free verification application wizard. For detailed guidance on how to fill out the program brief application, see [toll-free verification filling guidelines](../../concepts/sms/toll-free-verification-guidelines.md).
3540

3641
:::image type="content" source="./media/apply-for-toll-free-verification/regulatory-screen-1.png" alt-text="Screenshot showing Regulatory Documents Blade.":::
3742

3843
A toll-free verification application consists of the following five sections:
44+
3945
### Application type
40-
You first need to choose country/region and toll-free numbers you would like to get verified. If you have not acquired a toll-free number, then you need to first acquire the number and then come back to this application. If you have selected more than one toll-free number to verify, you need to provide justification on how the multiple numbers are used for the campaign.
46+
47+
You first need to choose country/region and toll-free numbers you would like to get verified. If you need a toll-free number, then you must first acquire the number and then come back to this application. If you selected more than one toll-free number to verify, you need to provide justification on how the multiple numbers are used for the campaign.
4148

4249
:::image type="content" source="./media/apply-for-toll-free-verification/regulatory-screen-2.png" alt-text="Screenshot showing Application type section." lightbox="./media/apply-for-toll-free-verification/regulatory-screen-2.png":::
4350

4451
### Contact details
52+
4553
This section requires you to provide information about your company and point of contact in the case we need additional information for this application.
4654

4755
:::image type="content" source="./media/apply-for-toll-free-verification/regulatory-screen-3.png" alt-text="Screenshot showing contact details section." lightbox="./media/apply-for-toll-free-verification/regulatory-screen-3.png":::
4856

4957
### Program content
58+
5059
This section requires you to provide description of the SMS campaign, opt-in method (how you plan to get consent from the customer to receive SMS), and screenshots of the selected opt-in method.
5160

5261
:::image type="content" source="./media/apply-for-toll-free-verification/regulatory-screen-4.png" alt-text="Screenshot showing Program content section." lightbox="./media/apply-for-toll-free-verification/regulatory-screen-4.png":::
5362

5463
### Volume details
64+
5565
This section requires you to provide an estimate of the number of messages you plan on sending per month.
5666

5767
:::image type="content" source="./media/apply-for-toll-free-verification/regulatory-screen-5.png" alt-text="Screenshot showing Volume details section." lightbox="./media/apply-for-toll-free-verification/regulatory-screen-5.png":::
5868

5969
### Template information
60-
This section captures sample messages related to your campaign. Provide samples of each type of message you are sending out to recipients.
70+
71+
This section captures sample messages related to your campaign. Provide samples of each type of message you send out to recipients.
6172

6273
:::image type="content" source="./media/apply-for-toll-free-verification/regulatory-screen-6.png" alt-text="Screenshot showing Template details section." lightbox="./media/apply-for-toll-free-verification/regulatory-screen-6.png":::
6374

64-
### Review
75+
### Review
76+
6577
Once completed, review the toll-free verification details and submit the completed application through the Azure portal.
6678

6779
:::image type="content" source="./media/apply-for-toll-free-verification/regulatory-screen-7.png" alt-text="Screenshot showing review section." lightbox="./media/apply-for-toll-free-verification/regulatory-screen-7.png":::
6880

69-
This program brief is automatically sent to the toll-free messaging aggregator for review. The toll-free aggregator then reviews the details of the toll-free verification application, a process that can typically take between 5-6 weeks. Once they approve the application, you are notified via application status change in the Azure portal. You can now start sending and receiving messages with low filtering on this toll-free number for your messaging programs.
81+
This program brief is automatically sent to the toll-free messaging aggregator for review. The toll-free aggregator then reviews the details of the toll-free verification application, a process that can typically take between five to six weeks. Once they approve the application, you receive notification via application status change in the Azure portal. You can now start sending and receiving messages with low filtering on this toll-free number for your messaging programs.
7082

7183
## Next steps
7284

@@ -76,7 +88,7 @@ This program brief is automatically sent to the toll-free messaging aggregator f
7688
> [!div class="nextstepaction"]
7789
> [Send an SMS](../sms/send.md)
7890
79-
The following documents may be interesting to you:
91+
## Related articles
8092

8193
- Familiarize yourself with the [SMS SDK](../../concepts/sms/sdk-features.md)
8294
- Familiarize yourself with the [SMS FAQ](../../concepts/sms/sms-faq.md)

0 commit comments

Comments
 (0)