Creating a bot with Microsoft Azure

To create a bot with Microsoft Azure, you need to use Microsoft Azure portal to create a resource with the Bot Channels Registration service, configure the resource, get the bot password, and configure channels.

1. Create a new resource.
   1. Launch the Microsoft Azure portal at portal.azure.com.
   2. Click Create a resource under Azure services.

      

   3. In the search box, enter bot, then press Enter.
   4. Select the Azure Bot card.
      
   5. Select Create and Azure Bot.
   6. Enter values in the required fields and review and update settings.
      1. Provide information under Project details.

         Bot handle

         Enter bot handle name in Bot handle field. For example, bnz-azure.

         Note: Bot handle can only have the following characters: a-z, A-Z, 0-9, - and _, must start with a letter or digit and must be between 4 and 42 characters long.

         Subscription

         Select your Subscription from the dropdown list. If there is no existing subscription, you can create a new subscription.

         Resource group

         Select your Resource group from the dropdown list. If there is no existing resource group, you can create a new resource group.

         Data residency

         Select whether your bot will have global or local data residency. Currently, the local data residency feature is only available for resources in the "westeurope" region. For more information, see Regionalization in Azure AI Bot Service.

      2. Under Pricing, click change plan for Pricing tier, and in the Choose your pricing tier window, it is recommended that you select the Free card and click Select.
         Note: If the bot only connect Standard channels including Microsoft first-party services such as Skype, Cortana and Microsoft Teams and services with publicly available Bot APIs such as Facebook and Slack. It is recommended that you select free plan to avoid extra costs. For more information, see Azure Bot Services pricing.
         
      3. Provide information under Microsoft App ID.
         1. Ensure that Type of App is set to Multi Tenant. The bot framework uses the botframework.com tenant to do the authentication.
         2. Select Create new Microsoft App ID for Creation type, and click Next.
   7. Optional: You can create tags to mark your resources. Tags are name/value pairs that enable you to categorize resources and view consolidated billing by applying the same tag to multiple resources and resource groups. For more information about tags, see Use tags to organize your Azure resources and management hierarchy.
      Note: If you create tags and then change resource settings on other tabs, your tags will be automatically updated.
   8. Click Next, review your settings, and click Create.
2. Configure the resource.
   1. Click Go to resource when you see the notification. You can also check the resource from the portal home page. Click All resources and you can see the one you just created. Select it to start configuration.
   2. Select Configuration in Settings.
   3. Specify the required values for your resource.
      1. Ensure that the Enable Streaming Endpoint box is unchecked.
      2. To specify the messaging endpoint, you need to do this step after you install Z ChatOps.
      3. Click Apply to make the settings effective.
   4. To get the bot password, click Manage Password next to Microsoft App IDand open the Certificates & secrets pane.
      1. Click New client secret under Client secrets and the Add a client secret displays.
      2. Specify the description for your resource.
      3. Set the Expires value, for example, 730 days (24 months).
      4. Click Add.
      You can see the resource information listed in the table with Description, Expires, Value, and Secret ID. Value is your bot password. Save it for later use when you configure Z ChatOps. It only appears once here.

      Remember: The Microsoft App ID is the bot ID in the Developer Portal of Microsoft Teams. You will need it when you configure your Microsoft Teams in later steps.
3. Configure the channels.
   1. Go back to the resource page, click Channels under Settings.
   2. Click the Microsoft Teams icon under Available Channels.
   3. Select Microsoft Teams Commercial under Messaging.
   4. Click Apply.
4. Set up the bot for your bot app in Microsoft Teams.
   1. Open the Developer Portal in your Microsoft Teams client.
   2. Click Apps, and click your resource that is listed on the pane to open it.
   3. Click App features and select Bot.
   4. Select Enter a bot ID and fill in your Microsoft App ID. You can get the value of Microsoft App ID when you configure the resource in 2.d.
   5. Select Personal and Team as scopes.
      
   6. Click Save to save your settings.