🚀 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

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: [email protected]

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!