n8n-nodes-msteams-botframework 1.2.2 → 1.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Weon Software
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,113 +1,160 @@
 # n8n-nodes-msteams-botframework
 
-Custom n8n node để tương tác với Microsoft Teams thông qua Azure Bot Framework.
+[![npm version](https://badge.fury.io/js/n8n-nodes-msteams-botframework.svg)](https://www.npmjs.com/package/n8n-nodes-msteams-botframework)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-## Tính năng
+n8n community node for Microsoft Teams Azure Bot Framework integration. Send messages, Adaptive Cards, and build AI-powered chatbots in Microsoft Teams.
 
-### MS Teams Bot (Action Node)
-- ✉️ Gửi tin nhắn text đến channel hoặc user
-- 🎴 Gửi Adaptive Cards
-- 💬 Reply vào tin nhắn cụ thể
-- ✏️ Cập nhật tin nhắn đã gửi
-- 🗑️ Xóa tin nhắn
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
 
-### MS Teams Bot Trigger (NEW in v1.1.0) 🎣
-- 📥 Nhận tin nhắn từ Teams qua webhook
-- 👥 Nhận thông báo khi có người join/leave
-- 👍 Nhận reactions vào tin nhắn
-- ✏️ Nhận thông báo khi message được edit
-- 🗑️ Nhận thông báo khi message bị xóa
-- 🤖 Tự động filter bot messages
-- ⌨️ Tự động gửi typing indicator
+## Features
 
-## Yêu cầu
+🤖 **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
 
-- n8n version 0.187.0 trở lên
-- Azure Bot Service đã được cấu hình
-- Microsoft App ID và App Password
+🧠 **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
 
-## Cài đặt
+⚡ **Flexible Response Control**
+- Immediate webhook responses
+- Delayed responses (when workflow completes)
+- Manual response control with Respond to Webhook node
 
-### Cài đặt trong n8n Community Node
+## Installation
 
-1. Trong n8n, vào **Settings** > **Community Nodes**
-2. Chọn **Install** và nhập: `n8n-nodes-msteams-botframework`
-3. Chấp nhận rủi ro và cài đặt
+### Community Nodes (Recommended)
 
-### Cài đặt từ source (Development)
+Install directly in n8n:
+
+1. Go to **Settings → Community Nodes**
+2. Click **Install**
+3. Enter `n8n-nodes-msteams-botframework`
+4. Click **Install**
+
+### Manual Installation
 
 ```bash
-# Clone repository
-git clone <repository-url>
-cd n8n-nodes-msteams-botframework
+npm install n8n-nodes-msteams-botframework
+```
+
+For production deployment with zero-downtime, see [Production Installation Guide](INSTALL-PRODUCTION.md).
+
+## 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
 
-# Cài đặt dependencies
-npm install
+### 2. Send a Message
 
-# Build
-npm run build
+Add **MS Teams Bot Framework** node to your workflow:
 
-# Link vào n8n local
-npm link
-cd ~/.n8n/custom
-npm link n8n-nodes-msteams-botframework
+```
+Operation: Send Message
+Service URL: https://smba.trafficmanager.net/apis/
+Conversation ID: [your-conversation-id]
+Message: Hello from n8n!
 ```
 
-## Cấu hình Azure Bot Service
+### 3. Receive Messages (Webhook)
 
-### 1. Tạo Azure Bot
+Add **MS Teams Bot Trigger** node:
 
-1. Đăng nhập vào [Azure Portal](https://portal.azure.com)
-2. Tạo **Azure Bot** resource mới
-3. Chọn **Type of App**: Multi Tenant
-4. Sau khi tạo, vào **Configuration** để lấy thông tin:
-   - **Microsoft App ID**
-   - **Microsoft App Password** (Client Secret)
+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
 
-### 2. Cấu hình Teams Channel
+### 4. Build AI Chatbot
 
-1. Trong Azure Bot, vào **Channels**
-2. Thêm **Microsoft Teams** channel
-3. Chấp nhận Terms of Service
-4. Enable channel
+Use n8n's built-in AI Agent for intelligent conversations:
 
-### 3. Cấu hình Messaging Endpoint (Nếu cần nhận webhook)
+```
+MS Teams Bot Trigger
+  ↓
+AI Agent (+ Chat Model + Memory + Tools)
+  ↓
+MS Teams Bot (Send Reply)
+```
 
-1. Vào **Configuration** > **Messaging endpoint**
-2. Nhập URL: `https://your-n8n-instance.com/webhook/msteams`
-3. Lưu thay đổi
+See [AI Agent Workflow Guide](AI-AGENT-WORKFLOW-GUIDE.md) for detailed setup.
 
-## Sử dụng trong n8n
+## Available Nodes
 
-### 1. Tạo Credentials
+### MS Teams Bot Framework (Action Node)
 
-1. Trong n8n workflow, thêm node **MS Teams Bot Framework**
-2. Tạo credential mới:
-   - **Microsoft App ID**: Paste App ID từ Azure
-   - **Microsoft App Password**: Paste App Password từ Azure
-3. Lưu credential
+**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
 
-### 2. Gửi tin nhắn đơn giản
+### MS Teams Bot Trigger (Trigger Node)
 
-```json
-{
-  "operation": "sendMessage",
-  "serviceUrl": "https://smba.trafficmanager.net/amer/",
-  "conversationId": "19:meeting_xxx...",
-  "messageText": "Hello from n8n!"
-}
-```
+**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](QUICKSTART.md) - Get started in 5 minutes
+- [Production Quick Start](PRODUCTION-QUICKSTART.md) - Deploy to production
 
-### 3. Gửi Adaptive Card
+### Installation Guides
+- [Detailed Installation (Vietnamese)](HUONG-DAN-CAI-DAT.md)
+- [Production Installation](INSTALL-PRODUCTION.md)
+- [Quick Installation](INSTALL-QUICK.md)
+
+### AI & Advanced Features
+- [AI Agent Workflow Guide](AI-AGENT-WORKFLOW-GUIDE.md) - Build AI chatbots (Recommended)
+- [AI Chatbot Guide](AI-CHATBOT-GUIDE.md) - Legacy custom AI bot
+- [Webhook Guide](WEBHOOK-GUIDE.md) - Receive Teams events
+
+### Technical Documentation
+- [Project Structure (Vietnamese)](CAU-TRUC-DU-AN.md)
+- [NPM Publishing Guide](PUBLISH-NPM-GUIDE.md)
+- [Changelog](CHANGELOG.md)
+
+### Example Workflows
+- [Basic Workflow](example-workflow.json) - Send messages and cards
+- [Webhook Workflow](example-webhook-workflow.json) - Receive and respond to messages
+- [AI Agent Complete](example-ai-agent-complete.json) - Full AI chatbot setup
+
+## Usage Examples
+
+### Send an Adaptive Card
 
 ```json
 {
   "operation": "sendAdaptiveCard",
-  "serviceUrl": "https://smba.trafficmanager.net/amer/",
-  "conversationId": "19:meeting_xxx...",
-  "adaptiveCardJson": {
+  "serviceUrl": "https://smba.trafficmanager.net/apis/",
+  "conversationId": "19:meeting_xxx",
+  "cardJson": {
     "type": "AdaptiveCard",
-    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
     "version": "1.4",
     "body": [
       {
@@ -115,126 +162,87 @@ npm link n8n-nodes-msteams-botframework
         "text": "Hello from n8n!",
         "size": "Large",
         "weight": "Bolder"
-      },
-      {
-        "type": "TextBlock",
-        "text": "This is an Adaptive Card",
-        "wrap": true
-      }
-    ],
-    "actions": [
-      {
-        "type": "Action.OpenUrl",
-        "title": "Learn More",
-        "url": "https://n8n.io"
       }
     ]
   }
 }
 ```
 
-### 4. Reply vào tin nhắn
+### AI Chatbot with Memory
 
-```json
-{
-  "operation": "replyToMessage",
-  "serviceUrl": "https://smba.trafficmanager.net/amer/",
-  "conversationId": "19:meeting_xxx...",
-  "activityId": "1234567890",
-  "replyText": "This is a reply!"
-}
+```
+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
 ```
 
-## Lấy thông tin cần thiết
-
-### Service URL
-
-Service URL thường có trong webhook payload từ Teams. Các giá trị phổ biến:
-- `https://smba.trafficmanager.net/amer/` (Americas)
-- `https://smba.trafficmanager.net/emea/` (Europe/Middle East/Africa)
-- `https://smba.trafficmanager.net/apac/` (Asia Pacific)
-
-### Conversation ID
-
-Conversation ID có thể lấy từ:
-- Webhook payload khi nhận tin nhắn từ Teams
-- Teams URL (phần sau `conversations/`)
-- Graph API
-
-Ví dụ: `19:meeting_MjdhNjc4...@thread.v2`
+See [AI-AGENT-WORKFLOW-GUIDE.md](AI-AGENT-WORKFLOW-GUIDE.md) for complete examples.
 
-### Activity ID
+## Credentials
 
-Activity ID là ID của tin nhắn, có thể lấy từ:
-- Response khi gửi tin nhắn (trả về `activityId`)
-- Webhook payload khi nhận tin nhắn
+Create credentials in n8n:
 
-## Ví dụ Workflow
+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
 
-### Workflow 1: Nhận webhook và reply
+Get these from Azure Portal → Bot Services → Your Bot → Configuration.
 
-```
-Webhook Trigger (MS Teams)
-  ↓
-MS Teams Bot Framework (Reply to Message)
-  ↓
-[Success]
-```
+## Compatibility
 
-### Workflow 2: Schedule message với Adaptive Card
+- **n8n version:** 0.200.0 or later
+- **Node.js:** 18.x or later
+- **Dependencies:**
+  - `botbuilder` ^4.20.0
+  - `axios` ^1.6.0
 
-```
-Schedule Trigger (Cron)
-  ↓
-MS Teams Bot Framework (Send Adaptive Card)
-  ↓
-[Success]
-```
+## Roadmap
 
-### Workflow 3: Theo dõi GitHub và thông báo Teams
+### Planned Features
+- File attachments support
+- Bot mentions (@bot)
+- Proactive messaging
+- Meeting notifications
+- Calendar integration
+- Graph API integration
 
-```
-GitHub Trigger (On Push)
-  ↓
-Function (Format message)
-  ↓
-MS Teams Bot Framework (Send Message)
-  ↓
-[Success]
-```
+See [CHANGELOG.md](CHANGELOG.md) for version history and upcoming features.
 
-## Troubleshooting
+## Contributing
 
-### Lỗi 401 Unauthorized
-- Kiểm tra lại App ID và App Password
-- Đảm bảo Bot đã được add vào Team/Channel
-- Verify token chưa hết hạn
+Contributions are welcome! Please feel free to submit a Pull Request.
 
-### Lỗi 404 Not Found
-- Kiểm tra Service URL có đúng không
-- Verify Conversation ID còn tồn tại
-- Đảm bảo bot còn trong conversation
+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
 
-### Adaptive Card không hiển thị
-- Validate JSON schema tại [Adaptive Cards Designer](https://adaptivecards.io/designer/)
-- Kiểm tra version phù hợp với Teams (khuyến nghị 1.4)
-- Đảm bảo cú pháp JSON đúng
+## Support
 
-## Tài liệu tham khảo
+For issues, questions, or feature requests:
 
-- [Azure Bot Service Documentation](https://docs.microsoft.com/en-us/azure/bot-service/)
-- [Bot Framework REST API](https://docs.microsoft.com/en-us/azure/bot-service/rest-api/bot-framework-rest-connector-api-reference)
-- [Adaptive Cards](https://adaptivecards.io/)
-- [Teams Bot Overview](https://docs.microsoft.com/en-us/microsoftteams/platform/bots/what-are-bots)
+- **GitHub Issues:** [github.com/weon-software/n8n-nodes-msteams-botframework/issues](https://github.com/weon-software/n8n-nodes-msteams-botframework/issues)
+- **n8n Community:** [community.n8n.io](https://community.n8n.io/)
+- **Email:** doannv@weon.vn
 
-## Đóng góp
+## License
 
-Contributions, issues và feature requests đều được chào đón!
+[MIT](LICENSE)
 
-## License
+## Credits
 
-MIT
+**Developed by:** [Weon Software](https://weon.vn)  
+**Author:** Doan Nguyen Van  
+**Email:** doannv@weon.vn  
+**Website:** https://weon.vn
 
-## Tác giả
+---
 
-Tạo bởi cộng đồng n8n
+**Keywords:** n8n, Microsoft Teams, Bot Framework, Azure, chatbot, workflow automation, AI agent, OpenAI, Claude, Adaptive Cards

package/dist/nodes/MsTeamsBotFramework/MsTeamsBotFrameworkTrigger.node.js

@@ -194,10 +194,12 @@ class MsTeamsBotFrameworkTrigger {
                 const activity = context.activity;
                 // Check if we should process this activity type
                 if (!events.includes(activity.type)) {
+                    shouldTrigger = false;
                     return;
                 }
                 // Ignore bot messages if configured
                 if (options.ignoreBotMessages && ((_a = activity.from) === null || _a === void 0 ? void 0 : _a.role) === 'bot') {
+                    shouldTrigger = false;
                     return;
                 }
                 shouldTrigger = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-msteams-botframework",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "n8n node for MS Teams Azure Bot Framework",
   "keywords": [
     "n8n-community-node-package",