Package Information
Available Nodes
Documentation
n8n-nodes-ultimate
Bộ node n8n đa năng: Zalo User (~100 tính năng), Zalo Bot API, Facebook User, Tải Video mạng xã hội, và Gôm tin nhắn cho chatbot.
📌 Menu
👤 Tác Giả
Github: codedao12
Video hướng dẫn: youtube
Hỗ trợ và cập nhật: nhóm Zalo
📋 Giới Thiệu
Sau khi cài đặt tìm codedao12 sẽ thấy các nút:
- Zalo User: Tự động hoá Zalo cá nhân (trigger, ~100 action).
- Zalo Bot: Kết nối API chính thống.
- Facebook User: Tự động hoá Facebook cá nhân (trigger, ~50 action).
- Download Social Videos: Tải Video/Kênh từ Youtube/TikTok/Reels.
- Message Debounce: Gôm tin nhắn, tối ưu trải nghiệm chatbot.
Xem chi tiết từng nhóm node
Zalo User
- Hơn 100 tính năng tự động hoá Zalo cá nhân với n8n.
Expression Zalo Credentialgiú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 Groupthành 1 output duy nhất. - Tham số
filtertrong 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.
Facebook User
- Hơn 50 tính năng tự động hoá tài khoản Facebook cá nhân (unofficial).
- Trigger lắng nghe tin nhắn messenger cá nhân.
- Trigger lắng nghe thông báo mới đến tài khoản với output riêng.
- Đăng bài trang cá nhân, nhóm, comment bài viết...
- Quản lý nhóm chat messenger, story, note...
Download Social Videos
- Tải video từ Shorts / TikTok / Reels.
- Tải theo URL hoặc theo kênh/tài khoản.
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 có trigger như fb, telegram, tiktok..
🧭 Các Nút Hiện Có
codedao12 |
Mô tả | Ghi chú |
|---|---|---|
Zalo User |
Đăng nhập QR, trigger, gửi tin, quản lý user/nhóm | Unofficial Api, Expression Credential, update Credential |
Zalo Bot |
Webhook, gửi tin, quản lý Bot | API chính thống |
Facebook User |
Trigger, Nhắn tin, Đăng bài | Unofficial Api, sử dụng cookies đăng nhập tài khoản cá nhân |
Download Social Videos |
Tải video đa nền tảng | Tải TikTok/Shorts/Reels theo url hoặc Kênh |
Message Debounce |
Gôm tin nhắn theo thời gian | Chờ gôm tin nhắn chat từ mọi trigger |
🚀 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.
- Mở n8n Editor.
- Đi đến Settings → Community Nodes.
- Chọn Install và tìm kiếm
n8n-nodes-ultimate. - Nhấn nút Install để cài đặt.
- Tìm kiếm
codedao12trong 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
✨ Tính Năng Của Zalo User
Xem chi tiết tính năng 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 |
| ☑️ | 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 |
| ☑️ | 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 |
| ☑️ | 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ư |
| ☑️ | 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 |
| ☑️ | 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á: ☑️ Cơ bản, ✅ Nâng cao
💡 Hướng Dẫn 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 Account By QR cần n8n API key để lưu Zalo Credential sau khi bạn đăng nhập thành công.
Nội dung chi tiết
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ó.
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:5678hoặchttps://n8n.yourdomain.com). - Nhấn Save (1 cái này dùng cho nhiều lần login nha).
Bước 2: Đăng nhập Zalo bằng QR Code
Nội dung chi tiết
- Tìm
codedao12 - Zalo Uservà thêm action Login Account. - Chọn
n8n Zalo API Credentialbạn vừa tạo ở bước 1. - Chạy Execute node và QR sẽ được tạo ra.
- Dùng Zalo trên điện thoại quét mã QR để đăng nhập.
- 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
Zalobấ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ý).
Nội dung chi tiết
- Thêm node
Zalovào workflow. - Trong phần Credential to connect with, chọn
Zalo API Credentialvừa được tạo tự động ở bước 2. - Chọn Resource (Trigger, Message, Group, User...) và Operation tương ứng.
- Cấu hình các tham số khác và chạy workflow.
🔥 Expression Zalo Credential
Nội dung chi tiết
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.- Trong một node Zalo bật
Select a custom credential from ID. - 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.
💡 Hướng Dẫn Facebook User
Node Facebook User hỗ trợ thao tác Messenger cá nhân (unofficial) với nhiều nhóm chức năng:
- Trigger: lắng nghe tin nhắn + thông báo (notifications) qua
Facebook User Trigger(output riêng cho notification). - Message: gửi/thu hồi/sửa/xoá tin nhắn, reaction, forward attachment, đánh dấu đã xem/đã gửi/đã nhận, resolve photo URL.
- Post: đăng bài trang cá nhân/nhóm, comment bài viết, lấy bài viết page/group/comment, share preview, story (create/react/reply).
- Threads: lấy info, danh sách hội thoại, lịch sử chat, tạo nhóm, thêm/xoá thành viên, đổi tên/ảnh, set admin.
- Users: lấy thông tin người dùng, resolve name/link -> userId, follow/unfollow, friend requests/list/suggestions.
- Groups/Pages: lấy danh sách bài viết và bình luận.
- Notes: tạo/xoá/kiểm tra ghi chú chat.
- Stickers: tìm sticker, list pack, store pack, add pack, sticker AI.
- Media: upload ảnh để lấy Photo ID.
Bước 1: Tạo Facebook User Credential
Nội dung chi tiết
- Cài extension J2TEAM Cookies trên trình duyệt.
- Mở
facebook.comcủa tài khoản đã đăng nhập. - Mở extension và chọn Export as text.
- Copy JSON và dán vào trường Cookies (JSON).
- Lưu lại và thử sử dụng (có thể thêm proxy).
Bước 2: Sử dụng node Facebook User
Nội dung chi tiết
- Thêm node
Facebook Uservào workflow. - Chọn
Facebook User API Credentialvừa tạo. - Chọn Resource và Operation phù hợp.
- Nhập
threadIdhoặc các tham số cần thiết và chạy workflow.
Lưu ý: Chat riêng bị mã hoá đầu cuối nên không hoạt động (nên dùng acc clone để chạy).
💡 Hướng Dẫn Zalo Bot
Node Zalo Bot và Zalo Bot Trigger dùng API chính thống của Zalo để làm chatbot:
- Gửi tin nhắn, ảnh, sticker, và trạng thái hành động (typing, upload...).
- Quản lý webhook, lấy thông tin bot, lấy cập nhật thủ công.
- Trigger nhận sự kiện từ người dùng gửi đến Bot.
Hướng dẫn chi tiết
- Tạo Bot trong Zalo Bot Manager và lấy Bot Token.
- Tạo
Zalo Bot API Credentialvà dán Bot Token (Base URL để mặc định). - Dùng node Zalo Bot Trigger để nhận webhook (mỗi bot chỉ nên có 1 trigger).
- Dùng node Zalo Bot để gửi tin nhắn/ảnh/sticker hoặc thao tác webhook.
💡 Hướng Dẫn Download Social Videos
Node Download Social Videos hỗ trợ tải video đa nền tảng và lấy metadata:
- Download: tải video về binary để xử lý trong workflow.
- Get Info (JSON): lấy thông tin video (title, url, duration...).
- Mode: nhập URL trực tiếp hoặc username/channel.
- Yêu cầu: Python3 + FFmpeg để tải đầy đủ; Facebook Reels cần Facebook Credential.
Cách cấu hình để sử dụng
- Đảm bảo môi trường có python3 và ffmpeg (khuyến nghị).
- Thêm node
Download Social Videos. - Chọn Resource, Operation, Mode (URL hoặc Username/Channel).
- Cấu hình Format, Output Folder, Avoid Duplicates nếu cần.
- Chạy workflow để nhận file video hoặc JSON metadata.
Ví dụ cấu hình Dockerfile
truy cập
YOUR_N8N_DIRECTORYvà tạo Dockerfile
Cách 1: n8n bản v1.x.x
FROM n8nio/n8n:1.121.3
USER root
RUN apk add --no-cache python3 ffmpeg
USER node
Cách 2: n8n bản v2.x.x
FROM alpine:3.23 AS alpine
FROM n8nio/n8n:2.2.3
USER root
COPY --from=alpine /sbin/apk /sbin/apk
COPY --from=alpine /usr/lib/libapk.so* /usr/lib/
COPY --from=alpine /lib/ld-musl-*.so.1 /lib/
COPY --from=alpine /etc/apk /etc/apk
RUN apk add --no-cache tini python3 ffmpeg
USER node
Build:
docker compose down
docker compose up -d --build
💡 Hướng Dẫn Message Debounce
Node Message Debounce giúp gôm tin nhắn theo thời gian chờ:
- Mode Zalo: tự tạo key theo Zalo Trigger.
- Mode Generic: tự chỉ định key/content cho các nền tảng khác.
- Tùy chọn gộp tối đa, separator, bỏ qua tin nhắn từ chính mình.
Hướng dẫn chi tiết
- Thêm node
Message Debouncesau node Trigger. - Chọn Mode (Zalo hoặc Generic).
- Cấu hình Wait Time, Max Batched Messages, Separator.
- Với Zalo: bật
Ignore IsSelfhoặcExtract Text From Photo/Videonếu cần. - Với Generic: nhập
Key Fields,Content Fields,Drop When Path is true.
⚠️ Lưu Ý Quan Trọng
⚠️ Cảnh báo:
Zalo UservàFacebook Userlà thư viện không chính thức, có thể vi phạm chính sách nền tảng và khiến tài khoản bị vô hiệu hoá.Download Social Videostải Reels cần cookies, hãy cân nhắc rủi ro checkpoint/ban nếu tải nhiều hoặc spam.- Chúng tôi không chịu trách nhiệm nếu có sự cố xảy ra, hãy cân nhắc trước khi sử dụng.
📝 Khuyến nghị:
- Dùng tài khoản test, không dùng tài khoản chính.
- Tuân thủ rate limit, không spam.
🙏 Lời cảm ơn
This project is inspired by and partially references the following open-source projects: zca-js, ws3-fca, yt-dlp.


