n8n-nodes-thang-zalo-app
Version:
Các node udng2 để hỗ trợ người dùng zalo
240 lines (169 loc) • 9.21 kB
Markdown
# 🚀 n8n-nodes-zalo-test-trial
**Kết nối Zalo vào thế giới tự động hóa của bạn với n8n!**
Tích hợp Zalo cá nhân, nhóm, bạn bè, tin nhắn, voice-to-text, đăng nhập QR... chỉ với vài cú click.
Tối ưu cho chatbot, CRM, automation, chăm sóc khách hàng, cảnh báo nội bộ, và hơn thế nữa!
## 🌟 Tại sao nên chọn bộ node Zalo này?
- **Đầy đủ tính năng:** Gửi/nhận tin nhắn, quản lý nhóm, bạn bè, voice-to-text đa ngôn ngữ, đăng nhập QR, v.v.
- **Dễ dùng:** Kéo thả, cấu hình trực quan, không cần code phức tạp.
- **Tối ưu cho workflow hiện đại:** Kết hợp linh hoạt với các node khác của n8n.
- **Chuẩn hóa voice kéo dài:** Nhận diện tốt tiếng Việt dù nói “đi đâyyyyyy”.
- **Mở rộng dễ dàng:** Hỗ trợ nhiều tài khoản, nhiều ngôn ngữ, nhiều kịch bản.
## 🚦 Tính năng nổi bật
### 🔑 Đăng nhập Zalo bằng QR code
- Đăng nhập siêu nhanh, không cần copy cookie thủ công.
- Lưu Credential tự động, dùng lại cho mọi node Zalo khác.
- Hỗ trợ nhiều tài khoản, proxy, quản lý Credential thông minh.
### 👤 Quản lý người dùng Zalo
- Gửi/kết bạn, chặn/bỏ chặn, đổi avatar, cập nhật thông tin cá nhân.
- Lấy thông tin chi tiết user, trạng thái, avatar, v.v.
### 💬 Gửi & nhận tin nhắn Zalo
- Gửi tin nhắn text, ảnh, file, nhắc tên, trích dẫn, typing...
- Lắng nghe tin nhắn từ user hoặc group, tự động kích hoạt workflow.
- Hỗ trợ voice-to-text: nhận diện tiếng Việt, Anh, Trung (tự động hoặc thủ công).
- Chuẩn hóa text voice kéo dài, trả về cả text, ngôn ngữ và độ tin cậy.
### 👥 Quản lý nhóm Zalo
- Tạo nhóm, thêm/xóa thành viên, đổi tên/avatar nhóm, phân quyền quản trị.
- Lấy thông tin nhóm, danh sách thành viên, quản trị viên.
### 🤝 Lắng nghe sự kiện bạn bè
- Tự động phát hiện kết bạn mới, kích hoạt workflow khi có lời mời.
## ⚡️ Cài đặt siêu tốc
```bash
pnpm install
# hoặc
npm install
```
**Yêu cầu:**
- Node.js >= 16
- n8n >= 1.0.0
- Đã cài ffmpeg (bắt buộc cho voice-to-text)
- Tài khoản Zalo cá nhân
## 🛠️ Hướng dẫn sử dụng nhanh
1. **Đăng nhập Zalo:**
- Dùng node “Zalo Login Via QR Code” để đăng nhập, Credential sẽ tự lưu.
2. **Cấu hình Credential:**
- Có thể nhập cookie/imei/userAgent thủ công hoặc dùng Credential đã lưu.
3. **Cấu hình Wit.ai (voice-to-text):**
- Đăng ký Wit.ai, tạo app cho từng ngôn ngữ (vi, en, zh).
- Lấy Server Access Token, nhập vào Credential WitAIApi.
4. **Kéo thả các node Zalo vào workflow:**
- Gửi/nhận tin nhắn, quản lý nhóm, bạn bè, voice-to-text...
- Kết nối với các node khác để xây dựng quy trình tự động hóa mạnh mẽ.
## 💡 Lưu ý kỹ thuật
- Voice-to-text chỉ hoạt động với voice message .aac (chuẩn Zalo).
- Cần cài ffmpeg trên máy chủ/server.
- Tự động nhận diện ngôn ngữ cần ít nhất 1 token Wit.ai hợp lệ.
- Nếu workflow chạy trên server, đảm bảo server có internet.
## 🤝 Đóng góp & Phản hồi
- Gặp lỗi? Có ý tưởng mới?
→ Tạo issue hoặc pull request ngay trên GitHub!
- Đội ngũ phát triển luôn lắng nghe và chào đón mọi đóng góp.
## 📬 Liên hệ
- **Tác giả:** Nguyễn Thắng
- **Email:** ntnguyenthangtn@gmail.com
> **Hãy để Zalo trở thành một phần của hệ sinh thái tự động hóa của bạn!**
> _n8n-nodes-zalo-test-trial - Đơn giản hóa mọi kết nối, bứt phá mọi workflow!_
## 🧩 Hướng dẫn chi tiết từng node Zalo
### 1. 🔑 Zalo Login Via QR Code
**Chức năng:**
Đăng nhập tài khoản Zalo cá nhân bằng mã QR, lưu Credential tự động cho các node khác.
**Cách dùng:**
- Thêm node “Zalo Login Via QR Code” vào workflow.
- Chạy node, quét mã QR hiện ra bằng app Zalo trên điện thoại.
- Sau khi đăng nhập thành công, Credential sẽ được lưu lại (không cần nhập cookie thủ công nữa).
**Tips:**
- Có thể dùng cho nhiều tài khoản Zalo khác nhau, mỗi tài khoản một Credential riêng.
- Credential này sẽ dùng cho tất cả các node Zalo khác trong workflow.
### 2. 👤 Zalo User
**Chức năng:**
Quản lý tài khoản cá nhân, bạn bè, thông tin user.
**Các thao tác nổi bật:**
- Gửi lời mời kết bạn, chấp nhận/kết bạn.
- Chặn, bỏ chặn người dùng.
- Đổi avatar, cập nhật thông tin cá nhân.
- Lấy thông tin chi tiết user (ID, tên, trạng thái, avatar...).
**Cách dùng:**
- Thêm node “Zalo User” vào workflow.
- Chọn Credential Zalo đã đăng nhập.
- Chọn thao tác muốn thực hiện (ví dụ: “Send Friend Request”, “Get User Info”, ...).
- Nhập các thông tin cần thiết (userId, avatar URL, ...).
**Ví dụ:**
- Gửi lời mời kết bạn tự động cho danh sách số điện thoại.
- Lấy thông tin bạn bè để đồng bộ với hệ thống CRM.
### 3. 💬 Zalo Send Message
**Chức năng:**
Gửi tin nhắn tới user hoặc group trên Zalo.
**Các tính năng:**
- Gửi text, ảnh, file, nhắc tên, trích dẫn tin nhắn cũ.
- Gửi nhiều ảnh cùng lúc qua URL.
- Gửi sự kiện “đang nhập” (typing) để tăng trải nghiệm người nhận.
**Cách dùng:**
- Thêm node “Zalo Send Message” vào workflow.
- Chọn Credential Zalo.
- Chọn loại đối tượng gửi (user hoặc group).
- Nhập ID người nhận hoặc group, nội dung tin nhắn, file/ảnh nếu có.
**Ví dụ:**
- Gửi thông báo tự động cho nhóm khi có sự kiện mới.
- Gửi file báo cáo PDF cho từng user.
### 4. 💬 Zalo Message Trigger
**Chức năng:**
Lắng nghe tin nhắn mới từ user hoặc group, tự động kích hoạt workflow.
**Các tính năng nổi bật:**
- Lắng nghe tin nhắn text, ảnh, file, voice.
- Hỗ trợ voice-to-text: tự động nhận diện ngôn ngữ (Việt, Anh, Trung) hoặc chọn thủ công.
- Chuẩn hóa text voice kéo dài, trả về cả text, ngôn ngữ và độ tin cậy.
- Tùy chọn lắng nghe cả tin nhắn do chính mình gửi (self listen).
**Cách dùng:**
- Thêm node “Zalo Message Trigger” vào workflow.
- Chọn Credential Zalo.
- Chọn loại tin nhắn muốn lắng nghe (user, group).
- Bật/tắt voice-to-text, chọn chế độ nhận diện ngôn ngữ.
- Kết nối node này với các node xử lý tiếp theo (ví dụ: gửi email, lưu database, gọi API...).
**Ví dụ:**
- Khi có ai nhắn “báo cáo” vào group, tự động gửi file báo cáo mới nhất.
- Khi nhận voice message, tự động chuyển thành text và gửi sang hệ thống khác.
### 5. 👥 Zalo Group
**Chức năng:**
Quản lý nhóm Zalo.
**Các thao tác:**
- Tạo nhóm mới, thêm/xóa thành viên, đổi tên/avatar nhóm.
- Lấy thông tin nhóm, danh sách thành viên, quản trị viên.
- Phân quyền quản trị, thêm phó nhóm.
**Cách dùng:**
- Thêm node “Zalo Group” vào workflow.
- Chọn Credential Zalo.
- Chọn thao tác muốn thực hiện (tạo nhóm, thêm thành viên, lấy info...).
- Nhập các thông tin cần thiết (tên nhóm, userId, ...).
**Ví dụ:**
- Tạo nhóm mới cho dự án, tự động thêm thành viên từ danh sách.
- Lấy danh sách thành viên nhóm để gửi thông báo cá nhân hóa.
### 6. 🤝 Zalo Friend Trigger
**Chức năng:**
Lắng nghe sự kiện kết bạn mới, tự động kích hoạt workflow khi có lời mời kết bạn đến.
**Cách dùng:**
- Thêm node “Zalo Friend Trigger” vào workflow.
- Chọn Credential Zalo.
- Kết nối với các node xử lý tiếp theo (gửi tin nhắn chào mừng, lưu thông tin bạn mới...).
**Ví dụ:**
- Khi có bạn mới, tự động gửi tin nhắn chào mừng và hướng dẫn sử dụng dịch vụ.
- Lưu thông tin bạn mới vào Google Sheet hoặc CRM.
## 📌 Lưu ý chung khi sử dụng các node
- Luôn chọn đúng Credential Zalo cho từng node.
- Đảm bảo đã đăng nhập thành công bằng QR hoặc nhập đúng cookie/imei/userAgent.
- Đối với voice-to-text, cần cấu hình token Wit.ai hợp lệ cho từng ngôn ngữ.
- Có thể kết hợp các node Zalo với bất kỳ node nào khác của n8n để xây dựng workflow mạnh mẽ, sáng tạo!