Skip to content

Commit 01a56f4

Browse files
authored
Merge pull request #275907 from vac0224/vc-short-code-2024-05-21
Review and edit
2 parents f006789 + 8c971ab commit 01a56f4

File tree

2 files changed

+25
-25
lines changed

2 files changed

+25
-25
lines changed
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
> [!IMPORTANT]
2-
> Short Code availability is currently restricted to Azure enterprise subscriptions that have a billing address in the United States and Communication Services resources that have a US data location.
2+
> Short code availability is currently restricted to Azure enterprise subscriptions that have a billing address in the United States and Communication Services resources that have a US data location.
33
> Short code cannot be acquired on trial accounts or using Azure free credits. For more information, visit the [subscription eligibility](../concepts/numbers/sub-eligibility-number-capability.md) page.
Lines changed: 24 additions & 24 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: Learn about how to apply for a short code.
55
author: prakulka
66
manager: shahen
77
services: azure-communication-services
@@ -27,40 +27,40 @@ To begin provisioning a short code, go to your Communication Services resource o
2727
:::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.":::
2828

2929
## Apply for a short code
30-
Navigate to the Short Codes blade in the resource menu and click on "Get" button to launch the short code program brief application wizard. For detailed guidance on how to fill out the program brief application check the [program brief filling guidelines](../../concepts/sms/program-brief-guidelines.md). This quickstart covers the application for US short code.
30+
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.
3131

