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 Cá Nhân: (bản thay thế n8n-nodes-zalo-custom)

• Hơn +80 tính năng tự động hoá Zalo 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.

Node Gôm Tin Nhắn:

• Message Debouncer: 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..

✨ Các Tính Năng Chính Zalo

| | 🔑 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 tin nhắn mới (lọc theo từ khóa, nhóm) | | ☑️ | Sự kiện thu hồi tin nhắn, thả cảm xúc | | ☑️ | Sự kiện trong nhóm (tham gia, rời, đổi quyền,...) | | ☑️ | Sự kiện về bạn bè (kết bạn, hủy bạn) | | ☑️ | Sự kiện đã xem, thu hồi, đang soạn tin, thả tim | | ✅ | 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 | | | 💬 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 | | | 👤 QUẢN LÝ 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 |

🚀 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

Để 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 các Node Zalo khác

Bây giờ bạn đã có thể sử dụng các node khác như Zalo Trigger, Zalo Message, Zalo Communication

1. Thêm node Zalo Trigger hoặc Zalo Send Message 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. 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.

📦 Node Gôm Tin Nhắn

🕗 Message Debouncer

• 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 Cá Nhân

1. 🔑 Zalo Login By QR

• Đăng nhập vào Zalo bằng mã QR (hỗ trợ proxy).
• Hỗ trợ đăng nhập nhiều tài khoản.
• Tự động thay thế Credential cũ thành mới.
• Thông báo và gửi QR qua telegram.

2. ⚡️ Zalo Trigger

• Lắng nghe sự kiện: tin nhắn người dùng/nhóm, thả tim, thu hồi tin nhắn, lời mời kết bạn, đã xem tin nhắn, đang soạn tin.
• Cấu hình:
  • Thêm tham số filter giúp xử lý tin nhắn dễ dàng hơn.
  • Bộ lọc đầu vào theo threadId và từ khoá.
  • Gôm nhiều media thành 1 output duy nhất.
  • Lắng nghe sự kiện của chính bạn.
  • Nhận thông báo qua telegram nếu Zalo lỗi đăng nhập.

3. 💬 Zalo Send Message

• Gửi tin nhắn văn bản (hỗ trợ HTML), hình ảnh, sticker.
• Trả lời tin nhắn (quote), thả biểu tượng cảm xúc (reaction), tag thành viên.
• Mô phỏng hành động "Đang soạn tin...".

4. 🎨 Zalo Communication

• Quản lý nhóm: Tạo/giải tán nhóm, đổi tên/ảnh, quản lý thành viên (thêm/xóa/phân quyền), lấy link mời.
• Quản lý người dùng: Kết bạn, chặn/bỏ chặn, lấy thông tin chi tiết (SĐT/ID), cập nhật hồ sơ, lấy tin nhắn cũ.
• Tiện ích khác: Tạo bình chọn (Poll), quản lý thẻ phân loại (Tag), tìm kiếm Sticker.

⚠️ Lưu ý quan trọng (Đọc kỹ trước khi dùng)

Vui lòng đọc kỹ trước khi sử dụng Zalo nodes:
⚠️ 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