You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
> 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.
3
3
> 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.
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.
5
5
author: prakulka
6
6
manager: shahen
7
7
services: azure-communication-services
@@ -27,40 +27,40 @@ To begin provisioning a short code, go to your Communication Services resource o
27
27
:::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.":::
28
28
29
29
## 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.
31
31
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).
33
33
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.
35
35
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.
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.
42
42
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:
44
44
45
45
### 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.
47
47
48
48
:::image type="content" source="./media/apply-for-short-code/program-details.png" alt-text="Screenshot showing program details section.":::
49
49
50
50
#### Select short code type
51
51
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*
54
54
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/).
56
56
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.
58
58
59
59
> [!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).
61
61
62
62
## 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.
64
64
65
65
:::image type="content" source="./media/apply-for-short-code/program-content-01.png" alt-text="Screenshot showing program content 1 section.":::
66
66
@@ -72,14 +72,14 @@ This section requires you to provide information about your company and customer
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.
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.
81
81
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.
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.
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.
96
96
97
97
## Troubleshooting
98
98
#### Common questions and issues:
99
99
-**Purchasing short codes is supported in the US only. To purchase phone numbers, ensure that:**
100
100
- 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
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.
102
102
-**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.
104
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
105
-**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)
107
107
108
108
## Next steps
109
109
110
110
> [!div class="nextstepaction"]
111
111
> [Check guidelines for filling a short code program brief application](../../concepts/sms/program-brief-guidelines.md)
112
112
113
-
The following documents may be interesting to you:
113
+
## Related articles
114
114
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