Connect Microsoft Teams Bot

Buda supports direct conversations with team members via a Microsoft Teams bot. Setup requires creating a Bot resource in Azure — the whole process takes about 10–15 minutes.

Step 1: Create a Bot in Azure

Open Azure Portal and search for Azure Bot to open the creation page.

Fill in the following:

Click Review + create → Create and wait about 1–2 minutes.

Step 2: Get Credentials

Once created, open the Azure Bot resource:

Get App ID:

1. Go to Configuration
2. Copy Microsoft App ID

Get App Password:

1. Click Manage Password to go to the App Registration page
2. Go to Certificates & secrets → New client secret
3. Enter a description, choose an expiry, and click Add
4. Copy the generated Value (shown only once — save it immediately)

Get Tenant ID:

1. On the App Registration page, click Overview
2. Copy Directory (tenant) ID

Step 3: Add the Channel in Buda

1. Open Channels in Buda settings
2. Click Add Channel and select Microsoft Teams
3. Enter the three credentials:
   • App ID
   • App Password (Client Secret)
   • Tenant ID
4. Click Connect

Step 4: Set the Webhook URL

Back in the Azure Bot resource, go to Configuration and set the Messaging endpoint to:

https://buda.im/api/channels/msteams/webhook

Click Apply to save.

Step 5: Enable the Teams Channel

In the Azure Bot resource, go to Channels, click Microsoft Teams, accept the terms of service, and click Save.

Step 6: Create and Install the Teams App

Teams requires an app package to be installed before the bot can be used.

6.1 Create the App Package

In Teams Developer Portal:

1. Click + New app
2. Fill in the app name, description, and other basic info
3. Go to App features → Bot
4. Select Enter a bot ID manually and paste your App ID
5. Check the scopes: Personal, Team, Group Chat
6. Click Distribute → Download app package to download the ZIP file

6.2 Install in Teams

In Teams:

1. Click Apps on the left → Manage your apps
2. Click Upload a custom app
3. Select the ZIP file you just downloaded
4. Follow the prompts to complete installation

Step 7: Test

Find the bot you just installed in Teams and send a direct message, for example: Hi.

Once Buda replies, you're all set 🎉

In channels, you need to @mention the bot to trigger a reply.

Troubleshooting

The bot is not responding

What if the App Password is compromised?

In Azure App Registration → Certificates & secrets, delete the old secret, generate a new one, and update it in Buda's channel settings.

References

• Azure Bot Registration Guide
• Teams Developer Portal