Microsoft Teams

Mudabbir integrates with Microsoft Teams via the Bot Framework SDK. This is ideal for enterprise environments that use Teams as their primary collaboration tool.

Setup

Register a bot

  1. Go to the Azure Portal
  2. Create a new Bot Channels Registration
  3. Note the App ID and generate a password

Configure messaging endpoint

Set the messaging endpoint to your server’s public URL:

https://your-server.com/api/messages/teams

Configure Mudabbir

Terminal window
export MUDABBIR_TEAMS_APP_ID="your-app-id"
export MUDABBIR_TEAMS_APP_PASSWORD="your-app-password"

Start

Terminal window
mudabbir --teams

Or start via the web dashboard’s Channels modal.

Configuration

SettingEnv VariableDescription
App IDMUDABBIR_TEAMS_APP_IDBot Framework App ID
App passwordMUDABBIR_TEAMS_APP_PASSWORDBot Framework password
Tenant IDMUDABBIR_TEAMS_TENANT_IDAzure tenant ID (optional)
Allowed teamsMUDABBIR_TEAMS_ALLOWED_TEAM_IDSComma-separated team IDs

Features

Webhook-Based

The Teams adapter exposes a webhook endpoint at /api/messages/teams. The Bot Framework sends activities to this endpoint when users interact with the bot.

No Streaming

Teams messages are accumulated and sent as a complete response when the agent finishes processing.

Session Keys

Each conversation gets a unique session: teams:{conversation_id}

Installation

Terminal window
curl -fsSL https://mudabbir.fly.dev/install.sh | sh


# Or add the Teams extra manually
pip install mudabbir[teams]

This installs the botbuilder-core SDK as an optional dependency.

Info

Microsoft Teams integration requires a public URL for the webhook endpoint. Use the web dashboard or set up a reverse proxy with a public domain.

Last updated: February 21, 2026
1 min read
Edit this page