Microsoft Teams Bot Support: Status, Capabilities, and Configuration
Covers the current status of Microsoft Teams bot support, including text and DM attachments, Adaptive Cards for polls and approvals, and file sending requirements. For developers and admins configuring Teams bots.
Read this when
- Working on Microsoft Teams channel features
Status: text and DM attachments work; sending files in channels or groups needs sharePointSiteId plus Graph permissions (refer to Sending files in group chats). Adaptive Cards carry polls and approval prompts. For file-first sends, message actions surface an explicit upload-file.
-
Setup, Register the bot, then install the Teams app.
-
Pairing, In Teams DMs, pairing mode is the default.
-
Channel troubleshooting, Playbooks for diagnosing and repairing issues across channels.
What each page covers
- Microsoft Teams setup, add the plugin, register both the bot and the Teams app, and run it against a dev tunnel.
- Microsoft Teams access control, policies for DMs and groups, allowlists for teams and channels, and conversation IDs.
- Microsoft Teams authentication, use certificate or managed identity auth in place of a client secret.
- Microsoft Teams manifest and permissions, the app manifest, RSC permissions, and which Graph permissions each capability requires.
- Microsoft Teams configuration,
channels.msteamskeys, environment variables, and history limits. - Microsoft Teams message behavior, session routing, reply style, attachments, and file sending.
- Microsoft Teams cards and actions, approvals, polls, presentation cards, member info, and target formats.
- Microsoft Teams troubleshooting, known limitations, common failures, and reference links.
Where each section moved
Anchors from the earlier single-page version are preserved on every section heading, so a link like /channels/msteams#reply-style-threads-vs-posts continues to resolve. Each entry directs you to the page where that content now lives.
- Bundled plugin
- Quick setup
- Goals
- Config writes
- Access control (DMs + groups)
- Access control (DMs + groups)
- How it works
- Step 1: Create Azure Bot
- Step 1: Create Azure Bot
- Step 2: Get credentials
- Step 2: Get credentials
- Step 3: Configure messaging endpoint
- Step 3: Configure messaging endpoint
- Step 4: Enable Teams channel
- Step 4: Enable Teams channel
- Step 5: Build Teams app manifest
- Step 5: Build Teams app manifest
- Step 6: Configure OpenClaw
- Step 6: Configure OpenClaw
- Step 7: Run the gateway
- Step 7: Run the gateway
- Federated authentication (certificate plus managed identity)
- Federated authentication (certificate plus managed identity)
- Option A: Certificate-based authentication
- Option A: Certificate-based authentication
- Option B: Azure Managed Identity
- Option B: Azure Managed Identity
- AKS Workload Identity setup
- Auth type comparison
- Local development (tunneling)
- Local development (tunneling)
- Testing the bot
- Environment variables
- Member info action
- History context
- Current Teams RSC permissions (manifest)
- Current Teams RSC permissions (manifest)
- Example Teams manifest (redacted)
- Example Teams manifest (redacted)
- Manifest caveats (must-have fields)
- Manifest caveats (must-have fields)
- Updating an existing app
- Capabilities: RSC only vs Graph
- Capabilities: RSC only vs Graph
- With Teams RSC only (app installed, no Graph API permissions)
- With Teams RSC only (app installed, no Graph API permissions)
- With Teams RSC + Microsoft Graph Application permissions
- With Teams RSC + Microsoft Graph Application permissions
- RSC vs Graph API
- Graph-enabled media + history
- Graph-enabled media + history
- Channel/group file recovery (
graphMediaFallback) - Channel/group file recovery (
graphMediaFallback) - Known limitations
- Webhook timeouts
- Teams cloud and service URL support
- Formatting
- Configuration
- Routing and sessions
- Reply style: threads vs posts
- Reply style: threads vs posts
- Resolution precedence
- Thread context preservation
- Attachments and images
- Sending files in group chats
- Why group chats need SharePoint
- Setup
- Sharing behavior
- Fallback behavior
- Files stored location
- Native approval cards
- Polls (Adaptive Cards)
- Polls (Adaptive Cards)
- Presentation cards
- Target formats
- Proactive messaging
- Team and Channel IDs (Common Gotcha)
- Team and Channel IDs (Common Gotcha)
- Private channels
- Troubleshooting
- Common issues
- Manifest upload errors
- RSC permissions not working
- References
Related
-
Channels Overview, Every channel that is supported.
-
Pairing, How DM authentication and pairing work.
-
Groups, How group chats behave and how mention gating applies.
-
Channel routing, Where messages get routed for a session.
-
Configuration reference, The Teams fields listed in the channel configuration reference.
-
Security, The access model plus hardening guidance.
-
Microsoft Teams meetings plugin, How to join Teams meetings as a guest.