Merge pull request #199207 from MicrosoftDocs/revert-198977-revert-198050-master

Revert 198977 revert 198050 master

Author: SyntaxC4

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

@@ -13,7 +13,7 @@ ms.custom: include file
 ms.author: prakulka
 ---
 >[!Important] 
->Toll-free availability is currently restricted to Azure subscriptions that have a billing address in the United States.
+>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.
 
 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.
 
@@ -22,21 +22,29 @@ The Toll-free SMS service requires provisioning a toll-free number through the A
 ### Leasing Fee
 Fees for toll-free leasing are charged after provisioning and then recur on a month-to-month basis:
 
-|Number type   |Monthly fee |
-|--------------|-----------|
-|Toll-free (United States) |$2/mo|
+|Country |Number type |Monthly fee|
+|--------|-----------|------------|
+|United States|Toll-free  |$2/mo|
+|Canada| Toll-free |$2/mo|
 
 ### Usage Fee
-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.
+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.
 
 The following prices include required communications taxes and fees:
 
-|Message Type   |Usage Fee |
-|-----------|------------|
-|Send messages (per message segment*) |$0.0075 |
-|Receive messages (per message segment*) |$0.0075 |
+|Country| Send Message | Receive Message|
+|-----------|---------|--------------|
+|United States| $0.0075 | $0.0075|
+|Canada | $0.0075 | $0.0075|
 
 *Please see our guide on [SMS character limits](../sms/sms-faq.md#what-is-the-sms-character-limit) to learn more about message segments.
 
 ## Carrier surcharge
-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.
+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.
+
+|Country| Send Message | Receive Message|
+|-----------|---------|--------------|
+|United States| $0.0025 | $0.0010|
+|Canada | $0.0085 | NA|
+
+*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/pricing.md

@@ -190,13 +190,47 @@ Rose sees the messages and starts chatting. In the meanwhile Casey gets a call a
 - Number of messages sent (20 + 30 + 18 + 30 + 25 + 35) x $0.0008 = $0.1264
 
 
-## SMS (Short Messaging Service) and Telephony
+## SMS (Short Messaging Service)
 
-Please refer to the following links for details on SMS and Telephony pricing
+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).
 
-- [SMS Pricing Details](./sms-pricing.md)
-- [PSTN Pricing Details](./pstn-pricing.md)
+### Pricing
+
+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. 
+
+### Pricing example: 1:1 SMS sending
+
+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. 
+
+- The application sends appointment reminders to 20 US patients and 30 Canada patients using a US toll-free number.
+- 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.
+
+**Cost calculations**
+
+- 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
+- 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
+
+**Total cost for the appointment reminders for 20 US patients and 30 CA patients**: $0.20 + $0.48 = $0.68
 
+### Pricing example: 1:1 SMS receiving
+
+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.
+
+- The application sends appointment reminders to 20 US patients and 30 Canada patients using a CA toll-free number.
+- 6 US patients and 4 CA patients respond back to reschedule their appointments. Contoso receives 10 SMS responses in total.
+- 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.
+
+**Cost calculations**
+
+- 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
+- CA - 4 message segments x $0.0075 per received message segment = $0.03
+
+**Total cost for receiving patient responses from 6 US patients and 4 CA patients**: $0.051 + $0.03 = $0.081
+
+## Telephony
+Please refer to the following links for details on Telephony pricing
+
+- [PSTN Pricing Details](./pstn-pricing.md)
 
 ## Next Steps
 Get started with Azure Communication Services:

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

@@ -12,7 +12,7 @@ zone_pivot_groups: acs-tollfree-shortcode
 # SMS Pricing 
 
 > [!IMPORTANT]
-> SMS messages can be sent to and received from United States phone numbers. Phone numbers located in other geographies are not yet supported by Communication Services SMS.
+> SMS messages can be sent to and received from United States and Canada phone numbers. Phone numbers located in other geographies are not yet supported by Communication Services SMS.
 
 ::: zone pivot="tollfree"
 [!INCLUDE [Toll-Free](./includes/sms-tollfree-pricing.md)]

articles/communication-services/concepts/sms/sms-faq.md

@@ -108,7 +108,7 @@ Rate Limits for SMS:
 
 ## Carrier Fees 
 ### What are the carrier fees for SMS?
-In July 2021, US carriers started charging an added fee for SMS messages sent and/or received from toll-free numbers and short codes. Carrier fees for SMS are charged per message segment based on the destination. Azure Communication Services charges a standard carrier fee per message segment. Carrier fees are subject to change by mobile carriers. Please refer to [SMS pricing](../sms-pricing.md) for more details. 
+US and CA carriers charge an added fee for SMS messages sent and/or received from toll-free numbers and short codes. 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. Azure Communication Services charges a standard carrier fee per message segment. Carrier fees are subject to change by mobile carriers. Please refer to [SMS pricing](../sms-pricing.md) for more details. 
 
 ### When will we come to know of changes to these surcharges?
 As with similar Azure services, customers will be notified at least 30 days prior to the implementation of any price changes. These charges will be reflected on our SMS pricing page along with the effective dates.