n8n-nodes-ultimate

👤 Tác Giả

Github: codedao12
Video hướng dẫn: xem video
Nhóm Zalo hỗ trợ: truy cập nhóm
Vui lòng liên hệ để hỗ trợ hoặc báo lỗi.

📋 Giới Thiệu

Zalo User

• Hơn +80 tính năng tự động hoá Zalo cá nhân với n8n.
• Expression Zalo Credential giúp giảm số lượng nút trùng lặp.
• Credential tự động được cập nhật khi login lại tài khoản.
• Tổng hợp sự kiện Media Group thành 1 output duy nhất.
• Tham số filter trong trigger giúp dễ dàng phần luồng messageType.
• Không dùng API của bên thứ ba, chạy trong môi trường n8n của bạn, đảm bảo riêng tư và an toàn.

Zalo Bot

• Tích hợp đầy đủ Zalo Bot Api để tạo chatbot chăm sóc Khách hàng (tạo từ Zalo Bot Manager).
• Quản lý webhook, nhận sự kiện.
• Tương tác bằng tin nhắn, gửi ảnh, sticker, hành động..
• Sử dụng API chính thống do Zalo cung cấp.

Node Gôm Tin Nhắn

• Message Debounce: Chờ gôm tin nhắn tối ưu trải nghiệm chatbot.
• Phù hợp tuỳ chỉnh cho mọi nền tảng khác fb, telegram, tiktok..

✨ Tính Năng Của Zalo User

| | 🔑 XÁC THỰC & KẾT NỐI | |:------:|:--------------------------------------------------------| | ☑️ | Đăng nhập bằng Mã QR | | ☑️ | Hỗ trợ đăng nhập nhiều tài khoản, proxy | | ✅ | Expression Zalo Credential | | ✅ | Tự động cập nhật Credential khi phải login lại | | ✅ | Thông báo QR, lỗi qua telegram | | | ⚡ TRIGGER | | ☑️ | Sự kiện nhắn tin (lọc nhóm, từ khoá, self listen) | | ☑️ | Sự kiện kết bạn, nhóm (tham gia, rời, đổi quyền,...) | | ☑️ | Sự kiện thu hồi, thả cảm xúc, đã xem, thả tim, soạn tin | | ✅ | Tham số filter giúp output thân thiện hơn | | ✅ | Gôm nhóm media thành 1 sự kiện duy nhất | | ✅ | Cơ chế tránh mất kết nối và khởi động lại trigger | | | 💬 NHẮN TIN | | ☑️ | Gửi tin nhắn (Văn bản, Ảnh, Sticker) | | ☑️ | Trả lời tin nhắn (Quote) | | ☑️ | Tag @All hoặc thành viên trong nhóm | | ☑️ | Mô phỏng trạng thái "Đang soạn tin..." | | ✅ | Thả/Gỡ cảm xúc (Reaction) vào tin nhắn | | ✅ | Gửi multi Image, Video, PDF, Voice | | ✅ | Gửi Danh thiếp, thẻ ngân hàng | | | 👤 TÀI KHOẢN & BẠN BÈ | | ☑️ | Gửi / Hủy lời mời kết bạn | | ☑️ | Chấp nhận / Từ chối lời mời kết bạn | | ☑️ | Hủy kết bạn (xóa bạn) | | ☑️ | Lấy danh sách bạn bè & lời mời đã gửi | | ☑️ | Cập nhật thông tin cá nhân (name, gender, avatar..) | | ☑️ | Tìm người dùng bằng SĐT hoặc User ID | | ☑️ | Lấy thông tin chi tiết người dùng | | ☑️ | Chặn / Bỏ chặn người dùng | | ☑️ | Thu hồi tin nhắn đã gửi | | ✅ | Tạo nhắc hẹn (reminder) | | ✅ | Chuyển tiếp tin nhắn tới nhiều người/nhóm | | ✅ | Lấy danh sách tin nhắn cũ | | ✅ | Xóa tin nhắn của User/Group | | ✅ | Tắt mở thông báo User/Group | | ✅ | Cập nhật quyền riêng tư | | | 👥 QUẢN LÝ NHÓM | | ☑️ | Tạo nhóm, giải tán, rời nhóm | | ☑️ | Bổ nhiệm/Xoá quyền Phó nhóm | | ☑️ | Lấy danh sách tất cả các nhóm đã tham gia | | ☑️ | Lấy thông tin nhóm (từ ID hoặc link) | | ☑️ | Tham gia nhóm bằng link / Rời nhóm | | ☑️ | Tạo/Chỉnh sửa ghi chú (Note) trong nhóm | | ☑️ | Cập nhật tên & ảnh đại diện nhóm | | ☑️ | Thêm / Xóa thành viên khỏi nhóm | | ✅ | Chấp nhận/Từ chối thành viên vào nhóm | | ✅ | Chuyển quyền Trưởng nhóm | | ✅ | Cập nhật cài đặt nhóm | | | 🎨 CHỨC NĂNG KHÁC |
| ☑️ | Tạo bình chọn (Poll) trong nhóm | | ☑️ | Quản lý thẻ phân loại (Tag) | | ☑️ | Tìm kiếm sticker |

