Skip to main content
The Microsoft Teams channel lets people message the Agent inside Teams. You register a bot on Azure, paste the bot’s credentials into the Console, and the Agent answers on that bot.

​
Open the Channels screen

1

Open the Agent you want to connect

Go to My agents in the left menu and click the Agent’s name.
2

Pick the Channels tab

It sits on the top bar next to Build, Test and Insights.
Channels list Microsoft Teams sits in the External channels group, next to Web widget, API and Zalo. The card shows Not configured until you connect it.
A channel configured here cannot answer anyone until the Agent is published. People who message it get a notice that the conversation is unavailable. You can still configure it in advance.

​
Prepare on Azure

Before you fill in the Console, you need a bot registered in the Azure Portal. Three values come from there:
  • App ID: The bot’s Microsoft App ID, found in its App registration.
  • Client secret: The secret’s value, created in the same App registration.
  • Tenant ID: The Entra directory (tenant) ID, needed only when the bot is registered single-tenant.
The App ID and the client secret both come from the bot’s App registration in the Azure Portal - two different values on the same page.

​
Connect Microsoft Teams

1

Click the Microsoft Teams card

The Microsoft Teams configuration dialog opens.
2

Copy the Webhook URL

The Console generates this URL and you cannot edit it. Click the copy button at the end of the field, then paste it into the bot’s Messaging endpoint in Azure.
3

Fill in App ID and Client secret

Paste both from the App registration. Click the eye icon to check the secret you just pasted.
4

Fill in Tenant ID if needed

Leave it empty for a bot registered multi-tenant.
5

Set a Display name

This name appears in the channel list. Leave it empty and the Console uses the App ID as the label.
6

Click Connect

Click Cancel to close the dialog without saving.
Microsoft Teams configuration dialog

​
Field reference

​
Edit, pause and remove the channel

Click the Microsoft Teams card again to reopen the dialog and change what you saved. To stop the channel, clear the App ID and Client secret and save, Teams returns to Not configured and the Agent no longer answers on the bot.
If you rotate the client secret on Azure, come back here and paste the new value, otherwise the bot stops answering once the old secret expires.

​
Notes

  • The client secret is sensitive. Do not share screenshots that show it.
  • One Agent can serve several channels at once. The Teams channel works independently of Web widget, API and Zalo.
  • Once the channel is connected, publish the Agent so real users can message it.