n8n-nodes-zalo

⚠️ WARNING / CẢNH BÁO

English: This package uses zca-js library to interact with Zalo's unofficial API. Using this API could get your account locked or banned. We are not responsible for any issues that may happen. Use it at your own risk.

Tiếng Việt: Package này sử dụng thư viện zca-js để tương tác với API không chính thức của Zalo. Sử dụng API này có thể khiến tài khoản của bạn bị khóa hoặc cấm. Chúng tôi không chịu trách nhiệm về bất kỳ vấn đề nào có thể xảy ra. Sử dụng với rủi ro của riêng bạn.

English | Tiếng Việt

English

n8n-nodes-zalo is a comprehensive collection of n8n community nodes for integrating Zalo messaging platform with your n8n workflows. Build powerful automation workflows with Zalo's messaging capabilities.

🚀 Features

• ZaloLoginQR: Generate QR code for Zalo authentication and credential management
• ZaloListenMessages: Listen for incoming Zalo messages with long polling
• ZaloSendMessage: Send text messages with support for quotes, mentions, and attachments
• ZaloSendSticker: Send stickers to Zalo conversations
• Full Quote Support: Reply to messages with automatic quote handling
• Attachment Support: Send images and files via public URLs
• Robust Error Handling: Comprehensive logging and fallback mechanisms

📦 Installation

Method 1: n8n Community Package Manager (Recommended)

1. Go to Settings → Community Nodes in your n8n instance
2. Click Install and enter: n8n-nodes-zalo
3. Click Install and restart n8n

Method 2: Manual Installation

# Navigate to your n8n installation directory
cd ~/.n8n

# Install the package
npm install n8n-nodes-zalo

# Restart n8n

Method 3: Docker

# For n8n Docker users
docker exec -it n8n npm install n8n-nodes-zalo
docker restart n8n

🔧 Quick Setup

1. Install the package using one of the methods above
2. Create Zalo credentials:
   • Add ZaloLoginQR node to your workflow
   • (Optional) For auto-save: Create n8n API credential with your API key
   • Execute the node to get QR code
   • Scan QR with Zalo app to authenticate
3. Start building workflows with Zalo nodes

📋 Available Nodes

| Node | Description | Use Case | | ---------------------- | ---------------------------------------- | ------------------------------------- | | ZaloLoginQR | Generate QR code for Zalo authentication | Initial setup and credential creation | | ZaloListenMessages | Listen for incoming messages | Trigger workflows on new messages | | ZaloSendMessage | Send text messages with rich features | Send replies, notifications, alerts | | ZaloSendSticker | Send stickers and emojis | Send fun reactions and responses |

🔗 Common Workflow Patterns

Auto-Reply Bot

ZaloListenMessages → ZaloSendMessage (with quote enabled)

Message Broadcasting

Trigger → ZaloSendMessage (multiple recipients)

Interactive Support Bot

ZaloListenMessages → If Node → ZaloSendMessage/ZaloSendSticker

📝 Message Quote Feature

The ZaloSendMessage node supports three quote modes:

• No Quote: Send regular messages
• Auto Quote: Automatically quote the current message from ZaloListenMessages
• Manual Quote: Manually specify quote parameters (msgId, senderId, content)

🔐 Credentials

The package uses ZaloApi credentials that are automatically created when you use the ZaloLoginQR node. No manual credential setup required!

🛠️ Requirements

• n8n version 0.198.0 or higher
• Node.js 16.x or higher
• Active Zalo account

📚 Documentation & Support

• Issues: GitHub Issues
• Wiki: GitHub Wiki
• Discussions: GitHub Discussions

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines and submit pull requests.

📄 License

MIT License - see the LICENSE file for details.

⚠️ Disclaimer

This package is not officially affiliated with Zalo or VNG Corporation. This package uses the zca-js library to interact with Zalo's unofficial API. Use responsibly and in accordance with Zalo's terms of service.

Tiếng Việt

n8n-nodes-zalo là bộ sưu tập node n8n community toàn diện để tích hợp nền tảng nhắn tin Zalo với các workflow n8n của bạn. Xây dựng các workflow tự động hóa mạnh mẽ với khả năng nhắn tin của Zalo.

🚀 Tính năng

