n8n-nodes-msteams-bot

This is an n8n community node for Microsoft Teams Bot Framework. It lets you send, receive, and manage messages via MS Teams Bot in your n8n workflows.

n8n is a fair-code licensed workflow automation platform.

Features

MS Teams Bot Trigger

Receive messages from Microsoft Teams via webhook:

• 1:1 Chat - Personal messages to the bot
• Channel Chat - Messages in Teams channels (when bot is mentioned)
• Group Chat - Messages in group conversations
• Auto-parse Bot Framework activities
• Filter by conversation type, activity type
• Built-in bot loop prevention
• Multiple output formats (parsed, raw, both)

MS Teams Bot (Action Node)

Send and manage messages via Bot Framework API:

• Message: Send, Update, Delete messages
• Activity: Send typing indicators, custom activities
• Conversation: Create conversations, get members
• Support for text, HTML, and Markdown formats
• Attachments, entities, and suggested actions

Installation

Community Node (Recommended)

1. Go to Settings > Community Nodes in your n8n instance
2. Select Install a community node
3. Enter n8n-nodes-msteams-bot
4. Agree to the risks and click Install

Manual Installation

cd ~/.n8n
npm install n8n-nodes-msteams-bot

Prerequisites

1. Azure Bot Service - Register a bot in Azure Portal
2. Azure AD App Registration - Get App ID and Password
3. Bot Channel Registration - Enable Microsoft Teams channel

Credentials

App ID & Password (OAuth2) - Recommended

• App ID: Microsoft App ID from Azure Bot registration
• App Password: Client secret from Azure AD
• Tenant ID: Azure AD Tenant ID (optional, leave empty for multitenant)

Access Token (Manual)

• Access Token: Bearer token obtained manually

Setup

1. Create Azure Bot

1. Go to Azure Portal
2. Create a new Azure Bot resource
3. Note the App ID and create a Client Secret

2. Configure Messaging Endpoint

Set your bot's messaging endpoint to:

https://your-n8n-domain.com/webhook/<webhook-path>

3. Add to Teams

1. In Azure Bot > Channels, add Microsoft Teams
2. Install the bot in your Teams tenant

4. Create n8n Workflow

1. Add MS Teams Bot Trigger node
2. Copy the webhook URL
3. Set it as the messaging endpoint in Azure Bot
4. Add MS Teams Bot action node to reply

Example Workflow

[MS Teams Bot Trigger] → [MS Teams Bot (Send Message)]

Map these fields from trigger to action:

• Service URL: {{ $json.serviceUrl }}
• Conversation ID: {{ $json.conversationId }}
• Message Text: Your reply text

License

MIT