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

- Giới thiệu
- Hướng dẫn cài đặt
- Tổng quan 5 nút
- Zalo User • ~100 tính năng
- Zalo Bot Platform
- Facebook User _⚡Mess & Notif_
- Download Social Videos
- Message Debounce
- Lưu ý quan trọng
- License

👤 Tác Giả

Github: Codedao12
Video hướng dẫn: Youtube
Hỗ trợ và cập nhật: Nhóm Zalo

📖 Tài Liệu

Xem hướng dẫn đầy đủ tại Documentation

📋 Giới Thiệu

Sau khi cài đặt tìm codedao12 để sử dụng:
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

$3

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

$3

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

$3

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

$3

- Tải video từ Shorts / TikTok / Reels.
- Tải theo URL hoặc theo kênh/tài khoản.

$3

- 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

$3

> 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à nhập n8n-nodes-ultimate.
4. Nhấn Install để cài đặt.
5. Tìm codedao12 trong danh sách node.

---

$3

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

``bash
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.

$3

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


$3

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.


$3

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.


$3




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 (chia làm 2 output).
- 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.

$3




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. Bật 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).


$3




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 Resource và Operation 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 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

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ó python3 và ffmpeg (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.

$3


> truy cập YOUR_N8N_DIRECTORY và tạo Dockerfile

Cách 1: n8n bản v1.x.x

`Dockerfile
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

`Dockerfile
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:
`bash
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 User và Facebook 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ị:
- Hãy sử dụng tài khoản phụ.
- 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