n8n-nodes-msteams-botframework


n8n community node for Microsoft Teams Azure Bot Framework integration. Send messages, Adaptive Cards, and build AI-powered chatbots in Microsoft Teams.

n8n is a fair-code licensed workflow automation platform.

Features

🤖 Complete Bot Framework Integration
- Send text messages and rich Adaptive Cards
- Reply to, update, and delete messages
- Receive webhooks from Teams (messages, reactions, member changes)
- Full Azure Bot Framework Adapter support

🧠 AI-Powered Chatbots
- Seamless integration with n8n AI Agent
- Support for OpenAI, Claude, Azure OpenAI, and more
- Conversation memory (in-memory, Redis, Postgres, Pinecone)
- Function calling and custom tools

⚡ Flexible Response Control
- Immediate webhook responses
- Delayed responses (when workflow completes)
- Manual response control with Respond to Webhook node

Installation

$3

Install directly in n8n:

1. Go to Settings → Community Nodes
2. Click Install
3. Enter n8n-nodes-msteams-botframework
4. Click Install

$3

``bash
npm install n8n-nodes-msteams-botframework
`

For production deployment with zero-downtime, see Production Installation Guide.

Quick Start

$3

1. Create an Azure Bot Service in Azure Portal
2. Get your Microsoft App ID and Microsoft App Password
3. Add credentials in n8n:
- Go to Credentials → New
- Select MS Teams Bot Framework API
- Enter App ID and Password

$3

Add MS Teams Bot Framework node to your workflow:

`
Operation: Send Message
Service URL: https://smba.trafficmanager.net/apis/
Conversation ID: [your-conversation-id]
Message: Hello from n8n!
`

$3

Add MS Teams Bot Trigger node:

1. Copy the webhook URL from the node
2. Configure it in Azure Bot Service → Configuration → Messaging endpoint
3. Your workflow will trigger when users send messages

$3

Use n8n's built-in AI Agent for intelligent conversations:

`
MS Teams Bot Trigger
↓
AI Agent (+ Chat Model + Memory + Tools)
↓
MS Teams Bot (Send Reply)
`

See AI Agent Workflow Guide for detailed setup.

Available Nodes

$3

Operations:
- Send Message - Send text messages to channels or users
- Send Adaptive Card - Send interactive Adaptive Cards
- Reply to Message - Reply to specific messages
- Update Message - Edit existing messages
- Delete Message - Remove messages

$3

Supported Events:
- Message Received
- Conversation Update (members join/leave)
- Message Reaction
- Message Update
- Message Delete

Response Options:
- Immediately (default)
- When Last Node Finishes
- Using Respond to Webhook Node

$3

Custom AI bot node with OpenAI/Claude integration. Note: We recommend using n8n's AI Agent instead for better flexibility.

Documentation

$3

`json
{
"operation": "sendAdaptiveCard",
"serviceUrl": "https://smba.trafficmanager.net/apis/",
"conversationId": "19:meeting_xxx",
"cardJson": {
"type": "AdaptiveCard",
"version": "1.4",
"body": [
{
"type": "TextBlock",
"text": "Hello from n8n!",
"size": "Large",
"weight": "Bolder"
}
]
}
}
`

$3

`
Trigger: MS Teams Bot Trigger
↓
AI Agent:
- Chat Model: OpenAI (gpt-3.5-turbo)
- Memory: Window Buffer Memory (session: conversation.id)
- System: "You are a helpful assistant"
↓
Action: MS Teams Send Reply
`

See AI-AGENT-WORKFLOW-GUIDE.md for complete examples.

Credentials

Create credentials in n8n:

1. Credential Type: MS Teams Bot Framework API
2. Required Fields:
- Microsoft App ID - From Azure Bot Service
- Microsoft App Password - From Azure Bot Service

Get these from Azure Portal → Bot Services → Your Bot → Configuration.

Compatibility

- n8n version: 0.200.0 or later
- Node.js: 18.x or later
- Dependencies:
- botbuilder ^4.20.0
- axios ^1.6.0

Roadmap

$3

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature`)
5. Open a Pull Request

Support

For issues, questions, or feature requests:

- GitHub Issues: github.com/weon-software/n8n-nodes-msteams-botframework/issues
- n8n Community: community.n8n.io
- Email: doannv@weon.vn

License

MIT

Credits

Developed by: Weon Software
Author: Doan Nguyen Van
Email: doannv@weon.vn
Website: https://weon.vn

---

Keywords: n8n, Microsoft Teams, Bot Framework, Azure, chatbot, workflow automation, AI agent, OpenAI, Claude, Adaptive Cards