Microsoft Teams - profClaw

profClaw integrates with Microsoft Teams via the Bot Framework. It responds to messages, mentions, and commands in chats and channels.

Capabilities

Feature	Supported
1:1 chat	Yes
Channel messages	Yes
Adaptive Cards	Yes
Slash commands	Yes
File uploads	Yes
Teams meetings	No
OAuth install	Yes
Multi-tenant	Yes

Setup

Go to portal.azure.com and create an Azure Bot resource.

Set the messaging endpoint to: https://your-domain.com/webhooks/teams
Choose Multi-tenant for use across multiple organizations

Get Bot credentials

Under Configuration, copy the Microsoft App ID and Password (client secret).

Create a Teams App

Use Teams Developer Portal or App Studio to create a Teams app manifest:

{
  "bots": [{
    "botId": "your-microsoft-app-id",
    "scopes": ["team", "personal", "groupchat"]
  }]
}

Configure profClaw

TEAMS_APP_ID=your-microsoft-app-id
TEAMS_APP_PASSWORD=your-client-secret
TEAMS_TENANT_ID=your-tenant-id

Deploy the app

Upload the app package to Teams Admin Center or install via sideloading.

Environment Variables

string

required

Microsoft App ID (Bot Framework Application ID).

string

required

Microsoft App Password (client secret).

string

Azure AD Tenant ID. Use common for multi-tenant apps.

string

Comma-separated Team IDs to restrict access.

string

Comma-separated Channel IDs to restrict access.

Configuration Example

.env
settings.yml

TEAMS_APP_ID=00000000-0000-0000-0000-000000000000
TEAMS_APP_PASSWORD=your-client-secret
TEAMS_TENANT_ID=common

chat:
  msteams:
    app_id: "${TEAMS_APP_ID}"
    app_password: "${TEAMS_APP_PASSWORD}"
    tenant_id: "${TEAMS_TENANT_ID}"

Adaptive Cards

profClaw sends Adaptive Cards for rich interactive responses:

{
  "type": "AdaptiveCard",
  "version": "1.4",
  "body": [
    { "type": "TextBlock", "text": "Task completed", "weight": "Bolder" }
  ],
  "actions": [
    { "type": "Action.Submit", "title": "Acknowledge", "data": { "action": "ack" } }
  ]
}

Notes

Requires a public HTTPS webhook URL - no socket/polling mode available.
Bot Framework handles authentication with Microsoft’s OAuth.
TEAMS_TENANT_ID=common allows the bot to work across any Microsoft 365 organization.
Single-tenant mode: set TEAMS_TENANT_ID to your organization’s tenant ID.
The bot must be in the same Teams app as the channel for it to respond.

Chat Providers Overview - Compare all 27 supported channels
Slack - Slack is the recommended alternative for teams not on Microsoft 365
profclaw tunnel - Expose your local server for development webhook testing
profclaw channels - Enable and test the Teams connection from the CLI

​Capabilities

​Setup

​Environment Variables

​Configuration Example

​Adaptive Cards

​Notes

​Related

Capabilities

Setup

Environment Variables

Configuration Example

Adaptive Cards

Notes

Related