Microsoft Teams

PocketPaw 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 PocketPaw

Terminal window
export POCKETCLAW_TEAMS_APP_ID="your-app-id"
export POCKETCLAW_TEAMS_APP_PASSWORD="your-app-password"

Start

Terminal window
pocketpaw --teams

Or start via the web dashboard’s Channels modal.

Configuration

SettingEnv VariableDescription
App IDPOCKETCLAW_TEAMS_APP_IDBot Framework App ID
App passwordPOCKETCLAW_TEAMS_APP_PASSWORDBot Framework password
Tenant IDPOCKETCLAW_TEAMS_TENANT_IDAzure tenant ID (optional)
Allowed teamsPOCKETCLAW_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://pocketpaw.xyz/install.sh | sh


# Or add the Teams extra manually
pip install pocketpaw[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 12, 2026
Edit this page