Merge pull request #223942 from ktoliver/2021097

edit pass: two Communication Services chat articles (2021097)

Author: ShawnJackson

articles/communication-services/quickstarts/chat/logic-app.md

@@ -1,8 +1,8 @@
 ---
-title: Quickstart - Send chat message in Power Automate with Azure Communication Services
+title: Send a chat message in Power Automate
 titleSuffix: An Azure Communication Services quickstart
 description: In this quickstart, learn how to send a chat message in Azure Logic Apps workflows by using the Azure Communication Services Chat connector.
-author: sanchezjuan
+author: jjsanchezms
 manager: chpalm
 services: azure-communication-services
 ms.author: sanchezjuan
@@ -12,108 +12,106 @@ ms.service: azure-communication-services
 ms.custom: mode-other
 ---
 
-# Quickstart: Send chat message in Power Automate with Azure Communication Services
+# Quickstart: Send a chat message in Power Automate
 
-You can create automated workflows that can send chat messages using the Azure Communication Services Chat connector. This quickstart will show how to create a chat, add a participant, send a message and list messages into an existing workflow.
+You can create automated workflows that send chat messages by using the Azure Communication Services Chat connector. This quickstart shows you how to create a chat, add a participant, send a message, and list messages in an existing workflow.
 
 ## Prerequisites
 
 - An Azure account with an active subscription, or [create an Azure account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 
 - An active Azure Communication Services resource, or [create a Communication Services resource](../create-communication-resource.md).
 
-- An active Logic Apps resource (logic app), or [create a blank logic app but with the trigger that you want to use](../../../logic-apps/quickstart-create-first-logic-app-workflow.md). Currently, the Azure Communication Services Chat connector provides only actions, so your logic app requires a trigger, at minimum.
-
+- An active Azure Logic Apps resource, or [create a blank logic app with the trigger that you want to use](../../../logic-apps/quickstart-create-first-logic-app-workflow.md). Currently, the Communication Services Chat connector provides only actions, so your logic app requires a trigger, at minimum.
 
 ## Create user
 
-Add a new step in your workflow by using the Azure Communication Services Identity connector, follow these steps in Power Automate with your Power Automate flow open in edit mode.
-
-1.	On the designer, under the step where you want to add the new action, select New step. Alternatively, to add the new action between steps, move your pointer over the arrow between those steps, select the plus sign (+), and select Add an action.
+Complete these steps in Power Automate with your Power Automate flow open in edit mode.
 
-1.	In the Choose an operation search box, enter Communication Services Identity. From the actions list, select Create a user.
+To add a new step in your workflow by using the Communication Services Identity connector:
 
-    :::image type="content" source="./media/logic-app/azure-communications-services-connector-create-user.png" alt-text="Screenshot that shows the Azure Communication Services Identity connector Create user action.":::
+1. In the designer, under the step where you want to add the new action, select **New step**. Alternatively, to add the new action between steps, move your pointer over the arrow between those steps, select the plus sign (+), and then select **Add an action**.
 
-1. Provide the Connection String. This can be found in [Microsoft Azure](https://portal.azure.com/), within your Azure Communication Service Resource, on the Keys option from the left menu > Connection String
+1. In the **Choose an operation** search box, enter **Communication Services Identity**. In the list of actions list, select **Create a user**.
 
-    :::image type="content" source="./media/logic-app/azure-portal-connection-string.png" alt-text="Screenshot that shows the Keys page within an Azure Communication Services Resource." lightbox="./media/logic-app/azure-portal-connection-string.png":::    
+    :::image type="content" source="./media/logic-app/azure-communications-services-connector-create-user.png" alt-text="Screenshot that shows the Azure Communication Services Identity connector Create user action.":::
 
-1. Provide a Connection Name
+1. Enter the connection string. To get the connection string URL in the [Azure portal](https://portal.azure.com/), go to the Azure Communication Services resource. In the resource menu, select **Keys**, and then select **Connection string**. Select the copy icon to copy the connection string.
 
-1. Click “Show advanced options” and select the Token Scope the action will also output an access token and its expiration time with the specified scope.
+    :::image type="content" source="./media/logic-app/azure-portal-connection-string.png" alt-text="Screenshot that shows the Keys pane for an Azure Communication Services resource." lightbox="./media/logic-app/azure-portal-connection-string.png":::
 
-    This action will output a User ID, which is a Communication Services user identity.
-    Additionally, if you click “Show advanced options” and select the Token Scope the action will also output an access token and its expiration time with the specified scope.
+1. Enter a name for the connection.
 
+1. Select **Show advanced options**, and then select the token scope. The action generates an access token and its expiration time with the specified scope. This action also generates a user ID that's a Communication Services user identity.
+  
     :::image type="content" source="./media/logic-app/azure-communications-services-connector-create-user-action.png" alt-text="Screenshot that shows the Azure Communication Services Identity connector Create user action options.":::
 
-1.	Select “chat”
+1. In **Token Scopes Item**, select **chat**.
 
     :::image type="content" source="./media/logic-app/azure-communications-services-connector-create-user-action-advanced.png" alt-text="Screenshot that shows the Azure Communication Services Chat connector advanced options.":::
 
-1.	Click Create. This will output the User ID and an Access Token.
+1. Select **Create**. The user ID and an access token are shown.
 
 ## Create a chat thread
 
-1.	Add a new action
+1. Add a new action.
 
-1.	In the Choose an operation search box, enter Communication Services Chat. From the actions list, select Create chat thread.
+1. In the **Choose an operation** search box, enter **Communication Services Chat**. In the list of actions, select **Create chat thread**.
 
     :::image type="content" source="./media/logic-app/azure-communications-services-connector-create-chat-thread.png" alt-text="Screenshot that shows the Azure Communication Services Chat connector Create a chat thread action.":::
- 
-1.	Provide the Azure Communication Services endpoint URL. This can be found in [Microsoft Azure](https://portal.azure.com/), within your Azure Communication Service Resource, on the Keys option from the left menu > Endpoint.
 
-1.	Provide a Connection Name
+1. Enter the Communication Services endpoint URL. To get the endpoint URL in the [Azure portal](https://portal.azure.com/), go to the Azure Communication Services resource. In the resource menu, select **Keys**, and then select **Endpoint**.
+
+1. Enter a name for the connection.
+
+1. Select the access token that was generated in the preceding section, and then add a chat thread topic description. Add the created user and enter a name for the participant.  
 
-1.	Select the Access Token from the previous step, add a Chat thread topic description. Additionally, add the created user and add a Name for the participant.  
+    :::image type="content" source="./media/logic-app/azure-communications-services-connector-create-chat-thread-input.png" alt-text="Screenshot that shows the Azure Communication Services Chat connector Create chat thread action dialog.":::
 
-    :::image type="content" source="./media/logic-app/azure-communications-services-connector-create-chat-thread-input.png" alt-text="Screenshot that shows the Azure Communication Services Chat connector Create chat thread action input fields.":::
- 
 ## Send a message
 
-1.	Add a new action
+1. Add a new action.
 
-1.	In the Choose an operation search box, enter Communication Services Chat. From the actions list, select Send a Chat message  to chat thread.
+1. In the **Choose an operation** search box, enter **Communication Services Chat**. In the list of actions, select **Send message to chat thread**.
 
     :::image type="content" source="./media/logic-app/azure-communications-services-connector-send-chat-message.png" alt-text="Screenshot that shows the Azure Communication Services Chat connector Send chat message action.":::
- 
-1.	Provide the Access Token, Thread ID, Content, and Name information as shown below.
- 
-    :::image type="content" source="./media/logic-app/azure-communications-services-connector-send-chat-message-input.png" alt-text="Screenshot that shows the Azure Communication Services Chat connector Send chat message action input fields.":::
+
+1. Enter the access token, thread ID, content, and name.
+
+    :::image type="content" source="./media/logic-app/azure-communications-services-connector-send-chat-message-input.png" alt-text="Screenshot that shows the Azure Communication Services Chat connector Send chat message action dialog.":::
 
 ## List chat thread messages
 
-To verify you have correctly sent a message, we will add one more action to list the chat thread messages.
-1.	Add a new action
+To verify that you sent a message correctly:
+
+1. Add a new action.
 
-1.	In the Choose an operation search box, enter Communication Services Chat. From the actions list, select List chat thread messages.
+1. In the **Choose an operation** search box, enter **Communication Services Chat**. In the list of actions, select **List chat thread messages**.
 
     :::image type="content" source="./media/logic-app/azure-communications-services-connector-list-chat-messages.png" alt-text="Screenshot that shows the Azure Communication Services Chat connector List chat messages action.":::
- 
-1.	Provide the Access token and Thread ID as follows
- 
-    :::image type="content" source="./media/logic-app/azure-communications-services-connector-list-chat-messages-input.png" alt-text="Screenshot that shows the Azure Communication Services Chat connector Send chat message action input.":::
+
+1. Enter the access token and thread ID.
+
+    :::image type="content" source="./media/logic-app/azure-communications-services-connector-list-chat-messages-input.png" alt-text="Screenshot that shows the Azure Communication Services Chat connector List chat messages action dialog.":::
 
 ## Test your logic app
 
-To manually start your workflow, on the designer toolbar, select **Run**. The workflow should create a user, issue an access token for that user, then remove it and delete the user. For more information, review [how to run your workflow](../../../logic-apps/quickstart-create-first-logic-app-workflow.md#run-workflow).
+To manually start your workflow, on the designer toolbar, select **Run**. The workflow creates a user, issues an access token for that user, and then removes the token and deletes the user. For more information, review [How to run your workflow](../../../logic-apps/quickstart-create-first-logic-app-workflow.md#run-workflow).
 
-Now click on the List chat thread messages and check the output, the message sent will be in the action outputs. 
+Now, select **List chat thread messages**. In the action outputs, check for the message that was sent.
 
-:::image type="content" source="./media/logic-app/azure-communications-services-connector-list-chat-messages-output.png" alt-text="Screenshot that shows the Azure Communication Services Chat connector Send chat message action output.":::
+:::image type="content" source="./media/logic-app/azure-communications-services-connector-list-chat-messages-output.png" alt-text="Screenshot that shows the Azure Communication Services Chat connector Send chat message action results.":::
 
 ## Clean up resources
 
-To remove a Communication Services subscription, delete the Communication Services resource or resource group. Deleting the resource group also deletes any other resources in that group. For more information, review [how to clean up Communication Services resources](../create-communication-resource.md#clean-up-resources).
+To remove a Communication Services subscription, delete the Communication Services resource or resource group. Deleting the resource group also deletes any other resources in that group. For more information, review [How to clean up Communication Services resources](../create-communication-resource.md#clean-up-resources).
 
 To clean up your logic app workflow and related resources, review [how to clean up Logic Apps resources](../../../logic-apps/quickstart-create-first-logic-app-workflow.md#clean-up-resources).
 
 ## Next steps
 
-In this quickstart, you learned how to create a user, create a chat thread and send a message using the Azure Communication Services Identity and Azure Communication Services Chat connectors. To learn more check the [Azure Communication Services Chat Connector](/connectors/acschat/) documentation.
-
-To learn more about access tokens check [Create and Manage Azure Communication Services users and access tokens](../chat/logic-app.md). 
+In this quickstart, you learned how to create a user, create a chat thread, and send a message by using the Communication Services Identity and Communication Services Chat connectors. To learn more, review [Communication Services Chat connector](/connectors/acschat/).
 
-To learn more about how to send an email check [Send email message in Power Automate with Azure Communication Services](../email/logic-app.md).
+Learn how to [create and manage Communication Services users and access tokens](../chat/logic-app.md).
 
+Learn how to [send an email message in Power Automate by using Communication Services](../email/logic-app.md).

articles/communication-services/quickstarts/chat/media/logic-app/azure-portal-connection-string.png

@@ -1,43 +1,52 @@
 ---
-title: Using Chat SDK with React Native
+title: Use the Chat SDK with React Native
 titleSuffix: An Azure Communication Services quickstart
-description: In this quickstart, you'll learn how to use the Azure Communication Chat SDK with React Native
-author: askaur
+description: Learn how to use the Azure Communication Services Chat SDK with React Native.
+author: ashwinder
 ms.author: askaur
 ms.date: 11/30/2021
 ms.topic: quickstart
 ms.service: azure-communication-services
 ms.custom: mode-other
 ---
 
-# Quickstart: Using Chat SDK with React Native
+# Quickstart: Use the Chat SDK with React Native
 
-In this quickstart, we'll set up the Chat JavaScript SDK with React Native. This is supported for Azure Communication JavaScript Chat SDK v1.1.1 and later. 
+In this quickstart, you set up the packages in the Azure Communication Services Chat JavaScript SDK to support chat in your React Native app. The steps described in the quickstart are supported for Azure Communication Services JavaScript Chat SDK 1.1.1 and later.
 
-## Setting up with React Native
+## Set up the chat packages to work with React Native
 
-The following steps will be required to run Azure Communication JavaScript Chat SDK with React Native after [initializing your React Native project](https://reactnative.dev/docs/environment-setup#installing-dependencies). 
+Currently, Communication Services chat packages are available as Node packages. Because not all Node modules are compatible with React Native, the modules require a React Native port to work.
 
-ACS chat packages currently available are Node packages. Since not all Node modules are compatible with React Native, they require a React Native port in order to work. To make @azure/communication-chat work with React Native, you will need to install the below mentioned packages that contain React Native ports of the Node core required in @azure/communication-chat.
+After you [initialize your React Native project](https://reactnative.dev/docs/environment-setup#installing-dependencies), complete the following steps to make `@azure/communication-chat` work with React Native. The steps install the packages that contain React Native ports of the Node Core modules that are required in `@azure/communication-chat`.
 
-1. Install `node-libs-react-native` 
-   ``` console
+1. Install `node-libs-react-native`:
+
+   ```console
    npm install node-libs-react-native --save-dev
    ```
-2. Install `stream-browserify` 
-   ``` console
+
+1. Install `stream-browserify`:
+
+   ```console
    npm install stream-browserify --save-dev
    ```
-3. Install `react-native-get-random-values` 
-   ``` console
+
+1. Install `react-native-get-random-values`:
+
+   ```console
    npm install react-native-get-random-values --save-dev
    ```
-4. Install `react-native-url-polyfill` 
-   ``` console
+
+1. Install `react-native-url-polyfill`:
+
+   ```console
    npm install react-native-url-polyfill --save-dev
    ```
-5. Update _metro.config.js_ to use React Native compatible Node Core modules
-   ```JavaScript
+
+1. Update _metro.config.js_ to use React Native-compatible Node Core modules:
+
+   ```javascript
    module.exports = {
        // ...
        resolver: {
@@ -48,14 +57,19 @@ ACS chat packages currently available are Node packages. Since not all Node modu
                tls: require.resolve('node-libs-react-native/mock/tls')
        }
    };
+   }
    ```
-6. Add following _import_ on top of your entry point file
-   ```JavaScript
+
+1. Add the following `import` commands at the top of your entry point file:
+
+   ```javascript
    import 'node-libs-react-native/globals';
    import 'react-native-get-random-values';
    import 'react-native-url-polyfill/auto';
    ```
-7. Install Communication Service packages
+
+1. Install Communication Services packages:
+
    ```console
    npm install @azure/[email protected] --save
 
@@ -65,10 +79,7 @@ ACS chat packages currently available are Node packages. Since not all Node modu
    ```
 
 ## Next steps
-In this quickstart you learned:
-> [!div class="checklist"]
-> * Communication Services packages required to add chat to your app
-> * How to set up Chat SDK for use in React Native environment
 
-For a step by step guide on how to use Chat SDK to start a chat, refer to the [quickstart](./get-started.md?pivots=programming-language-javascript).
+In this quickstart, you learned how to set up the required Communication Services packages to add chat to your app in a React Native environment.
 
+Learn how to [use the Chat SDK to start a chat](./get-started.md?pivots=programming-language-javascript).

articles/communication-services/quickstarts/chat/react-native.md

@@ -29,9 +29,9 @@ items:
     items:
       - name: Add chat to your app
         href: quickstarts/chat/get-started.md
-      - name: Using Chat SDK with React Native
+      - name: Use the Chat SDK with React Native
         href: quickstarts/chat/react-native.md
-      - name: Send Chat messages in Azure Logic Apps
+      - name: Send chat messages by using Power Automate
         href: quickstarts/chat/logic-app.md
       - name: Add a bot to your chat app
         href: quickstarts/chat/quickstart-botframework-integration.md