Microsoft Teams Plugin

The Microsoft Teams plugin connects Eliza agents to Teams as an Azure Bot, supporting channel messages, DMs, threaded replies, and media uploads via OneDrive/SharePoint.

Package: @elizaos/plugin-msteams

Installation

bash

eliza plugins install @elizaos/plugin-msteams

Setup

1. Register an Azure Bot

Go to the Azure Portal
Create a new Bot Channels Registration or Azure Bot resource
Note the App ID (Microsoft App ID)
Under Configuration, create a new App Password (client secret)
Note the Tenant ID from Azure Active Directory

2. Configure Bot Messaging Endpoint

Set the messaging endpoint to your Eliza server URL:

https://your-eliza-host/api/msteams/webhook

3. Configure Eliza

json

{
  "connectors": {
    "msteams": {
      "enabled": true,
      "appId": "YOUR_APP_ID",
      "appPassword": "YOUR_APP_PASSWORD",
      "tenantId": "YOUR_TENANT_ID",
      "dmPolicy": "pairing"
    }
  }
}

Or via environment variables:

bash

export MSTEAMS_APP_ID=YOUR_APP_ID
export MSTEAMS_APP_PASSWORD=YOUR_APP_PASSWORD
export MSTEAMS_TENANT_ID=YOUR_TENANT_ID

Configuration

Field	Required	Description
`appId`	Yes	Azure Bot App ID
`appPassword`	Yes	Azure Bot App Password (client secret)
`tenantId`	Yes	Azure AD Tenant ID
`replyStyle`	No	`thread` or `top-level` (default: `thread`)
`webhookPort`	No	Port for incoming webhooks
`webhookPath`	No	Path for webhook endpoint
`mediaHostAllowlist`	No	Allowed hosts for media downloads
`mediaAuthHosts`	No	Hosts requiring auth for media downloads
`sharepointSiteId`	No	SharePoint site ID for file uploads in group chats
`dmPolicy`	No	DM handling policy
`allowFrom`	No	Array of allowed user IDs (for open DM policy)

Features

Channel messages — Responds to @mentions in team channels
DMs — Full private conversation support
Threaded replies — Configurable thread vs top-level reply style
Per-team configuration — Override settings per team and per channel
Media support — Upload files up to 100MB via OneDrive integration
SharePoint integration — File uploads in group chats via SharePoint site
Media host allowlists — Control which hosts can serve downloadable media

Environment Variables

Variable	Required	Description
`MSTEAMS_APP_ID`	No	Azure Bot App ID
`MSTEAMS_ENABLED`	No	Enable or disable the connector
`MSTEAMS_TENANT_ID`	No	Azure AD Tenant ID
`MSTEAMS_APP_PASSWORD`	Yes	Azure Bot App Password (client secret)
`MSTEAMS_MEDIA_MAX_MB`	No	Maximum media upload size in MB
`MSTEAMS_WEBHOOK_PATH`	No	Webhook endpoint path
`MSTEAMS_WEBHOOK_PORT`	No	Webhook listener port
`MSTEAMS_ALLOWED_TENANTS`	No	Comma-separated allowed tenant IDs
`MSTEAMS_SHAREPOINT_SITE_ID`	No	SharePoint site ID for file uploads

Auto-Enable

The plugin auto-enables when the connectors.msteams block contains botToken, token, or apiKey. Note that appId and appPassword alone do not trigger auto-enable -- set botToken to the app password to trigger auto-enable, or add the plugin to plugins.allow explicitly.

Troubleshooting

Bot Not Responding

Verify the messaging endpoint URL is publicly accessible and points to your Eliza server's webhook path.

Authentication Errors

Ensure the App Password has not expired. Azure Bot client secrets have configurable expiry periods.

Slack Plugin — Slack workspace integration
Google Chat Plugin — Google Chat integration
Connectors Guide — General connector documentation