Đánh giá chức năng: ☑️ Cơ bản, ✅ Nâng cao

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

1. Cài qua Community Nodes (Khuyến nghị)

Yêu cầu phiên bản n8n v0.187 trở lên.

1. Mở n8n Editor.
2. Đi đến Settings → Community Nodes.
3. Chọn Install và tìm kiếm n8n-nodes-ultimate.
4. Nhấn nút Install để cài đặt.
5. Tìm kiếm codedao12 trong danh sách node để sử dụng.

2. Cài thủ công

Nếu bạn đang tự host n8n, bạn có thể cài đặt bộ node này qua npm:

cd YOUR_N8N_DIRECTORY
npm install n8n-nodes-ultimate

💡 Hướng Dẫn Sử Dụng Zalo User

Để tự động hóa Zalo, bạn cần thực hiện các bước sau để đăng nhập và lấy Credential cho các node khác sử dụng.

Bước 1: Tạo n8n API Credential

Node Zalo Login By QR cần quyền truy cập API vào n8n instance của bạn để có thể tự động tạo ra Zalo Credential sau khi bạn đăng nhập thành công.

1. Lấy API Key của n8n:

   • Trong giao diện n8n, đi đến Settings → API.
   • Nhấn Add API key để tạo một API key mới và sao chép nó (đổi tên API Zalo để gợi nhớ).