32-
For **UK short code**, fill out [UK short code application form](https://forms.office.com/r/VtfKFenZLF).
32+
For **UK short code**, fill out [UK short code application form](https://forms.office.com/r/VtfKFenZLF).
3333

34-
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]*. 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.
34+
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.
3535

36-
## Pre-requisites
37-
The wizard on the short codes blade will walk you through a series of questions about the program as well as a description of content which will be shared with the carriers for them to review and approve your short code program brief. Review the pre-requisites tab for a list of the program content deliverables you'll need to attach with your application.
36+
## Short code prerequisites
37+
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.
3838

39-
:::image type="content" source="./media/apply-for-short-code/prerequisites.png" alt-text="Screenshot showing pre-requisites section.":::
39+
:::image type="content" source="./media/apply-for-short-code/prerequisites.png" alt-text="Screenshot showing prerequisites section.":::
4040

41-
The Short Code Program Brief registration requires details about your messaging program, including the user experience (for example., call to action, opt-in, opt-out, and message flows) and information about your company. This information helps mobile carriers ensure that your program meets the CTIA (Cellular Telecommunications Industry Association) guidelines and regulatory requirements.
41+
The short code program brief registration requires details about your messaging program, including the user experience (for example, call to action, opt-in, opt-out, and message flows) and information about your company. This information helps mobile carriers ensure that your program meets the CTIA (Cellular Telecommunications Industry Association) guidelines and regulatory requirements.
4242

43-
A short code Program Brief application consists of the following five sections:
43+
A short code program brief application consists of the following five sections:
4444

4545
### Program Details
46-
You'll first need to provide the program name and choose the country/region where you would like to provision the phone number.
46+
You first need to provide the program name and choose the country/region where you want to provision the phone number.
4747

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

5050
#### Select short code type
5151
Configuring your short code is broken down into two steps:
52-
- The selection of short code type
53-
- The selection of the short code features
52+
- Select a short code *type*
53+
- Select the short code *features*
5454

55-
You can select from two short code types: Random, and Vanity. If you select a random short code, you'll get a short code that is randomly selected by the U.S. Common Short Codes Association (CSCA). If you select a vanity short code, you are required to input a prioritized list of vanity short codes that you’d like to use for your program. The alternatives in the list will be used if the first short code in your list isn't available to lease. Example: 234567, 234578, 234589. You can look up the list of available short codes in the [US Short Codes Directory](https://usshortcodedirectory.com/).
55+
You can select from two short code types: *random* or *vanity*. If you select a *random* short code, you get a short code randomly selected by the U.S. Common Short Codes Association (CSCA). If you select a *vanity* short code, you're required to provide a prioritized list of vanity short codes that you want to use for your program. If the first short code in your list isn't available to lease, the CSCA chooses an alternative from the list. For example: 234567, 234578, 234589. You can search the list of available short codes in the [US Short Codes Directory](https://usshortcodedirectory.com/).
5656

57-
When you’ve selected a number type, you can then choose the message type, and target date. Short code registration with carriers usually takes 8-12 weeks, so this target date should be selected considering this registration period.
57+
After selecting a number type, you can then choose the message type and target date. Short code registration with carriers usually takes 8-12 weeks, so select a target date based on the registration period.
5858

5959
> [!Note]
60-
> Azure Communication Service currently only supports SMS. Check [roadmap](https://github.com/Azure/Communication/blob/master/roadmap.md) for MMS launch.
60+
> 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).
6161
6262
## Program content details
63-
This section requires you to provide details about your program such as recurrence of the program, program call to action, type and description of program, privacy policy, and terms of the program.
63+
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.
6464

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

@@ -72,14 +72,14 @@ This section requires you to provide information about your company and customer
7272
:::image type="content" source="./media/apply-for-short-code/contact-details.png" alt-text="Screenshot showing contact details section.":::
7373

7474
### Volume Details
75-
This section requires you to provide an estimate of the number of messages you plan on sending per user per month and disclose any expected traffic spikes as part of the program.
75+
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.
7676

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

7979
### Template Information
8080
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.
8181

82-
Azure communication service offers an opt-out management service for short codes that allows customers to configure responses to mandatory keywords STOP/START/HELP. Prior to provisioning your short code, you'll be asked for your preference to manage opt-outs. If you opt-in, the opt-out management service will automatically use your responses in the program brief for Opt-in/ Opt-out/ Help keywords in response to STOP/START/HELP keyword.
82+
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.
8383

8484
:::image type="content" source="./media/apply-for-short-code/templates-01.png" alt-text="Screenshot showing template 1 details section.":::
8585

@@ -88,28 +88,28 @@ Azure communication service offers an opt-out management service for short codes
8888
:::image type="content" source="./media/apply-for-short-code/templates-03.png" alt-text="Screenshot showing template 3 details section.":::
8989

9090
### Review
91-
Once completed, review the short code request details, fees, SMS laws and industry standards and submit the completed application through the Azure portal.
91+
Once completed, review the short code request details, fees, SMS laws and industry standards, and submit the completed application through the Azure portal.
9292

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

95-
This program brief will now be automatically sent to the Azure Communication Services service desk for review. The service desk specifically is looking to ensure that the provided information is in the right format before sending to all US mobile carriers for approval. The carriers will then review the details of the short code program, a process that can typically take between 8-12 weeks. Once carriers approve the program brief, you'll be notified via email. You can now start sending and receiving messages on this short code for your messaging programs.
95+
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.
9696

9797
## Troubleshooting
9898
#### Common questions and issues:
9999
- **Purchasing short codes is supported in the US only. To purchase phone numbers, ensure that:**
100100
- The associated Azure subscription billing address is located in the United States. You can't move a resource to another subscription at this time.
101101
- 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.
102102
- **Updating a short code application**
103-
- 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'll be notified via email and you'll be able to edit the application with the updates.
103+
- 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.
104104
- 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).
105105
- **Cancelling a short code application**
106-
- Cancelling short code applications in the Azure portal is not 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)
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)
107107

108108
## Next steps
109109

110110
> [!div class="nextstepaction"]
111111
> [Check guidelines for filling a short code program brief application](../../concepts/sms/program-brief-guidelines.md)
112112
113-
The following documents may be interesting to you:
113+
## Related articles
114114

115-
- Familiarize yourself with the [SMS SDK](../../concepts/sms/sdk-features.md)
115+
- Familiarize yourself with the [SMS SDK](../../concepts/sms/sdk-features.md).

0 commit comments

Comments
 (0)