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

Community Nodes (Recommended)

Install directly in n8n:

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

Manual Installation

npm install n8n-nodes-msteams-botframework

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

Quick Start

1. Setup Azure Bot

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

2. Send a Message

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. Receive Messages (Webhook)

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

4. Build AI Chatbot

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

MS Teams Bot Framework (Action Node)

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

MS Teams Bot Trigger (Trigger Node)

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

MS Teams AI Bot (Legacy)

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

Documentation

Getting Started

• Quick Start Guide - Get started in 5 minutes
• Production Quick Start - Deploy to production

Installation Guides

• Detailed Installation (Vietnamese)
• Production Installation
• Quick Installation

AI & Advanced Features

• AI Agent Workflow Guide - Build AI chatbots (Recommended)
• AI Chatbot Guide - Legacy custom AI bot
• Webhook Guide - Receive Teams events

Technical Documentation

• Project Structure (Vietnamese)
• NPM Publishing Guide
• Changelog

Example Workflows

• Basic Workflow - Send messages and cards
• Webhook Workflow - Receive and respond to messages
• AI Agent Complete - Full AI chatbot setup

Usage Examples

Send an Adaptive Card

{
  "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"
      }
    ]
  }
}

AI Chatbot with Memory

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

Planned Features

• File attachments support
• Bot mentions (@bot)
• Proactive messaging
• Meeting notifications
• Calendar integration
• Graph API integration

See CHANGELOG.md for version history and upcoming features.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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