Description
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
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 ~/.n8nInstall the package
npm install n8n-nodes-zaloRestart 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:
🔐 Credentials
The package uses ZaloApi credentials that are automatically created when you use the ZaloLoginQR node. No manual credential setup required!
🛠️ Requirements
📚 Documentation & Support
🤝 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
📦 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 ~/.n8nCài đặt package
npm install n8n-nodes-zaloRestart 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:
🔐 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
📚 Tài liệu & Hỗ trợ
🤝 Đó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
