final edits

complete

Author: vac0224

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/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/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);
 ```
-
----

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/common-setting-java.md

@@ -5,7 +5,7 @@ services: azure-communication-services
 author: shamkh
 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: shamkh
@@ -16,6 +16,7 @@ zone_pivot_groups: acs-js-csharp-java-python
 ### Start sending messages between a business and a WhatsApp user
 
 Conversations between a WhatsApp Business Account and a WhatsApp user can be initiated in one of two ways:
+
 - The business sends a template message to the WhatsApp user.
 - The WhatsApp user sends any message to the business number.
 
@@ -29,7 +30,7 @@ There are a few different options available for authenticating a Message client:
 
 To authenticate a client, you instantiate an `NotificationMessagesClient` or `MessageTemplateClient` with your connection string. You can also initialize the client with any custom HTTP client that implements the `com.azure.core.http.HttpClient` interface.
 
-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}`.
 
@@ -123,8 +124,9 @@ String channelRegistrationId = "<your channel registration id GUID>";
 ```
 
 ### Set recipient list
-You need to supply a real phone number that has a WhatsApp account associated with it. This WhatsApp account receives the text and media messages sent in this quickstart.
-For this quickstart, this phone number may be your personal phone number.   
+
+You need to supply a real phone number that has a WhatsApp account associated with it. This WhatsApp account receives the text and media messages sent in this article.
+For this article, this phone number can be your personal phone number.   
 
 The recipient phone number can't be the business phone number (Sender ID) associated with the WhatsApp channel registration. The Sender ID appears as the sender of the text and media messages sent to the recipient.
 

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/common-setting-javascript.md

@@ -5,7 +5,7 @@ services: azure-communication-services
 author: shamkh
 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: shamkh
@@ -16,6 +16,7 @@ zone_pivot_groups: acs-js-csharp-java-python
 ### Start sending messages between a business and a WhatsApp user
 
 Conversations between a WhatsApp Business Account and a WhatsApp user can be initiated in one of two ways:
+
 - The business sends a template message to the WhatsApp user.
 - The WhatsApp user sends any message to the business number.
 
@@ -27,7 +28,7 @@ Regardless of how the conversation was started, **a business can only send templ
 
 The following code retrieves the connection string for the resource from an environment variable named `COMMUNICATION_SERVICES_CONNECTION_STRING` using the dotenv package. 
 
-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}`.
 
@@ -59,7 +60,7 @@ const client = NotificationClient(connectionString);
 
 You can also authenticate with Microsoft Entra ID using the [Azure Identity library](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity). 
 
