Skip to content

Commit 0704a75

Browse files
authored
Revert "Revert "[Ship Room] Release build 2022 azure communication services""
1 parent 7176629 commit 0704a75

File tree

8 files changed

+209
-47
lines changed

8 files changed

+209
-47
lines changed

articles/communication-services/concepts/includes/sms-tollfree-pricing.md

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.custom: include file
1313
ms.author: prakulka
1414
---
1515
>[!Important]
16-
>Toll-free availability is currently restricted to Azure subscriptions that have a billing address in the United States.
16+
>In most cases, customers with Azure subscriptions locations that match the country of the Number offer will be able to buy the Number. However, US and Canada numbers may be purchased by customers with Azure subscription locations in other countries. Please see [here](../numbers/sub-eligibility-number-capability.md) for details on in-country and cross-country purchases.
1717
1818
The Toll-free SMS service requires provisioning a toll-free number through the Azure portal. Once a toll-free number is provisioned, pay-as-you-go pricing applies to the leasing fee, and the usage fee. The leasing fee, and the usage fee is determined by the short code type, location of the short code, and the destination.
1919

@@ -22,21 +22,29 @@ The Toll-free SMS service requires provisioning a toll-free number through the A
2222
### Leasing Fee
2323
Fees for toll-free leasing are charged after provisioning and then recur on a month-to-month basis:
2424

25-
|Number type |Monthly fee |
26-
|--------------|-----------|
27-
|Toll-free (United States) |$2/mo|
25+
|Country |Number type |Monthly fee|
26+
|--------|-----------|------------|
27+
|United States|Toll-free |$2/mo|
28+
|Canada| Toll-free |$2/mo|
2829

2930
### Usage Fee
30-
SMS offers pay-as-you-go pricing. The price is a per-message segment charge based on the destination of the message. Messages can be sent by toll-free phone numbers to phone numbers located within the United States.
31+
SMS offers pay-as-you-go pricing. The price is a per-message segment* charge based on the destination of the message. Messages can be sent by toll-free phone numbers to phone numbers located within the United States, Canada, and Puerto Rico.
3132

3233
The following prices include required communications taxes and fees:
3334

34-
|Message Type |Usage Fee |
35-
|-----------|------------|
36-
|Send messages (per message segment*) |$0.0075 |
37-
|Receive messages (per message segment*) |$0.0075 |
35+
|Country| Send Message | Receive Message|
36+
|-----------|---------|--------------|
37+
|United States| $0.0075 | $0.0075|
38+
|Canada | $0.0075 | $0.0075|
3839

