Connect Microsoft Teams
Register an Azure Bot, install a Teams app, and connect it to a Buda agent for two-way AI conversations.
Bring your agent into Microsoft Teams so colleagues can chat with it in DMs and channels. Teams is the one channel that uses a messaging endpoint rather than a persistent connection, so setup runs through Azure — plan about 10–15 minutes.
Connect the bot
Create an Azure Bot
In the Azure Portal, search for Azure Bot and open the creation page. Set:
| Field | Value |
|---|---|
| Bot handle | e.g. buda-bot |
| Pricing tier | Free (fine for development) |
| Type of App | Single Tenant |
| Creation type | Create new Microsoft App ID |
Click Review + create → Create.
Get the credentials
From the Azure Bot resource, collect three values:
- App ID — Configuration → Microsoft App ID
- App Password — Manage Password → Certificates & secrets → New client secret, then copy the Value (shown only once)
- Tenant ID — App registration Overview → Directory (tenant) ID
Add the channel in Buda
Open Settings → Channels, click Add Channel, and select Microsoft Teams. Enter the App ID, App Password (client secret), and Tenant ID, then click Connect.
Set the messaging endpoint
Back in the Azure Bot resource, open Configuration and set the Messaging endpoint to:
https://buda.im/api/channels/msteams/webhookClick Apply.
Enable the Teams channel and install the app
In the Azure Bot resource, open Channels → Microsoft Teams, accept the terms, and Save. Then in the Teams Developer Portal, create a new app, add a Bot feature with your App ID entered manually, check the Personal / Team / Group Chat scopes, and Download app package. In Teams, go to Apps → Manage your apps → Upload a custom app and install the ZIP.
Test it
Find the installed bot in Teams and send it a DM, e.g. Hi. In channels, @mention the bot to trigger a reply.
Troubleshooting
| Symptom | Fix |
|---|---|
| Bot not responding | Confirm the messaging endpoint is https://buda.im/api/channels/msteams/webhook |
| App Password expired | Regenerate the client secret in Azure and update Buda's channel settings |
| Teams channel inactive | Check Microsoft Teams is enabled under Azure Bot → Channels, and the app is installed |
Related
- Channels overview — how channels route messages to agents
- Azure Bot registration guide