Adding section for quickstarts

Author: jjsanchezms

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

@@ -0,0 +1,104 @@
+---
+title: include file
+description: include file
+services: azure-communication-services
+author: jjsanchezms
+manager: chpalm
+ms.service: azure-communication-services
+ms.subservice: azure-communication-services
+ms.date: 07/20/2022
+ms.topic: include
+ms.custom: include file
+ms.author: sanchezjuan
+---
+
+## 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 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
+
+Complete these steps in Power Automate with your Power Automate flow open in edit mode.
+
+To add a new step in your workflow by using the Communication Services Identity connector:
+
+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. 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-communications-services-connector-create-user.png" alt-text="Screenshot that shows the Azure Communication Services Identity connector Create user action.":::
+
+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.
+
+    :::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":::
+
+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. 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. Select **Create**. The user ID and an access token are shown.
+
+## Create a chat thread
+
+1. Add a new action.
+
+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. 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.  
+
+    :::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.":::
+
+## Send a message
+
+1. Add a new action.
+
+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. 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 that you sent a message correctly:
+
+1. Add a new action.
+
+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. 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 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, 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 results.":::
+
+## Clean up workflow 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).
+

articles/communication-services/quickstarts/email/includes/send-email-logic-app.md

@@ -0,0 +1,63 @@
+---
+title: include file
+description: include file
+author: sanchezjuan
+manager: chpalm
+services: azure-communication-services
+ms.author: sanchezjuan
+ms.date: 03/03/2023
+ms.topic: include
+ms.service: azure-communication-services
+ms.custom: mode-other
+---
+
+
+## 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 Email connector provides only actions, so your logic app requires a trigger, at minimum.
+
+- An Azure Communication Services Email resource with a [configured domain](../../email/create-email-communication-resource.md) or [custom domain](../../email/add-custom-verified-domains.md).
+
+- An Azure Communication Services resource [connected with an Azure Email domain](../../email/connect-email-communication-resource.md).
+
+
+
+## Send email
+
+Add a new step in your workflow by using the Azure Communication Services Email   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.
+
+1.	In the Choose an operation search box, enter Communication Services Email. From the actions list, select Send email.
+
+    :::image type="content" source="../media/logic-app/azure-communications-services-connector-send-email.png" alt-text="Screenshot that shows the Azure Communication Services Email connector Send email action."::: 
+
+1.	Provide the Connection String. This can be found in the  [Microsoft Azure](https://portal.azure.com/), within your Azure Communication Service Resource, on the Keys option from the left menu > Connection String
+
+    :::image type="content" source="../media/logic-app/azure-communications-services-connection-string.png" alt-text="Screenshot that shows the Azure Communication Services Connection String." lightbox="../media/logic-app/azure-communications-services-connection-string.png"::: 
+ 
+1.	Provide a Connection Name
+
+1.	Select Send email
+
+    :::image type="content" source="../media/logic-app/azure-communications-services-connector-send-email.png" alt-text="Screenshot that shows the Azure Communication Services Email connector Send email action."::: 
+ 
+1.	Fill the **From**  input field using an email domain configured in the [pre-requisites](#prerequisites). Also fill the To, Subject and Body field as shown below
+ 
+    :::image type="content" source="../media/logic-app/azure-communications-services-connector-send-email-input.png" alt-text="Screenshot that shows the Azure Communication Services Email connector Send email action input."::: 
+
+
+
+## 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). You can check the outputs of these actions after the workflow runs successfully.
+
+You should have an email in the address specified. Additionally, you can use the Get email message status action to check the status of emails send through the Send email action. To learn more actions, check the [Azure Communication Services Email connector](/connectors/acsemail/)  documentation.
+
+## Clean up workflow 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).

articles/communication-services/quickstarts/sms/includes/send-sms-logic-app.md

@@ -0,0 +1,106 @@
+---
+title: include file
+description: include file
+services: azure-communication-services
+author: chpalm
+manager: anvalent
+
+ms.service: azure-communication-services
+ms.subservice: azure-communication-services
+ms.date: 06/30/2021
+ms.topic: include
+ms.custom: include file
+ms.author: chpalm
+---
+
+
+By using the [Azure Communication Services SMS](../../../overview.md) connector and [Azure Logic Apps](../../../../logic-apps/logic-apps-overview.md), you can create automated workflows that can send SMS messages. This quickstart shows how to automatically send text messages in response to a trigger event, which is the first step in a logic app workflow. A trigger event can be an incoming email message, a recurrence schedule, an [Azure Event Grid](../../../../event-grid/overview.md) resource event, or any other [trigger that's supported by Azure Logic Apps](/connectors/connector-reference/connector-reference-logicapps-connectors).
+
+:::image type="content" source="../media/logic-app/azure-communication-services-connector.png" alt-text="Screenshot that shows the Azure portal, which is open to the Logic App Designer, and shows an example logic app that uses the Send SMS action for the Azure Communication Services connector.":::
+
+Although this quickstart focuses on using the connector to respond to a trigger, you can also use the connector to respond to other actions, which are the steps that follow the trigger in a workflow. If you're new to Logic Apps, review [What is Azure Logic Apps](../../../../logic-apps/logic-apps-overview.md) before you get started.
+
+> [!NOTE]
+> Completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.
+
+## 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 SMS connector provides only actions, so your logic app requires a trigger, at minimum.
+
+  This quickstart uses the **When a new email arrives** trigger, which is available with the [Office 365 Outlook connector](/connectors/office365/).
+
+- An SMS enabled phone number, or [get a phone number](./../../telephony/get-phone-number.md).
+
+[!INCLUDE [Regional Availability Notice](../../../includes/regional-availability-include.md)]
+
+## Add an SMS action
+
+To add the **Send SMS** action as a new step in your workflow by using the Azure Communication Services SMS connector, follow these steps in the [Azure portal](https://portal.azure.com) with your logic app workflow open in the Logic App Designer:
+
+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**.
+
+1. In the **Choose an operation** search box, enter `Azure Communication Services`. From the actions list, select **Send SMS**.
+
+   :::image type="content" source="../media/logic-app/select-send-sms-action.png" alt-text="Screenshot that shows the Logic App Designer and the Azure Communication Services connector with the Send SMS action selected.":::
+
+1. Now create a connection to your Communication Services resource.
+    1. Within the same subscription:
+
+       1. Provide a name for the connection.
+
+       1. Select your Azure Communication Services resource.
+
+       1. Select **Create**.
+
+       :::image type="content" source="../media/logic-app/send-sms-configuration.png" alt-text="Screenshot that shows the Send SMS action configuration with sample information.":::
+
+    1. Using the connection string from your Communication Services resource:
+        
+        1. Provide a name for the connection.
+        
+        1. Select ConnectionString Authentication from the drop down options.
+        
+        1. Enter the connection string of your Communication Services resource.
+        
+        1. Select **Create**.
+        
+        :::image type="content" source="../media/logic-app/connection-string-auth.png" alt-text="Screenshot that shows the Connection String Authentication configuration.":::
+        
+    1. Using Service Principal ([Refer Services Principal Creation](../../identity/service-principal-from-cli.md)):
+        1. Provide a name for the connection.
+        
+        1. Select Service principal (Azure AD application) Authentication from the drop down options.
+        
+        1. Enter the Tenant ID, Client ID & Client Secret of your Service Principal.
+        
+        1. Enter the Communication Services Endpoint URL value of your Communication Services resource.
+        
+        1. Select **Create**.
+        
+        :::image type="content" source="../media/logic-app/service-principal-auth.png" alt-text="Screenshot that shows the Service Principal Authentication configuration.":::     
+
+1. In the **Send SMS** action, provide the following information: 
+
+   * The source and destination phone numbers. For testing purposes, you can use your own phone number as the destination phone number.
+
+   * The message content that you want to send, for example, "Hello from Logic Apps!".
+
+   Here's a **Send SMS** action with example information:
+
+   :::image type="content" source="../media/logic-app/send-sms-action.png" alt-text="Screenshot that shows the Send SMS action with sample information.":::
+
+1. When you're done, on the designer toolbar, select **Save**.
+
+Next, run your logic app workflow for testing.
+
+## Test your logic app
+
+To manually start your workflow, on the designer toolbar, select **Run**. Or, you can wait for the trigger to fire. In both cases, the workflow should send an SMS message to your specified destination phone number. For more information, review [how to run your workflow](../../../../logic-apps/quickstart-create-first-logic-app-workflow.md#run-workflow).
+
+## Clean up workflow 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).