• ZaloLoginQR: Tạo mã QR để xác thực Zalo và quản lý credentials
• ZaloListenMessages: Lắng nghe tin nhắn Zalo đến với long polling
• ZaloSendMessage: Gửi tin nhắn văn bản với hỗ trợ quote, mention và đính kèm
• ZaloSendSticker: Gửi sticker vào cuộc trò chuyện Zalo
• Hỗ trợ Quote đầy đủ: Trả lời tin nhắn với xử lý quote tự động
• Hỗ trợ Đính kèm: Gửi hình ảnh và file qua URL công khai
• Xử lý Lỗi Mạnh mẽ: Logging toàn diện và cơ chế fallback

📦 Cài đặt

Phương pháp 1: n8n Community Package Manager (Khuyên dùng)

1. Vào Settings → Community Nodes trong n8n của bạn
2. Click Install và nhập: n8n-nodes-zalo
3. Click Install và restart n8n

Phương pháp 2: Cài đặt Thủ công

# Chuyển đến thư mục cài đặt n8n
cd ~/.n8n

# Cài đặt package
npm install n8n-nodes-zalo

# Restart n8n

Phương pháp 3: Docker

# Cho người dùng n8n Docker
docker exec -it n8n npm install n8n-nodes-zalo
docker restart n8n

🔧 Thiết lập Nhanh

1. Cài đặt package bằng một trong các phương pháp trên
2. Tạo Zalo credentials:
   • Thêm node ZaloLoginQR vào workflow
   • (Tùy chọn) Để tự động lưu: Tạo n8n API credential với API key
   • Thực thi node để lấy mã QR
   • Quét QR bằng app Zalo để xác thực
3. Bắt đầu xây dựng workflow với các node Zalo

📋 Các Node Có sẵn

| Node | Mô tả | Trường hợp sử dụng | | ---------------------- | -------------------------------------------- | -------------------------------------- | | ZaloLoginQR | Tạo mã QR để xác thực Zalo | Thiết lập ban đầu và tạo credentials | | ZaloListenMessages | Lắng nghe tin nhắn đến | Kích hoạt workflow khi có tin nhắn mới | | ZaloSendMessage | Gửi tin nhắn văn bản với tính năng phong phú | Gửi reply, thông báo, cảnh báo | | ZaloSendSticker | Gửi sticker và emoji | Gửi phản ứng vui và phản hồi |

🔗 Mẫu Workflow Phổ biến

Bot Tự động Trả lời

ZaloListenMessages → ZaloSendMessage (với quote enabled)

Phát sóng Tin nhắn

Trigger → ZaloSendMessage (nhiều người nhận)

Bot Hỗ trợ Tương tác

ZaloListenMessages → If Node → ZaloSendMessage/ZaloSendSticker

📝 Tính năng Quote Tin nhắn

Node ZaloSendMessage hỗ trợ ba chế độ quote:

• No Quote: Gửi tin nhắn thường
• Auto Quote: Tự động quote tin nhắn hiện tại từ ZaloListenMessages
• Manual Quote: Tự chỉ định tham số quote (msgId, senderId, content)

🔐 Credentials

Package sử dụng ZaloApi credentials được tự động tạo khi bạn sử dụng node ZaloLoginQR. Không cần thiết lập credential thủ công!

🛠️ Yêu cầu

• n8n phiên bản 0.198.0 trở lên
• Node.js 16.x trở lên
• Tài khoản Zalo hoạt động

📚 Tài liệu & Hỗ trợ

• Issues: GitHub Issues
• Wiki: GitHub Wiki
• Discussions: GitHub Discussions

🤝 Đóng góp

Chúng tôi chào đón các đóng góp! Vui lòng đọc hướng dẫn đóng góp và gửi pull request.

📄 Giấy phép

Giấy phép MIT - xem file LICENSE để biết chi tiết.

⚠️ Tuyên bố

Package này không liên kết chính thức với Zalo hoặc VNG Corporation. Package này sử dụng thư viện zca-js để tương tác với API không chính thức của Zalo. Sử dụng có trách nhiệm và tuân thủ điều khoản dịch vụ của Zalo.

Keywords

n8n, zalo, messaging, automation, workflow, vietnam, chat, bot, integration, community-nodes