-The [`@azure/identity`](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity) package provides various credential types that your application can use to authenticate. You can choose from the various options to authenticate the identity client detailed at [Azure Identity - Credential providers](/javascript/api/overview/azure/identity-readme#credentials) and [Azure Identity - Authenticate the client](/javascript/api/overview/azure/identity-readme#authenticate-the-client). This option walks through one way of using the [`DefaultAzureCredential`](/javascript/api/overview/azure/identity-readme#defaultazurecredential). 
+The [`@Azure/identity`](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity) package provides various credential types that your application can use to authenticate. You can choose from the various options to authenticate the identity client detailed at [Azure Identity - Credential providers](/javascript/api/overview/azure/identity-readme#credentials) and [Azure Identity - Authenticate the client](/javascript/api/overview/azure/identity-readme#authenticate-the-client). This option walks through one way of using the [`DefaultAzureCredential`](/javascript/api/overview/azure/identity-readme#defaultazurecredential). 
 
 The `DefaultAzureCredential` attempts to authenticate via [`several mechanisms`](/javascript/api/overview/azure/identity-readme#defaultazurecredential) and it might be able to find its authentication credentials if you're signed into Visual Studio or Azure CLI. However, this option walks you through setting up with environment variables.    
 
@@ -138,8 +139,8 @@ const channelRegistrationId = "<your channel registration id GUID>";
 
 ### Set recipient list
 
-You need to supply a real phone number that has a WhatsApp account associated with it. This WhatsApp account receives the template, text, and media messages sent in this quickstart.
-For this quickstart, this phone number may be your personal phone number.   
+You need to supply a real phone number that has a WhatsApp account associated with it. This WhatsApp account receives the template, text, and media messages sent in this article.
+For this article, this phone number can be your personal phone number.   
 
 The recipient phone number can't be the business phone number (Sender ID) associated with the WhatsApp channel registration. The Sender ID appears as the sender of the text and media messages sent to the recipient.
 

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/common-setting-net.md

@@ -5,7 +5,7 @@ services: azure-communication-services
 author: shamkh
 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: shamkh
@@ -17,7 +17,7 @@ zone_pivot_groups: acs-js-csharp-java-python
 
 The Messages SDK uses the `NotificationMessagesClient` to send messages. The `NotificationMessagesClient` method authenticates using your connection string acquired from Azure Communication Services resource in the Azure portal. For more information about connection strings, see [access-your-connection-strings-and-service-endpoints](../../../create-communication-resource.md#access-your-connection-strings-and-service-endpoints).
 
-[!INCLUDE [Authenticate the client ](./authenticate-notification-messages-client-net.md)]
+[!INCLUDE [Authenticate the client](./authenticate-notification-messages-client-net.md)]
 
 ### Set channel registration ID   
 
@@ -57,6 +57,7 @@ var recipientList = new List<string> { "+14255550199" };
 ### Start sending messages between a business and a WhatsApp user
 
 Conversations between a WhatsApp Business Account and a WhatsApp user can be initiated in one of two ways:
+
 - The business sends a template message to the WhatsApp user.
 - The WhatsApp user sends any message to the business number.
 

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/common-setting-python.md

@@ -5,7 +5,7 @@ services: azure-communication-services
 author: shamkh
 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: shamkh
@@ -15,7 +15,9 @@ zone_pivot_groups: acs-js-csharp-java-python
 
 ### Authenticate the client 
 
-Messages sending is done using NotificationMessagesClient. NotificationMessagesClient is authenticated using your connection string acquired from Azure Communication Services resource in the Azure portal. For more information on connection strings, see [access-your-connection-strings-and-service-endpoints](../../../create-communication-resource.md#access-your-connection-strings-and-service-endpoints).
+Messages sending uses NotificationMessagesClient. NotificationMessagesClient authenticates using your connection string acquired from Azure Communication Services resource in the Azure portal.F
+
+For more information on connection strings, see [access-your-connection-strings-and-service-endpoints](../../../create-communication-resource.md#access-your-connection-strings-and-service-endpoints).
 
 #### [Connection String](#tab/connection-string)
 
@@ -127,7 +129,7 @@ Assign it to a variable called channelRegistrationId.
 
 ### Set recipient list
 
-You need to supply an active phone number associated with a WhatsApp account. This WhatsApp account receives the template, text, and media messages sent in this quickstart.
+You need to supply an active phone number associated with a WhatsApp account. This WhatsApp account receives the template, text, and media messages sent in this article.
 
 For this example, you can use your personal phone number.   
 

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/download-media/download-media-full-example-net.md

@@ -5,7 +5,7 @@ services: azure-communication-services
 author: memontic-ms
 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

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

@@ -5,7 +5,7 @@ services: azure-communication-services
 author: arifibrahim4
 ms.service: azure-communication-services
 ms.subservice: advanced-messaging
-ms.date: 12/29/2024
+ms.date: 05/01/2025
 ms.topic: include
 ms.custom: include file
 ms.author: armohamed
@@ -94,4 +94,4 @@ The Messages SDK enables Contoso to download the media in received WhatsApp medi
 
 ## Full sample code
 
-Find the finalized code for this quickstart on [GitHub](https://github.com/Azure/azure-sdk-for-java/tree/d668cb44f64d303e71d2ee72a8b0382896aa09d5/sdk/communication/azure-communication-messages/src/samples/java/com/azure/communication/messages/DownloadMediaSample.java).
+Find the finalized code on GitHub at [Java Messages SDK](https://github.com/Azure/azure-sdk-for-java/tree/d668cb44f64d303e71d2ee72a8b0382896aa09d5/sdk/communication/azure-communication-messages/src/samples/java/com/azure/communication/messages/DownloadMediaSample.java).