Merge pull request #299262 from vac0224/vc-toc-reconcile5-2025-05-15

Initial commit

Author: JamesJBarnett

articles/communication-services/concepts/advanced-messaging/whatsapp/pricing.md

@@ -1,7 +1,7 @@
 ---
-title: Advanced Messaging pricing in Azure Communication Services
-titleSuffix: An Azure Communication Services concept document
-description: Learn about Communication Service WhatsApp pricing concepts.
+title: Pricing for Advanced Messaging
+titleSuffix: An Azure Communication Services article
+description: Learn about pricing for Advanced Messaging in Azure Communication Services.
 author: darmour
 manager: sundraman
 services: azure-communication-services
@@ -12,7 +12,7 @@ ms.service: azure-communication-services
 ms.subservice: advanced-messaging
 ---
 
-# Advanced Messaging pricing in Azure Communication Services
+# Pricing for Advanced Messaging
 
 Prices for Advanced Messaging in Azure Communication Services consist of two components: the usage fee and the channel fee.
 
@@ -27,16 +27,16 @@ The Azure Communication Services Advanced Messaging usage fee is based on the nu
 
 ## Advanced Messaging channel price
 
-**WhatsApp**
+### WhatsApp
 
-When you connect your WhatsApp Business account to Azure, Azure Communication Services becomes the billing entity for your WhatsApp usage. WhatsApp provides these rates and it's included in your Azure bill. The information given summarizes the key aspects of WhatsApp pricing. WhatsApp describes their pricing in detail here: [Conversation-Based Pricing](https://developers.facebook.com/docs/whatsapp/pricing).
+When you connect your WhatsApp Business account to Azure, Azure Communication Services becomes the billing entity for your WhatsApp usage. WhatsApp provides these rates and are included in your Azure bill. The information given summarizes the key aspects of WhatsApp pricing. WhatsApp describes their pricing in detail here at [Conversation-Based Pricing](https://developers.facebook.com/docs/whatsapp/pricing).
 
 WhatsApp charges per conversation, not individual message. Conversations are message threads between a business and its customers that last 24 or 72 hours based on the conversation category. Conversations are categorized with one of the following categories:
 
--   **Marketing** — Marketing conversations include promotions or offers, informational updates, or invitations for customers to respond or take action.
--   **Utility** — Utility conversations facilitate a specific, agreed-upon request or transaction, or update to a customer about an ongoing transaction. These conversations may include transaction confirmations, transaction updates, and/or post-purchase notifications.
--   **Authentication** — Authentication conversations enable you to authenticate users with one-time passcodes, potentially at multiple steps in the login process (for example, account verification, account recovery, integrity challenges).
--   **Service** — Service conversations help you resolve customer inquiries.
+- **Marketing** conversations include promotions or offers, informational updates, or invitations for customers to respond or take action.
+- **Utility** conversations facilitate a specific, agreed-upon request or transaction, or update to a customer about an ongoing transaction. These conversations might include transaction confirmations, transaction updates, and/or post-purchase notifications.
+- **Authentication** conversations enable you to authenticate users with one-time passcodes, potentially at multiple steps in the sign in process. Authentication can include account verification, account recovery, and integrity challenges.
+- **Service** conversations help you resolve customer inquiries.
 
 For service conversations, WhatsApp provides 1,000 free conversations each month across all business phone numbers. Marketing, utility and authentication conversations aren't part of the free tier.
 
@@ -60,7 +60,7 @@ To get the latest WhatsApp rates, refer to WhatsApp’s pricing documentation: [
 
 ## Pricing example: A WhatsApp user reaches out to a business for support
 
-Contoso is a business that provides a contact center for customers to seek product information and support. All these cases are closed within 24 hours and have an average of 20 messages each. Each case equals one WhatsApp Conversation. WhatsApp classifies contact center conversations as “Service Conversations.”
+Contoso is a business that provides a contact center for customers to seek product information and support. All these cases are closed within 24 hours and have an average of 20 messages each. Each case equals one WhatsApp Conversation. WhatsApp classifies contact center conversations as *Service Conversations*.
 
 Contoso manages 2,000 cases in North America each month and the pricing would be:
 
@@ -76,6 +76,6 @@ To get the latest WhatsApp rates, refer to WhatsApp’s pricing documentation: [
 
 -   [Register WhatsApp Business Account](../../../quickstarts/advanced-messaging/whatsapp/connect-whatsapp-business-account.md)
 -   [Advanced Messaging for WhatsApp Terms of Services](./whatsapp-terms-of-service.md)
--   [Trying WhatsApp Sandbox](../../../quickstarts//advanced-messaging/whatsapp/whatsapp-sandbox-quickstart.md)
+-   [Try Advanced Messaging Sandbox](../../../quickstarts//advanced-messaging/whatsapp/whatsapp-sandbox-quickstart.md)
 -   [Get Started With Advanced Communication Messages SDK](../../../quickstarts//advanced-messaging/whatsapp/get-started.md)
 -   [Messaging Policy](../../../concepts/sms/messaging-policy.md)

articles/communication-services/concepts/advanced-messaging/whatsapp/whatsapp-overview.md

@@ -1,7 +1,7 @@
 ---
-title: Advanced Messaging for WhatsApp in Azure Communication Services
-titleSuffix: An Azure Communication Services concept document
-description: Learn about Communication Service WhatsApp concepts.
+title: Overview of Advanced Messaging for WhatsApp
+titleSuffix: An Azure Communication Services article
+description: Learn about Azure Communication Services Advanced Messaging for WhatsApp.
 author: darmour
 manager: sundraman
 services: azure-communication-services
@@ -12,7 +12,7 @@ ms.service: azure-communication-services
 ms.subservice: advanced-messaging
 ---
 
-# Advanced Messaging for WhatsApp in Azure Communication Services
+# Overview of Advanced Messaging for WhatsApp
 
 Azure Communication Services enables you to send and receive WhatsApp messages using the Azure Communication Services Messaging SDK. You can use this SDK to engage in conversations with customers for product inquiry and customer service scenarios. You can also use it to send messages such as appointment reminders, shipping updates, two-factor authentication, and other notification scenarios.
 
@@ -35,8 +35,8 @@ To get started with Advanced Messaging for WhatsApp, see:
 
 - [Register WhatsApp Business Account](../../../quickstarts/advanced-messaging/whatsapp/connect-whatsapp-business-account.md).
 - [Advanced Messaging for WhatsApp Terms of Services](./whatsapp-terms-of-service.md).
-- [Trying WhatsApp Sandbox](../../../quickstarts/advanced-messaging/whatsapp/whatsapp-sandbox-quickstart.md).
+- [Try Advanced Messaging Sandbox](../../../quickstarts/advanced-messaging/whatsapp/whatsapp-sandbox-quickstart.md).
 - [Get Started With Advanced Communication Messages SDK](../../../quickstarts//advanced-messaging/whatsapp/get-started.md).
 - [Handle Advanced Messaging Events](../../../quickstarts/advanced-messaging/whatsapp/handle-advanced-messaging-events.md).
-- [Messaging Policy](../../../concepts/sms/messaging-policy.md).
+- [View Messaging Policy](../../../concepts/sms/messaging-policy.md).
 - [Pricing for Advanced Messaging for WhatsApp](./pricing.md).

articles/communication-services/concepts/advanced-messaging/whatsapp/whatsapp-terms-of-service.md

@@ -1,6 +1,6 @@
 ---
 title: Advanced Messaging for WhatsApp data transfer and independent terms of service
-titleSuffix: An Azure Communication Services concept document
+titleSuffix: An Azure Communication Services article
 description: Learn about Communication Service WhatsApp terms of service concepts.
 author: darmour
 manager: sundraman
@@ -14,20 +14,24 @@ ms.subservice: advanced-messaging
 
 # Advanced Messaging for WhatsApp data transfer and independent terms of service
 
-To enable the WhatsApp feature in Azure Communication Services, you need to create or connect a WhatsApp Business Account and agree to the Meta Cloud API and WhatsApp Terms of Service ("Meta Terms"). When you use the WhatsApp feature in Azure Communication Services, your data is transferred from one service to the other, and the respective terms govern the handling of that data. [Microsoft Product Terms](https://www.microsoft.com/licensing/terms) governs the Azure Communication Services. [Meta Terms](https://www.facebook.com/legal/Meta-Hosting-Terms-Cloud-API)  governs the WhatsApp Service. You should be aware of differences between the Meta Terms and Microsoft Terms in subject matters, including but not limited to privacy, compliance and data handling.
+To enable the WhatsApp feature in Azure Communication Services, you need to create or connect a WhatsApp Business Account and agree to the Meta Cloud API and WhatsApp Terms of Service ("Meta Terms").
+
+When you use the WhatsApp feature in Azure Communication Services, your data is transferred from one service to the other, and the respective terms govern the handling of that data. [Microsoft Product Terms](https://www.microsoft.com/licensing/terms) governs the Azure Communication Services. [Meta Terms](https://www.facebook.com/legal/Meta-Hosting-Terms-Cloud-API) governs the WhatsApp Service.
+
+There are differences between the Meta Terms and Microsoft Terms in subject matters, including but not limited to privacy, compliance, and data handling.
 
 ## EU data boundary
 
-WhatsApp data follows the data handling policy defined in the Meta Terms, which may not include the EU Data Boundary commitments.
+WhatsApp data follows the data handling policy defined in the Meta Terms, which might not include the EU Data Boundary commitments.
 
 ## Support data transfer
 
-Some support cases may require you to authorize the transfer of your data to Meta. Any data that Microsoft collects will be handled in accordance with the Microsoft Product Terms. The Meta software and any data that you provide to Meta or authorize Microsoft to provide Meta will be covered by the Meta Terms.
+Some support cases might require you to authorize the transfer of your data to Meta. Any data that Microsoft collects is managed in accordance with the Microsoft Product Terms. The Meta software and any data that you provide to Meta or authorize Microsoft to provide Meta is covered by the Meta Terms.
 
-## Service level agreement
+## Service level agreement (SLA)
 
 Azure Communication Services provides an SLA for its customers as outlined in the Azure Terms. Once data is transferred to WhatsApp, it follows the service levels detailed in the Meta Terms.
 
 ## HIPAA
 
-The WhatsApp Service may not be HIPAA compliant. It may not have the proper safeguards in place to protect health information.
+The WhatsApp Service might not be HIPAA compliant. It might not have the proper safeguards in place to protect health information.

articles/communication-services/quickstarts/advanced-messaging/message-analysis/message-analysis-with-azure-openai-quickstart.md

@@ -9,7 +9,7 @@ ms.author: gelli
 ms.service: azure-communication-services
 ms.subservice: advanced-messaging
 ms.topic: quickstart 
-ms.date: 07/05/2024
+ms.date: 05/01/2025
 ---
 
 # Quickstart: Enable Message Analysis with Azure OpenAI
@@ -32,7 +32,7 @@ Azure Communication Services enables you to receive Message Analysis results usi
 
    a. Open your Azure Communication Services resource and click the **Cognitive Services** tab.
 
-   b. If system-assigned managed identity isn't enabled, you'll need to enable it.
+   b. If system-assigned managed identity isn't enabled, you need to enable it.
 
    c. In the Cognitive Services tab, click **Enable Managed Identity**.
 
@@ -88,6 +88,7 @@ If you want to clean up and remove a Communication Services subscription, you ca
 
 
 ## Learn more about responsible AI
+
 - [Message Analysis Transparency FAQ](../../../concepts/advanced-messaging/message-analysis/message-analysis-transparency-faq.md)
 - [Microsoft AI principles](https://www.microsoft.com/ai/responsible-ai)
 - [Microsoft responsible AI resources](https://www.microsoft.com/ai/responsible-ai-resources)

articles/communication-services/quickstarts/advanced-messaging/whatsapp/connect-whatsapp-business-account.md

@@ -1,6 +1,6 @@
 ---
-title: Register WhatsApp business account
-titleSuffix: An Azure Communication Services concept document
+title: Register WhatsApp Business Account
+titleSuffix: An Azure Communication Services article
 description: Learn about Communication Service WhatsApp Business Accounts concepts.
 author: darmour
 manager: sundraman
@@ -12,7 +12,7 @@ ms.service: azure-communication-services
 ms.subservice: advanced-messaging
 ---
 
-# Register WhatsApp business account
+# Register WhatsApp Business Account
 
 Get started with the Azure Communication Services Advanced Messaging, which extends messaging to users on WhatsApp. This feature enables your organization to send and receive messages with WhatsApp users using a WhatsApp Business Account. The Advanced Communication Messages SDK extends your communications to interact with the large global WhatsApp community for common scenarios:
 
@@ -21,7 +21,8 @@ Get started with the Azure Communication Services Advanced Messaging, which exte
 
 ## Overview
 
-This article provides information about registering a WhatsApp Business Account with Azure Communication Services. The following video demonstrates this process. 
+This article describes how to register a WhatsApp Business Account with Azure Communication Services. The following video demonstrates this process.
+
 > [!VIDEO https://learn-video.azurefd.net/vod/player?id=04c63978-6f27-4289-93d6-625d8569ee28]
 
 ## Prerequisites
@@ -50,8 +51,8 @@ This article provides information about registering a WhatsApp Business Account
     > You can now use your WhatsApp Business Account multiple times with different Phone Numbers.
 
     > [!NOTE]
-    > If you try to create a WhatsApp channel multiple times using the same WhatsApp Business Account and Phone Number, you may encounter errors. This happens because the Phone Number is already shared with Microsoft and 'locked'. To fix this, delete the Phone Number and WhatsApp Business Account on the META portal. If you are unable to delete your WhatsApp Business Account, open a Support Case for manual assistance.
-        
+    > If you try to create a WhatsApp channel multiple times using the same WhatsApp Business Account and Phone Number, you might encounter errors. This problem happens because the Phone Number is already shared with Microsoft and `locked`. To fix the problem, delete the Phone Number and WhatsApp Business Account on the META portal. If you can't delete your WhatsApp Business Account, open a Support Case for manual assistance.
+    
     :::image type="content" source="./media/register-whatsapp-account/whatsapp-business-account-details.png" lightbox="./media/register-whatsapp-account/whatsapp-business-account-details.png" alt-text="Screenshot that shows WhatsApp Business account details.":::
 
 1. Once you complete the form, select **Next** to continue.
@@ -104,7 +105,7 @@ This article described how to register your WhatsApp Business Account with Azure
 > [!div class="nextstepaction"]
 > [Get started With Advanced Messages SDK](../../../quickstarts//advanced-messaging/whatsapp/get-started.md)
 
-You might also want to see the following articles: 
+## Related articles
 
 -    [WhatsApp Business Account FAQ](../../../quickstarts//advanced-messaging/whatsapp/whatsapp-business-account-faq.md)
 -    [WhatsApp Business Help Center](https://www.facebook.com/business/help/524220081677109?id=2129163877102343)

articles/communication-services/quickstarts/advanced-messaging/whatsapp/download-media.md

@@ -1,12 +1,12 @@
 ---
 title: Download WhatsApp message media
-titleSuffix: An Azure Communication Services Messages quickstart
+titleSuffix: An Azure Communication Services Messages article
 description: In this quickstart, you learn how to download the media received in a WhatsApp message with Azure Communication Services Messages.
 author: Shamkh
 manager: camilo.ramirez
 services: azure-communication-services
 ms.author: shamkh
-ms.date: 07/24/2024
+ms.date: 05/01/2025
 ms.topic: quickstart
 ms.service: azure-communication-services
 ms.subservice: advanced-messaging
@@ -64,9 +64,7 @@ An example of an `AdvancedMessageReceived` event with media content:
 
 ## Next steps
 
-This article described how to download the media received in a WhatsApp message using Advanced Messaging for WhatsApp SDK. Next you might want to continue with the following articles:
-
-- [More Sample](/samples/azure/azure-sdk-for-js/communication-messages-javascript)
+- [More samples](/samples/azure/azure-sdk-for-js/communication-messages-javascript)
 - [Send WhatsApp Messages using Advanced Messages](../../../quickstarts/advanced-messaging/whatsapp/get-started.md)
 - [Handle Advanced Messaging Events](./handle-advanced-messaging-events.md)
-- [Send WhatsApp Template Messages](../../../quickstarts/advanced-messaging/whatsapp/send-template-messages.md)
+- [Send WhatsApp template messages](../../../quickstarts/advanced-messaging/whatsapp/send-template-messages.md)

articles/communication-services/quickstarts/advanced-messaging/whatsapp/get-started.md

@@ -1,7 +1,7 @@
 ---
-title: Add Advanced Messaging to your app
-titleSuffix: An Azure Communication Services Messages quickstart
-description: In this quickstart, you learn to set up the basic functionality of Azure Communication Services Messages.
+title: Send text and media WhatsApp messages
+titleSuffix: An Azure Communication Services Messages article
+description: This article describes how to send text and media WhatsApp messages in Azure Communication Services Messages.
 author: Shamkh
 manager: camilo.ramirez
 services: azure-communication-services
@@ -14,7 +14,7 @@ ms.custom: devx-track-extended-java, devx-track-js, devx-track-python
 zone_pivot_groups: acs-js-csharp-java-python
 ---
 
-# Send text and media WhatsApp messages using Advanced Messaging
+# Send text and media WhatsApp messages
 
 Azure Communication Services enables you to send and receive WhatsApp messages. This article describes how to integrate your app with Azure Communication Advanced Messages SDK to start sending and receiving WhatsApp messages. Completing this article incurs a small cost of a few USD cents or less in your Azure account.
 
@@ -36,7 +36,5 @@ Azure Communication Services enables you to send and receive WhatsApp messages.
 
 ## Next steps
 
-This article described the Advanced Messaging for WhatsApp SDK. For more information, see the following articles:
-
 - [Handle Advanced Messaging events](./handle-advanced-messaging-events.md)
 - [Send WhatsApp template messages](../../../quickstarts/advanced-messaging/whatsapp/send-template-messages.md)

articles/communication-services/quickstarts/advanced-messaging/whatsapp/handle-advanced-messaging-events.md

@@ -9,7 +9,7 @@ ms.author: shamkh
 ms.service: azure-communication-services
 ms.subservice: advanced-messaging
 ms.topic: quickstart 
-ms.date: 02/12/2024
+ms.date: 05/01/2025
 ms.custom: template-quickstart
 ---
 
@@ -98,7 +98,6 @@ If you want to clean up and remove a Communication Services subscription, you ca
 
 ## Next steps
 
-For more information, see:
 - [Understand Advanced Communication Messages Events](../../../../event-grid/communication-services-advanced-messaging-events.md)
 - [Get started With Advanced Communication Messages SDK](./get-started.md)
 

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/authenticate-notification-messages-client-net.md

@@ -5,15 +5,15 @@ services: azure-communication-services
 author: memontic
 ms.service: azure-communication-services
 ms.subservice: advanced-messaging
-ms.date: 07/15/2024
+ms.date: 05/01/2025
 ms.topic: include
 ms.custom: include file
 ms.author: memontic
 ---   
 
 #### [Connection String](#tab/connection-string)
 
-For simplicity, this quickstart uses a connection string to authenticate. In production environments, we recommend using [service principals](../../../identity/service-principal.md).
+For simplicity, this article uses a connection string to authenticate. In production environments, we recommend using [service principals](../../../identity/service-principal.md).
 
 Get the connection string from your Azure Communication Services resource in the Azure portal. On the left, navigate to the `Keys` tab. Copy the `Connection string` field for the primary key. The connection string is in the format `endpoint=https://{your Azure Communication Services resource name}.communication.azure.com/;accesskey={secret key}`.
 
@@ -105,5 +105,3 @@ var credential = new AzureKeyCredential(key);
 var notificationMessagesClient = 
     new NotificationMessagesClient(endpoint, credential);
 ```
-
----