Setting up Microsoft Teams Bot as A Message Source

Microsoft Teams Bot can be used as a source of messages for Y Meadows - triggering an automation when a new message, new message action or new reaction is received. Support two directories - Messages and Message Reactions.

Step 1 - Create Azure Bot

Go to https://portal.azure.com/

Click on Create a resource

Search for Azure Bot

Click on Azure Bot card

Click on Create button

Enter ymeadows_bot as Bot handle

Pick corresponding Azure subscription (based on your Azure billing plan)

Choose Create new in Resource group

Enter ymeadows_bot_resource_group as name for new resource group

Pick corresponding New resource group location based on your location

Pick corresponding Data residency based on your preferences (can leave Global)

Click on Change Plan in Pricing tier section and select Free tier (or can pick any other based on you Azure billing plan)

Select Multi Tenant as Type of App

Check Create new Microsoft App ID as Creation type

Click on Review + Create button

Double check configuration and click Create button

Wait for deployment to complete

Step 2 - Configure Azure Bot

Go to https://portal.azure.com/

Click on ymeadows_bot under Resources - Recent

Click on Configuration under Settings (on the left panel)

Enter https://acme.ymeadows.com/teams/messages as Messaging endpoint

Note that you need to replace acme with actual domain name!

Click Apply

Click on Manage Password link next to Microsoft App ID

Click + New client secret

Enter Description that makes sense for your use

Select an expiration that is tolerable for your security

Click Add button

Copy the generated client secret (column Value, not Secret ID). You will need it later when we ask for App Password.

Record this as the “App Password”. It will be needed in step 6 below.

Go to Overview (on the left panel)

Copy Application (client) ID and Directory (tenant) ID. You will need them later when we ask for App ID and Tenant ID.

Record these as “App ID” and the “Tenant ID”. These values will be used in step 3 and in step 6 below.

Go back to Bot configuration

Click on Channels under Settings (on the left panel)

Click on Microsoft Teams

Read and accept Terms of Service

Click Apply

Provide Application (client) ID to YMeadows team

Step 3 - Create Azure Bot app configuration (Y Meadows internal step)

This step must be completed by Y Meadows engineers. To facilitate their work, provide your implementation manager with the App ID that was recorded earlier.

Run ./generate-app-config.sh <APP ID> where <APP ID> is Application (client) ID received from client

Send app-configuration-<APP ID>.zip file to client

Step 4 - Register Azure Bot app

Go to https://admin.teams.microsoft.com/dashboard

Go to Teams Apps → Manage Apps

Click on Actions → + Upload new app

Choose zip file that YMeadows team sent you

Wait for upload to complete, message New app added should appear

Step 5 - Enable Microsoft Teams Bot feature (YMeadows internal step)

Check with YMeadows engineering team - enabled Microsoft Teams Bot feature for the client

Step 6 - Set up message source on Y Meadows side

This step is normally completed by Y Meadows. To facilitate their work, provide your implementation manager with the App Password, App ID and Tenant ID that were recorded earlier.

Edit existing Microsoft Teams Bot connection

Enter Directory (tenant) ID from step #2 as Tenant ID

Enter Application (client) ID from step #2 as App ID

Enter client secret from step #2 as App Password

Save the connection