3940
*Please see our guide on [SMS character limits](../sms/sms-faq.md#what-is-the-sms-character-limit) to learn more about message segments.
4041

4142
## Carrier surcharge
42-
A standard carrier surcharge of $0.0025/sent message segment and $0.0010/received message segment is also applicable. A carrier surcharge is subject to change. See our guide on [Carrier surcharges](https://github.com/Azure/Communication/blob/master/sms-carrier-surcharge.md) for details.
43+
A standard carrier surcharge is applicable to messages exchanged via toll-free numbers. A carrier surcharge is a per-message segment* charge and is subject to change. Carrier surcharge is calculated based on the destination of the message for sent messages and based on the sender of the message for received messages. See our guide on [Carrier surcharges](https://github.com/Azure/Communication/blob/master/sms-carrier-surcharge.md) for details. See our pricing example [here](../pricing.md#pricing-example-11-sms-sending) to see how SMS prices are calculated.
44+
45+
|Country| Send Message | Receive Message|
46+
|-----------|---------|--------------|
47+
|United States| $0.0025 | $0.0010|
48+
|Canada | $0.0085 | NA|
49+
50+
*Please see our guide on [SMS character limits](../sms/sms-faq.md#what-is-the-sms-character-limit) to learn more about message segments.

articles/communication-services/concepts/numbers/number-types.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,8 @@ Azure Communication Services allows you to use phone numbers to make voice calls
1818

1919
## Available options
2020

21+
[!INCLUDE [Regional Availability Notice](../../includes/regional-availability-include.md)]
22+
2123
Azure Communication Services offers three types of Numbers: Toll-Free, Local, and Short Codes.
2224

2325
- **To send or receive an SMS**, choose a Toll-Free Number or a Short Code
@@ -27,7 +29,7 @@ The table below summarizes these number types with supported capabilities:
2729

2830
| Type | Example | Send SMS | Receive SMS | Make Calls | Receive Calls | Typical Use Case | Restrictions |
2931
| :-------------------------------------------------------------------- | :---------------- | :------: | :---------: | :--------: | :-----------: | :------------------------------------------- | :------------- |
30-
| [Toll-Free](../../quickstarts/telephony/get-phone-number.md) | +1 (8AB) XYZ PQRS | Yes | Yes | Yes | Yes | Receive calls on IVR bots, SMS Notifications | SMS in US only |
32+
| [Toll-Free](../../quickstarts/telephony/get-phone-number.md) | +1 (8AB) XYZ PQRS | Yes | Yes | Yes | Yes | Receive calls on IVR bots, SMS Notifications | SMS in US and CA only |
3133
| [Local (Geographic)](../../quickstarts/telephony/get-phone-number.md) | +1 (ABC) XYZ PQRS | No | No | Yes | Yes | Geography Specific Number | Calling Only |
3234
| [Short-Codes](../../quickstarts/sms/apply-for-short-code.md) | ABC-XYZ | Yes | Yes | No | No | High-velocity SMS | SMS only |
3335

articles/communication-services/concepts/numbers/sub-eligibility-number-capability.md

Lines changed: 72 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ ms.author: sadas
1010
ms.date: 03/04/2022
1111
ms.topic: conceptual
1212
ms.service: azure-communication-services
13+
ms.custom: references_regions
1314
---
1415

1516
# Subscription eligibility and number capabilities
@@ -22,10 +23,12 @@ To acquire a phone number, you need to be on a paid Azure subscription. Phone nu
2223

2324
Additional details on eligible subscription types are as follows:
2425

25-
| Number Type | Eligible Azure Agreement Type |
26-
| :------------------------------- | :------------------------------------------------------------------------------------------------------- |
27-
| Toll-Free and Local (Geographic) | Modern Customer Agreement (Field and Customer Led), Modern Partner Agreement (CSP), Enterprise Agreement |
28-
| Short-Codes | Modern Customer Agreement (Field Led) and Enterprise Agreement Only |
26+
| Number Type | Eligible Azure Agreement Type |
27+
| :------------------------------- | :-------------------------------------------------------------------------------------------------------- |
28+
| Toll-Free and Local (Geographic) | Modern Customer Agreement (Field and Customer Led), Modern Partner Agreement (CSP), Enterprise Agreement* |
29+
| Short-Codes | Modern Customer Agreement (Field Led) and Enterprise Agreement Only |
30+
31+
\* Allowing the purchase of Italian phone numbers for CSP and LSP customers is planned only for General Availability launch.
2932

3033
## Number capabilities
3134

@@ -38,39 +41,90 @@ The tables below summarize current availability:
3841
| Number | Type | Send SMS | Receive SMS | Make Calls | Receive Calls |
3942
| :---------------- | :---------- | :------------------- | :------------------- | :------------------- | :--------------------- |
4043
| USA & Puerto Rico | Toll-Free | General Availability | General Availability | General Availability | General Availability\* |
41-
| USA & Puerto Rico | Local | Not Available | Not Available | General Availability | General Availability\* |
42-
| USA | Short-Codes | Public Preview | Public Preview\* | Not Available | Not Available |
44+
| USA & Puerto Rico | Local | - | - | General Availability | General Availability\* |
45+
| USA | Short-Codes | Public Preview | Public Preview\* | - | - |
4346

4447
\* Available through Azure Bot Framework and Dynamics only
4548

4649
## Customers with UK Azure billing addresses
4750

51+
| Number | Type | Send SMS | Receive SMS | Make Calls | Receive Calls |
52+
| :----------------- | :------------- | :------------------- | :------------------- | :--------------- | :--------------- |
53+
| UK | Toll-Free | - | - | Public Preview | Public Preview\* |
54+
| UK | Local | - | - | Public Preview | Public Preview\* |
55+
| USA & Puerto Rico | Toll-Free | General Availability | General Availability | Public Preview | Public Preview\* |
56+
| USA & Puerto Rico | Local | - | - | Public Preview | Public Preview\* |
57+
| Canada | Toll-Free | Public Preview | Public Preview | Public Preview | Public Preview\* |
58+
| Canada | Local | - | - | Public Preview | Public Preview\* |
59+
60+
\* Available through Azure Bot Framework and Dynamics only
61+
62+
## Customers with Ireland Azure billing addresses
63+
64+
| Number | Type | Send SMS | Receive SMS | Make Calls | Receive Calls |
65+
| :---------------- | :-------- | :------------------- | :------------------- | :------------------- | :--------------- |
66+
| Ireland | Toll-Free | - | - | Public Preview | Public Preview\* |
67+
| Ireland | Local | - | - | Public Preview | Public Preview\* |
68+
| USA & Puerto Rico | Toll-Free | General Availability | General Availability | Public Preview | Public Preview\* |
69+
| USA & Puerto Rico | Local | - | - | Public Preview | Public Preview\* |
70+
| Canada | Toll-Free | Public Preview | Public Preview | Public Preview | Public Preview\* |
71+
| Canada | Local | - | - | Public Preview | Public Preview\* |
72+
| UK | Toll-Free | - | - | Public Preview | Public Preview\* |
73+
| UK | Local | - | - | Public Preview | Public Preview\* |
74+
75+
76+
\* Available through Azure Bot Framework and Dynamics only
77+
78+
## Customers with Denmark Azure billing addresses
79+
4880
| Number | Type | Send SMS | Receive SMS | Make Calls | Receive Calls |
4981
| :---------------- | :-------- | :------------------- | :------------------- | :------------- | :--------------- |
50-
| UK | Toll-Free | Not Available | Not Available | Public Preview | Public Preview\* |
51-
| UK | Local | Not Available | Not Available | Public Preview | Public Preview\* |
82+
| Denmark | Toll-Free | - | - | Public Preview | Public Preview\* |
83+
| Denmark | Local | - | - | Public Preview | Public Preview\* |
5284
| USA & Puerto Rico | Toll-Free | General Availability | General Availability | Public Preview | Public Preview\* |
53-
| USA & Puerto Rico | Local | Not Available | Not Available | Public Preview | Public Preview\* |
85+
| USA & Puerto Rico | Local | - | - | Public Preview | Public Preview\* |
86+
| Canada | Toll-Free | Public Preview | Public Preview | Public Preview | Public Preview\* |
87+
| Canada | Local | - | - | Public Preview | Public Preview\* |
88+
| UK | Toll-Free | - | - | Public Preview | Public Preview\* |
89+
| UK | Local | - | - | Public Preview | Public Preview\* |
5490

5591
\* Available through Azure Bot Framework and Dynamics only
5692

57-
## Customers with Ireland Azure billing addresses
93+
## Customers with Canada Azure billing addresses
94+
95+
| Number | Type | Send SMS | Receive SMS | Make Calls | Receive Calls |
96+
| :---------------- | :-------- | :------------------- | :------------------- | :------------- | :--------------- |
97+
| Canada | Toll-Free | Public Preview | Public Preview | Public Preview | Public Preview\* |
98+
| Canada | Local | - | - | Public Preview | Public Preview\* |
99+
| USA & Puerto Rico | Toll-Free | General Availability | General Availability | Public Preview | Public Preview\* |
100+
| USA & Puerto Rico | Local | - | - | Public Preview | Public Preview\* |
101+
| UK | Toll-Free | - | - | Public Preview | Public Preview\* |
102+
| UK | Local | - | - | Public Preview | Public Preview\* |
58103

59-
| Number | Type | Send SMS | Receive SMS | Make Calls | Receive Calls |
60-
| :---------------- | :-------- | :------------------- | :------------------- | :------------------- | :--------------------- |
61-
| USA & Puerto Rico | Toll-Free | General Availability | General Availability | General Availability | General Availability\* |
62-
| USA & Puerto Rico | Local | Not Available | Not Available | General Availability | General Availability\* |
63104

64105
\* Available through Azure Bot Framework and Dynamics only
65106

66-
## Customers with Denmark Azure Billing Addresses
107+
## Customers with Italy Azure billing addresses
67108

68109
| Number | Type | Send SMS | Receive SMS | Make Calls | Receive Calls |
69110
| :------ | :-------- | :------------ | :------------ | :------------- | :--------------- |
70-
| Denmark | Toll-Free | Not Available | Not Available | Public Preview | Public Preview\* |
71-
| Denmark | Local | Not Available | Not Available | Public Preview | Public Preview\* |
111+
| Italy | Toll-Free** | - | - | Public Preview | Public Preview\* |
112+
| Italy | Local** | - | - | Public Preview | Public Preview\* |
113+
114+
\* Available through Azure Bot Framework and Dynamics only
115+
116+
\** Allowing the purchase of Italian phone numbers for CSP and LSP customers is planned only for General Availability launch.
117+
118+
## Customers with Sweden Azure billing addresses
119+
120+
| Number | Type | Send SMS | Receive SMS | Make Calls | Receive Calls |
121+
| :---------------- | :-------- | :------------------- | :------------------- | :------------- | :--------------- |
122+
| Sweden | Toll-Free | - | - | Public Preview | Public Preview\* |
123+
| Sweden | Local | - | - | Public Preview | Public Preview\* |
124+
| Canada | Toll-Free | Public Preview | Public Preview | Public Preview | Public Preview\* |
125+
| Canada | Local | - | - | Public Preview | Public Preview\* |
72126
| USA & Puerto Rico | Toll-Free | General Availability | General Availability | Public Preview | Public Preview\* |
73-
| USA & Puerto Rico | Local | Not Available | Not Available | Public Preview | Public Preview\* |
127+
| USA & Puerto Rico | Local | - | - | Public Preview | Public Preview\* |
74128

75129
\* Available through Azure Bot Framework and Dynamics only
76130

articles/communication-services/concepts/pricing.md

Lines changed: 38 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -190,13 +190,47 @@ Rose sees the messages and starts chatting. In the meanwhile Casey gets a call a
190190
- Number of messages sent (20 + 30 + 18 + 30 + 25 + 35) x $0.0008 = $0.1264
191191

192192

193-
## SMS (Short Messaging Service) and Telephony
193+
## SMS (Short Messaging Service)
194194

195-
Please refer to the following links for details on SMS and Telephony pricing
195+
Azure Communication Services allows for adding SMS messaging capabilities to your applications. You can embed the experience into your applications using JavaScript, Java, Python, or .NET SDKs. Refer to our [full list of available SDKs](./sdk-options.md).
196196

197-
- [SMS Pricing Details](./sms-pricing.md)
198-
- [PSTN Pricing Details](./pstn-pricing.md)
197+
### Pricing
198+
199+
The SMS usage price is a per-message segment charge based on the destination of the message. The carrier surcharge is calculated based on the destination of the message for sent messages and based on the sender of the message for received messages. Please refer to the [SMS Pricing Page](./sms-pricing.md) for pricing details.
200+
201+
### Pricing example: 1:1 SMS sending
202+
203+
Contoso is a healthcare company with clinics in US and Canada. Contoso has a Patient Appointment Reminder application that sends out SMS appointment reminders to patients regarding upcoming appointments.
204+
205+
- The application sends appointment reminders to 20 US patients and 30 Canada patients using a US toll-free number.
206+
- Message length of the reminder message is 150 chars < 1 message segment*. Hence, total sent messages are 20 message segments for US and 30 message segments for CA.
207+
208+
**Cost calculations**
209+
210+
- US - 20 message segments x $0.0075 per sent message segment + 20 message segments x $0.0025 carrier surcharge per sent message segment = $0.20
211+
- CA - 30 message segments x $0.0075 per sent message segment + 30 message segments x $0.0085 carrier surcharge per sent message segment = $0.48
212+
213+
**Total cost for the appointment reminders for 20 US patients and 30 CA patients**: $0.20 + $0.48 = $0.68
199214

215+
### Pricing example: 1:1 SMS receiving
216+
217+
Contoso is a healthcare company with clinics in US and Canada. Contoso has a Patient Appointment Reminder application that sends out SMS appointment reminders to patients regarding upcoming appointments. Patients can respond to the messages with "Reschedule" and include their date/time preference to reschedule their appointments.
218+
219+
- The application sends appointment reminders to 20 US patients and 30 Canada patients using a CA toll-free number.
220+
- 6 US patients and 4 CA patients respond back to reschedule their appointments. Contoso receives 10 SMS responses in total.
221+
- Message length of the reschedule messages is less than 1 message segment*. Hence, total messages received are 6 message segments for US and 4 message segments for CA.
222+
223+
**Cost calculations**
224+
225+
- US - 6 message segments x $0.0075 per received message segment + 6 message segments x $0.0010 carrier surcharge per received message segment = $0.051
226+
- CA - 4 message segments x $0.0075 per received message segment = $0.03
227+
228+
**Total cost for receiving patient responses from 6 US patients and 4 CA patients**: $0.051 + $0.03 = $0.081
229+
230+
## Telephony
231+
Please refer to the following links for details on Telephony pricing
232+
233+
- [PSTN Pricing Details](./pstn-pricing.md)
200234

201235
## Next Steps
202236
Get started with Azure Communication Services:

0 commit comments

Comments
 (0)