n8n-nodes-zalo-tokado

Một bộ Custom Node mạnh mẽ dành cho n8n giúp tự động hóa toàn diện các thao tác trên Zalo Cá nhân (Zalo Web). Dự án được phát triển và tối ưu hóa dựa trên thư viện zca-js mới nhất, mang lại độ ổn định cao và chống lỗi (bulletproof) tuyệt đối.

🌟 Các Tính Năng Nổi Bật Tối Ưu Mới Nhất

1. Lõi Hệ Thống Hiện Đại Nhất (ZCA-JS 2.2.0)

   • Dự án được ép nâng cấp và khóa cứng vào thư viện lõi zca-js 2.2.0. Mở khóa khả năng tự động hóa 100% mọi tính năng của Zalo với hơn 158 API khác nhau.

2. Auto-Save Credentials (Đăng nhập siêu tốc bằng QR)

   • Không còn cảnh F12 copy-paste từng đoạn mã Cookie hay IMEI thủ công! Chỉ việc kéo thả Node Zalo Login By QR, nhấn chạy và dùng điện thoại quét mã. Hệ thống sẽ TỰ ĐỘNG trích xuất Cookie, sinh IMEI và lưu vào Credentials của n8n.

3. Trigger "Tất Cả Sự Kiện" (Chống Chập Chờn)

   • Node Trigger hỗ trợ bắt Tất cả các loại sự kiện cùng lúc (Tin nhắn, Reaction, Lời mời kết bạn, Thu hồi tin...). Bạn chỉ cần dùng DUY NHẤT 1 Node Trigger trên canvas và dùng Switch Node để rẽ nhánh, giúp tránh triệt để lỗi "chập chờn" do Zalo Web đá văng khi login nhiều luồng (multiple concurrent logins).
   • Cơ chế dọn rác (Garbage Collection) và Auto-Reconnect (với Exponential Backoff) siêu bền bỉ.

4. Quản Lý Bán Hàng & Nhóm Siêu Việt

   • Hỗ trợ đầy đủ các API tiên tiến như: Nâng cấp Cộng Đồng, Bổ nhiệm Phó Nhóm, Tạo Bình Chọn (Poll), Tạo Nhắc Hẹn (Reminder), Quản lý Doanh nghiệp (Biz Catalog, AutoReply), Gửi Thẻ Ngân hàng, v.v.

🧩 Danh Sách Nodes & Chức Năng

1. Zalo Login By QR (Đăng Nhập)

• Tạo mã QR tự động hiển thị trong tab Binary của n8n. Dùng để cấu hình Credentials hoàn toàn tự động.

2. Zalo Message Trigger (Bắt Sự Kiện)

• Bắt và kích hoạt luồng (Workflow) ngay lập tức khi:
  • Có tin nhắn cá nhân mới.
  • Có tin nhắn nhóm mới.
  • Thay đổi trạng thái tin nhắn (Tin nhắn bị thu hồi, Đã xem, Đã nhận).
  • Có người thả Reaction (Tim, Like, Haha...) vào tin nhắn.

3. Zalo Send Message (Gửi Tin Nhắn)

• Gửi tin nhắn văn bản cho bạn bè hoặc nhóm (Dùng Thread ID).
• Hỗ trợ gửi tin nhắn kèm đính kèm tệp (Ảnh, Video, Tài liệu...) bằng cách trỏ đường dẫn tuyệt đối trên máy chủ (Ví dụ: /path/to/image.jpg).

4. Zalo User (Quản Lý Bạn Bè)

Hỗ trợ 9 hành động chuyên sâu:

• Lấy danh sách toàn bộ bạn bè.
• Tìm kiếm người dùng qua Số Điện Thoại.
• Gửi yêu cầu kết bạn (Kèm lời chào).
• Chấp nhận lời mời kết bạn.
• Chặn / Bỏ chặn người dùng.
• Đổi Ảnh đại diện (Avatar).
• Đổi Cài đặt tài khoản (JSON).
• Lấy thông tin chi tiết người dùng.

5. Zalo Group (Quản Lý Nhóm)

Hỗ trợ 9 hành động chuyên sâu:

• Lấy danh sách tất cả các nhóm bạn đang tham gia.
• Tạo nhóm chat mới.
• Lấy thông tin chi tiết nhóm.
• Lấy danh sách thành viên nhóm.
• Thêm thành viên vào nhóm / Xóa thành viên khỏi nhóm.
• Đổi Tên nhóm.
• Đổi Avatar nhóm.
• Thêm Phó nhóm.

⚙️ Hướng Dẫn Cài Đặt

Yêu cầu hệ thống

• Node.js >= 18.x
• npm hoặc pnpm
• Đã cài đặt n8n.

Cài đặt Cục bộ (Local / Docker)

1. Clone dự án này về máy hoặc máy chủ của bạn.
2. Mở terminal tại thư mục dự án và chạy lệnh cài đặt:

   npm install
   

   (Lưu ý: Dự án đã được fix lỗi xung đột ERESOLVE)
3. Biên dịch mã nguồn TypeScript sang JavaScript:

   npm run build
   

4. Liên kết vào thư mục Custom Node của n8n:

   npm link
   cd ~/.n8n/custom
   npm link n8n-nodes-zalo-tokado
   

5. Khởi động lại n8n để nhận diện Node mới.

🚀 Hướng Dẫn Bắt Đầu Nhanh

1. Trong n8n, tạo một Workflow mới.
2. Kéo Node Zalo Login By QR ra, chọn Hành động "Tạo Mã QR".
3. Chạy thử Node đó (Test Step). Một hình ảnh mã QR sẽ xuất hiện trong tab Binary (Cạnh tab JSON output).
4. Dùng ứng dụng Zalo trên điện thoại (Tài khoản clone/phụ) để quét mã.
5. Xong! Hệ thống báo "Đăng nhập thành công" trên Terminal và Credentials "Zalo Cá Nhân" đã tự động xuất hiện trong kho n8n của bạn.
6. Giờ bạn có thể dùng Zalo Message Trigger hoặc các Node khác, vào phần cài đặt Credentials và chọn tài khoản vừa đăng nhập để tự động hóa thôi!

⚠️ Cảnh Báo An Toàn (Disclaimer)

• Việc dùng tool / bot để tự động hóa Zalo cá nhân (Sử dụng ZCA / Giả lập Web) vi phạm điều khoản dịch vụ của Zalo.
• Hệ thống bảo mật của Zalo có thể phát hiện hành vi bất thường và khóa tài khoản của bạn vĩnh viễn mà không báo trước.
• Vui lòng CHỈ SỬ DỤNG VỚI TÀI KHOẢN PHỤ (CLONE) hoặc dùng cho mục đích học tập, nghiên cứu.
• Các nhà phát triển của dự án này KHÔNG chịu bất kỳ trách nhiệm pháp lý hay thiệt hại nào liên quan đến việc tài khoản của bạn bị khóa hoặc mất dữ liệu cá nhân.

📄 Giấy Phép (License)

Dự án được phân phối dưới giấy phép MIT. Hoàn toàn miễn phí để tinh chỉnh và phát triển thêm.