n8n-nodes-mtai-zalo-test-trial

Các node hỗ trợ tích hợp Zalo vào nền tảng n8n.

📦 Cài đặt

pnpm install n8n-nodes-mtai-zalo-test-trial

Yêu cầu:

• Node.js ≥ 18.10
• n8n ≥ 1.0.0

🔐 Cấu hình Credentials

1. Sử dụng node ZaloLoginByQr để quét mã QR và lấy thông tin xác thực:

   • cookie
   • imei
   • userAgent

2. Credential được tạo sẽ dùng cho các node Zalo còn lại trong workflow.

✅ Các node đã hoàn chỉnh

1. ZaloLoginByQr

• Chức năng: Đăng nhập Zalo bằng mã QR để lấy thông tin xác thực.
• Cách dùng:
  • Thêm node vào workflow.
  • Làm theo hướng dẫn để quét QR và thu thập thông tin login.

2. ZaloSendMessage

• Chức năng: Gửi tin nhắn đến người dùng hoặc nhóm trên Zalo.
• Cách dùng:
  • Cấu hình userId hoặc groupId.
  • Nhập nội dung tin nhắn (hỗ trợ gửi text, ảnh, file...).

3. ZaloUser

• Chức năng: Lấy thông tin chi tiết của người dùng Zalo.
• Cách dùng:
  • Nhập userId để truy xuất thông tin người dùng.

4. ZaloGroup

• Chức năng: Truy xuất thông tin nhóm Zalo, bao gồm danh sách thành viên.
• Cách dùng:
  • Nhập groupId để lấy dữ liệu liên quan đến nhóm.

5. ZaloMessageTrigger

• Chức năng:
  • Theo dõi và kích hoạt workflow khi có tin nhắn mới từ người dùng hoặc nhóm.
  • Chuyển đổi giọng nói sang text.
• Cách dùng:
  • Cấu hình loại sự kiện (message.user, message.group, v.v).
  • Node sẽ tự động kích hoạt khi có tin nhắn đến.
  • Chức năng chuyển giọng nói sang text yêu cầu thêm WitAiApi credential còn nếu không có mình có thể dùng Vosk
• Lưu ý:
  • Tin nhắn giọng nói (chat.voice) hiện chỉ được nhận diện chứ chưa hỗ trợ chuyển đổi thành văn bản.
  • WitAiApi credentiald bắt buộc phải có AccessToken từ trang wit.ai
  • Hiện tại chức năng nghe hiểu của vosk về tiếng Việt không quá hiệu quả

6. ZaloFriendTrigger

• Chức năng: Theo dõi các sự kiện liên quan đến bạn bè (kết bạn, hủy kết bạn,...).
• Cách dùng:
  • Thêm node này vào workflow để lắng nghe các sự kiện liên quan.

📝 Ghi chú

• Một số tính năng nâng cao như chuyển đổi voice thành text (speech-to-text) đang được phát triển.
• Nếu gặp lỗi cài đặt:
  • Kiểm tra quyền truy cập file
  • Chạy với quyền admin (nếu cần)
  • Đảm bảo không có tiến trình nào đang khóa file

👨‍💻 Liên hệ & Đóng góp

Đóng góp mã nguồn, bug report, hoặc ý tưởng xin gửi về repo hoặc liên hệ tác giả.