back to docs

Microsoft Teams

Connect your ChatBotKit bot to Microsoft Teams channels, group chats, and direct messages via the Azure Bot Framework

The Microsoft Teams integration lets you bring a ChatBotKit AI bot directly into your Microsoft Teams workspace. Once connected, users can talk to the bot in direct messages, group chats, and channels — right where they already work, without switching tools or learning anything new.

How It Works

The integration connects ChatBotKit to Teams through the Microsoft Bot Framework. You register a bot in the Azure portal, point its messaging endpoint at ChatBotKit, and the two services take care of the rest. Every message a user sends to the bot in Teams gets processed by the ChatBotKit bot you choose, and the reply comes back instantly inside Teams.

Each user gets their own conversation context that carries forward for as long as the session is active, so conversations feel coherent and continuous. Sessions can be configured to last anywhere from minutes to days depending on your use case.

What You Can Do With It

The most common use is an internal support or knowledge bot — something that answers questions about company policies, IT procedures, or project documentation without anyone having to search through wikis or wait for a colleague to respond. Because the bot lives inside Teams, adoption is natural: people just message it the same way they message anyone else.

Beyond support, teams use it for onboarding assistants that help new hires find their footing, project bots that surface status updates and documentation on demand, and helpdesk bots that handle the first tier of IT requests automatically.

You can control exactly who can talk to the bot, how long their conversation context lasts, and whether the bot streams responses progressively or sends them all at once. For organisations with strict tenant boundaries, you can scope the integration to a single Azure AD tenant so only your own users can reach it.

Setting It Up

You'll need a Microsoft Azure account with permission to create Bot resources. The overall flow is: create the integration in ChatBotKit, set up an Azure Bot, connect the two with a webhook URL and credentials, then verify everything with the Setup button.

  1. Create the integration: Give it a name, pick the bot that will handle conversations, and click Create. ChatBotKit will generate a unique Messaging Endpoint URL for this integration.
  2. Register an Azure Bot: In the Azure portal, search for "Azure Bot" and create a new resource. This is where Microsoft registers your bot and issues the credentials ChatBotKit needs.
  3. Set the Messaging Endpoint: In your Azure Bot resource, open Configuration and paste the Messaging Endpoint URL from ChatBotKit into the "Messaging endpoint" field. This is how Teams knows where to send messages.
  4. Get your credentials: From your Azure Bot's Configuration page, copy the Microsoft App ID. Then go to your app registration in Azure AD, open "Certificates & secrets", and create a new client secret.
  5. Enable the Teams channel: In your Azure Bot resource, go to Channels and add Microsoft Teams. This makes the bot available inside Teams.
  6. Enter credentials in ChatBotKit: Back on this page, fill in the Application ID, Application Secret, and Tenant ID (use common if you want the bot to work across multiple tenants), then click Save.
  7. Run Setup: Click the Setup button to verify that ChatBotKit can authenticate with Azure using the credentials you provided. A success response means the bot is ready to use in Teams.