Microsoft Teams

Deploying a Smartly Bot to Microsoft Teams

This guide will walk you through the process of deploying a Smartly bot on Microsoft Teams using Azure Bot Services.

Prerequisites

Before starting, ensure you have:

  • A Microsoft Azure account.
  • Access to Microsoft Teams (Enterprise or Microsoft 365).

For more details, refer to the official Microsoft Learn documentation.

Step 1: Create an Azure Bot Application

Access the Azure Portal

  1. Go to Azure Portal and sign in.

  1. Click Create a Resource and search for Azure Bot.

  1. Select Azure Bot and click Create.

Configure the Azure Bot Resource

  1. Fill in the required details:
    • Bot Name
    • Resource Group
    • Region
    • Pricing Plan
  2. Click Create and wait for the deployment to complete.

Step 2: Generate a Client Secret

Access Bot Settings

  1. In the Azure Portal, open your Azure Bot resource.
  2. Navigate to Configuration.
  3. Next to Microsoft App ID, click Manage.

Create a Client Secret

  1. In Azure Active Directory (Azure AD), go to Certificates & Secrets.
  2. Click New Client Secret.
  3. Add a description, set an expiration period, and click Add.
  4. Copy the generated secret value.

Step 3: Configure the Webhook

Generate the Webhook in Smartly

  1. Enter the Microsoft App ID found in the Configuration section.
  2. Paste the Client Secret you copied earlier.
  3. Copy the generated Webhook URL and save it.

Define the Messaging Endpoint in Azure

  1. In the Azure Portal, open your Azure Bot resource.
  2. Navigate to Configuration.
  3. Paste the Webhook URL into the Messaging Endpoint field.
  4. Click Save.

Step 4: Test the Bot in Web Chat

Configure the Web Chat Channel

  1. In Azure, open your Azure Bot resource.
  2. Navigate to the Channels section.
  3. Select Web Chat and follow the setup instructions.
  4. Click Save.

Test the Bot in Web Chat

  1. Open Azure Portal.
  2. Go to your bot’s Test in Web Chat section.
  3. Type a message and verify the bot's response.

Test the Bot in MS Teams

  1. Find your bot in the Applications section. Click on it to start the conversation

  1. Ask your first question

  1. The bot will respond you


Your Smartly bot is now live on Microsoft Teams! 🚀