2. Tạo n8n Zalo API Credential:

   • Trong giao diện n8n, đi đến Credentials → Add credential.
   • Tìm và chọn n8n Zalo API Credential.
   • API Key: Dán API key bạn vừa tạo.
   • URL: Nhập URL của n8n instance của bạn (ví dụ: http://127.0.0.1:5678 hoặc https://n8n.yourdomain.com).
   • Nhấn Save.

Bước 2: Đăng nhập Zalo bằng QR Code

1. Tìm codedao12 và thêm node Zalo Login By QR.
2. Chọn n8n Zalo API Credential bạn vừa tạo ở bước 1.
3. Chạy Execute node và QR sẽ được tạo ra.
4. Dùng Zalo trên điện thoại quét mã QR để đăng nhập.
5. Bạn sẽ không nhận được cảnh báo nào từ n8n, hãy F5 lại trình duyệt để nhận thấy Zalo API Credential đã được tạo.

• Hãy sử dụng nút Zalo bất kì để xem Credential có chưa.
• Truyền Telegram Bot Token sẽ giúp bạn nhận được QR, báo login và lỗi trigger (phù hợp tự động hoá).
• Tự động kiểm tra các Credential cũ có cùng UserId với tài khoản mới và cập nhật lại credential.

Bước 3: Sử dụng Node Zalo

Bây giờ bạn đã có thể sử dụng node Zalo để thực hiện mọi tác vụ (Trigger, Gửi tin, Quản lý).

1. Thêm node Zalo vào workflow.
2. Trong phần Credential to connect with, chọn Zalo API Credential vừa được tạo tự động ở bước 2.
3. Chọn Resource (Trigger, Message, Group, User...) và Operation tương ứng.
4. Cấu hình các tham số khác và chạy workflow.

✨ Chọn Zalo Credential bằng Biểu thức (Expression)

Khi bạn quản lý nhiều tài khoản Zalo, mỗi tài khoản sẽ có một Zalo API Credential riêng. Việc có thể Expresstion rất có ích và nhẹ kịch bản.

1. Trong một node Zalo bật Select a custom credential from ID.
2. Chọn tài khoản trong danh sách đã lưu (credential mặc định sẽ không được sử dụng).

Điều này rất hữu ích để xây dựng các kịch bản tự động hóa phức tạp, ví dụ như gửi tin nhắn lần lượt từ nhiều tài khoản Zalo khác nhau trong cùng một workflow.

📦 Các Node Hiện Có

Message Debounce (gôm tin nhắn)

• Zalo: Tự động tạo Key và lưu đoạn chat, trả lại sau 1 khoảng thời gian.
• Custom: Chỉ định đường dẫn tạo Key và nội dung chat.
• Node được thiết kế phù hợp với nhiều nền tảng chatbot như Facebook, Telegram..

Zalo User (All in One)

• ⚡️ Trigger (Sự kiện):
  • Lắng nghe tin nhắn, thả tim, thu hồi, kết bạn, đã xem, đang soạn tin...
  • Bộ lọc thông minh (filter, threadId, từ khoá), gôm media, thông báo lỗi qua Telegram.
• 💬 Send Message (Gửi tin):
  • Gửi văn bản (HTML), ảnh, sticker, file.
  • Reply (quote), Reaction, Tag thành viên, trạng thái "Đang soạn tin...".
• 🎨 Communication (Tiện ích):
  • Nhóm: Tạo/quản lý nhóm, thành viên, link mời.
  • Người dùng: Kết bạn, chặn, lấy thông tin, lịch sử tin nhắn.
  • Khác: Bình chọn (Poll), Tag phân loại, Sticker.

Zalo Bot (official API)

• ⚡️ Trigger (Webhook):
  • Nhận tin nhắn và sự kiện từ người dùng gửi đến Bot.
  • Tự động đăng ký và huỷ Webhook với Zalo Server.
  • Bảo mật với cơ chế xác thực Secret Token.
• 💬 Send Message (Gửi tin):
  • Gửi văn bản, ảnh (kèm caption), sticker.
  • Gửi trạng thái hành động (Typing, Uploading photo/video/voice...).
• ⚙️ Management (Quản lý):
  • Lấy thông tin Bot (getMe).
  • Quản lý Webhook (Set, Get Info, Delete).
  • Lấy cập nhật thủ công (getUpdates).

⚠️ Lưu ý quan trọng Zalo User

⚠️ Cảnh báo:

• Việc sử dụng thư viện này đồng nghĩa với việc bạn đang làm trái với chính sách của Zalo và nó có thể khiến cho tài khoản của bạn bị vô hiệu hóa.
• Chúng tôi sẽ không chịu trách nhiệm nếu điều đó xảy ra, vậy nên hãy cân nhắc trước khi sử dụng.

📝 Khuyến nghị:

• Sử dụng tài khoản test, không dùng tài khoản chính.
• Tuân thủ giới hạn rate limit của Zalo, có trách nhiệm và không spam

🙏 Lời cảm ơn

Dự án tham khảo từ zca-js — Xin cảm ơn vì đóng góp.

📄 License

MIT