Documentation

n8n-nodes-ultimate

npm version  npm downloads

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:

  1. Zalo User: Tự động hoá Zalo cá nhân (trigger, ~100 action).
  2. Zalo Bot: Kết nối API chính thống.
  3. Facebook User: Tự động hoá Facebook cá nhân (trigger, ~50 action).
  4. Download Social Videos: Tải Video/Kênh từ Youtube/TikTok/Reels.
  5. 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 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.

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.

  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

✨ 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
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á: ☑️ 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
  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ó.
  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 (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
  1. Tìm codedao12 - Zalo User và thêm action Login Account.
  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ý).

Nội dung chi tiết
  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.

🔥 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.
  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.


💡 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
  1. Cài extension J2TEAM Cookies trên trình duyệt.
  2. Mở facebook.com của tài khoản đã đăng nhập.
  3. Mở extension và chọn Export as text.
  4. Copy JSON và dán vào trường Cookies (JSON).
  5. 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
  1. Thêm node Facebook User vào workflow.
  2. Chọn Facebook User API Credential vừa tạo.
  3. Chọn ResourceOperation phù hợp.
  4. Nhập threadId hoặ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 BotZalo 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
  1. Tạo Bot trong Zalo Bot Manager và lấy Bot Token.
  2. Tạo Zalo Bot API Credential và dán Bot Token (Base URL để mặc định).
  3. Dùng node Zalo Bot Trigger để nhận webhook (mỗi bot chỉ nên có 1 trigger).
  4. 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
  1. Đảm bảo môi trường có python3ffmpeg (khuyến nghị).
  2. Thêm node Download Social Videos.
  3. Chọn Resource, Operation, Mode (URL hoặc Username/Channel).
  4. Cấu hình Format, Output Folder, Avoid Duplicates nếu cần.
  5. Chạy workflow để nhận file video hoặc JSON metadata.

Ví dụ cấu hình Dockerfile

truy cập YOUR_N8N_DIRECTORY và 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
  1. Thêm node Message Debounce sau node Trigger.
  2. Chọn Mode (Zalo hoặc Generic).
  3. Cấu hình Wait Time, Max Batched Messages, Separator.
  4. Với Zalo: bật Ignore IsSelf hoặc Extract Text From Photo/Video nếu cần.
  5. Với Generic: nhập Key Fields, Content Fields, Drop When Path is true.

⚠️ Lưu Ý Quan Trọng

⚠️ Cảnh báo:

  • Zalo UserFacebook User là 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 Videos tả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.


📄 License

MIT

Discussion