Merge branch 'main' of https://github.com/glorialimicrosoft/azure-docs-pr

Author: glorialimicrosoft

articles/communication-services/concepts/advanced-messaging/message-analysis/message-analysis-transparency-faq.md

@@ -17,7 +17,7 @@ ms.service: azure-communication-services
 
 ## What is Message Analysis? 
 
-Message Analysis is an AI feature that analyses the incoming customer messages to extract insights that assist developers to enhance customer interactions. It detects the language, determines the intent (like a service question or complaint), and identifies key topics.  Message analysis can help businesses understand how well their communication strategies are working and improve their interactions with customers. 
+Message Analysis is an AI feature that analyses the incoming customer messages to extract insights that help developers enhance customer interactions. It detects the language, determines the intent (like a service question or complaint), and identifies key topics.  Message analysis can help businesses understand how well their communication strategies are working and improve their interactions with customers. 
 
 ## What can Message Analysis do?  
 
@@ -63,7 +63,7 @@ This combination of features enables businesses to tailor their responses and be
 
 * False positives:  
 
-   * The system may occasionally generate false positive analyses, particularly when dealing with ambiguous, conflicting, or sarcastic content, as well as culturally specific phrases and idioms from customer messages that it cannot accurately interpret. 
+   * The system may occasionally generate false positive analyses, particularly when dealing with ambiguous, conflicting, or sarcastic content, and culturally specific phrases and idioms from customer messages that it cannot accurately interpret. 
 
 * Unsupported languages/ Translation Issues: 
 

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

@@ -14,7 +14,7 @@ ms.date: 07/05/2024
 
 [!INCLUDE [Public Preview Notice](../../../includes/public-preview-include-document.md)]
 
-Azure Communication Services now enables you to receive Message Analysis results using your own Azure OpenAI resource.
+Azure Communication Services enables you to receive Message Analysis results using your own Azure OpenAI resource.
 
 ## Prerequisites
 
@@ -28,54 +28,54 @@ Azure Communication Services now enables you to receive Message Analysis results
 
 1. **Connect Azure Communication Services with Azure OpenAI Services:**
 
-   - Open your Azure Communication Services resource and click on the Cognitive Services tab.
-   - If system-assigned managed identity isn't enabled, you'll need to enable it.
-   - In the Cognitive Services tab, click on "Enable Managed Identity" button.
+   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.
+   c. In the Cognitive Services tab, click **Enable Managed Identity**.
 
       :::image type="content" source="./media/get-started/enabled-identity.png" lightbox="./media/get-started/enabled-identity.png" alt-text="Screenshot of Enable Managed Identity button.":::
 
-   - Enable system assigned identity. This action begins the creation of the identity; A pop-up notification appears notifying you that the request is being processed.
+   d. Enable system assigned identity. This action begins the creation of the identity. A pop-up alert notifies you that the request is being processed.
 
       :::image type="content" source="./media/get-started/enable-system-identity.png" lightbox="./media/get-started/enable-system-identity.png" alt-text="Screenshot of enable managed identity.":::
 
 
-   - When managed identity is enabled, the Cognitive Service tab should show a button 'Connect cognitive service' to connect the two services.
+   e. When managed identity is enabled, the Cognitive Service tab displays a **Connect cognitive service** button to connect the two services.
 
       :::image type="content" source="./media/get-started/cognitive-services.png" lightbox="./media/get-started/cognitive-services.png" alt-text="Screenshot of Connect cognitive services button.":::
 
-   - Click on 'Connect cognitive service', select the Subscription, Resource Group, and Resource, and click 'Connect' in the context pane that opens up.
+   f. Click **Connect cognitive service**, then select the Subscription, Resource Group, and Resource, and click **Connect** in the context pane.
 
       :::image type="content" source="./media/get-started/choose-options.png" lightbox="./media/get-started/choose-options.png" alt-text="Screenshot of Subscription, Resource Group, and Resource in pane.":::
 
 2. **Enable Message Analysis:**
-   - Go to the **Channels** page of the **Advanced Messaging** tab in your Azure Communication Services resource.
+   a. Go to the **Channels** page of the **Advanced Messaging** tab in your Azure Communication Services resource.
 
      :::image type="content" source="./media/get-started/channels-page.png" lightbox="./media/get-started/channels-page.png" alt-text="Screenshot that shows the channels page.":::
 
 
-   - Click on the channel you would like to enable Message Analysis on and a channel details page should pop up.
+   b. Select the channel of your choice to enable Message Analysis on. The system displays a channel details dialog.
 
      :::image type="content" source="./media/get-started/channel-details-list.png" lightbox="./media/get-started/channel-details-list.png" alt-text="Screenshot that shows the channel details page.":::
 
 
-   - Toggle **Allow Message Analysis**, select one of the connected Azure OpenAI services, then choose the desired deployment model for the Message Analysis feature. Then click **Save**.
+   c. Toggle **Allow Message Analysis**. Select one of the connected Azure OpenAI services and choose the desired deployment model for the Message Analysis feature. Then click **Save**.
 
      :::image type="content" source="./media/get-started/enable-message-analysis.png" lightbox="./media/get-started/enable-message-analysis.png" alt-text="Screenshot that shows how to enable Message Analysis.":::
 
 
 3. **Set up Event Grid subscription:**
 
-   - Subscribe to Advanced Message Analysis Completed event by creating or modifying an event subscription. See [Subscribe to Advanced Messaging events](../whatsapp/handle-advanced-messaging-events.md#set-up-event-grid-viewer) for more details on creating event subscriptions.
+   Subscribe to Advanced Message Analysis Completed event by creating or modifying an event subscription. See [Subscribe to Advanced Messaging events](../whatsapp/handle-advanced-messaging-events.md#set-up-event-grid-viewer) for more details on creating event subscriptions.
 
       :::image type="content" source="./media/get-started/create-event-subscription-message-analysis.png" lightbox="./media/get-started/create-event-subscription-message-analysis.png" alt-text="Screenshot that shows how to create Message Analysis event subscription properties.":::
 
 5. **See Message Analysis in action**
-   - Send a message from WhatsApp Customer to Contoso business phone number.
+   Send a message from WhatsApp Customer to Contoso business phone number.
 
       :::image type="content" source="./media/get-started/send-a-message.png" lightbox="./media/get-started/send-a-message.png" alt-text="Screenshot that shows sending a message from Customer to Contoso.":::
 
 6. **Receive the Message Analysis event**
-   - Receive the Message Analysis event in the Event Grid Viewer that you set up in Step **3**.
+   Receive the Message Analysis event in the Event Grid Viewer that you set up in Step **3**.
 
       :::image type="content" source="./media/get-started/event-grid-viewer.png" lightbox="./media/get-started/event-grid-viewer.png" alt-text="Screenshot that shows Message Analysis event being received at Event Grid Viewer.":::