Description

n8n-nodes-zalo-custom

Thư viện n8n nodes chuyên nghiệp, tích hợp tự động hoá Zalo thông qua n8n workflow. Cho phép Expression Zalo Credential phù hợp khi quản lý nhiều tài khoản Zalo.

Hoạt động độc lập trong môi trường n8n của bạn — không dùng API của bên thứ ba hay bất kỳ phụ thuộc ngoại vi nào. Dữ liệu của bạn luôn được giữ riêng tư và an toàn.

Đây là một dự án mã nguồn mở, chúng tôi khuyến khích cộng đồng cùng đóng góp và phát triển thêm các tính năng mới.

📱 Liên hệ & Hỗ trợ

Github: codedao12
Email: codedao12@gmail.com
Nhóm Zalo hỗ trợ: Tham gia nhóm Zalo
Vui lòng liên hệ để yêu cầu tính năng mới hoặc báo lỗi.

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

| 💯 | Tính Năng |
|:—-:|:————————————————–|
| 🔑 | Xác thực & Kết nối |
| ✓ | Đăng nhập bằng Mã QR |
| ✓✓ | Expression Zalo Credential |
| ✓ | Hỗ trợ đăng nhập nhiều tài khoản, proxy |
| ✓✓ | Đăng nhập, thông báo qua telegram |
| ⚡️ | Trigger – Lắng nghe sự kiện |
| ✓ | 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) |
| 💬 | Gửi & Nhận Tin nhắn |
| ✓ | Gửi tin nhắn (Văn bản, Ảnh, Sticker) |
| ✓ | Trả lời tin nhắn (Quote) |
| ✓ | Gắn thẻ (Tag) thành viên trong nhóm |
| ✓ | Thả/Gỡ cảm xúc (Reaction) vào tin nhắn |
| ✓ | Thu hồi tin nhắn đã gửi |
| ✓ | Mô phỏng trạng thái “Đang soạn tin…” |
| 👤 | Quản lý Bạn bè & Người dù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 |
| ✓ | 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 |
| ✓ | Cập nhật thông tin cá nhân (Tên, Giới tính,…) |
| ✓ | Chặn / Bỏ chặn người dùng |
| 👥 | Quản lý Nhóm |
| ✓ | Tạo nhóm mới |
| ✓ | Thêm / Xóa thành viên khỏi nhóm |
| ✓ | Giải tán nhóm |
| ✓ | Thay đổi tên & ảnh đại diện nhóm |
| ✓ | Bổ nhiệm quyền Phó nhóm |
| ✓✓ | Chuyển quyền Trưởng nhóm |
| ✓ | Lấy danh sách tất cả các nhóm đã tham gia |
| ✓ | Lấy thông tin chi tiết và thành viên nhóm |
| ✓ | Tham gia nhóm bằng link / Rời nhóm |
| ✓ | Tạo ghi chú (Note) trong nhóm |
| 🎨 | Tính 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 tab Install và tìm kiếm n8n-nodes-zalo-custom.
4. Nhấn nút Install để cài đặt.
5. Sau khi cài đặt thành công, n8n sẽ tự động tải lại và các node Zalo sẽ xuất hiện trong danh sách node.

—

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 YOURN8NINSTALLATION_DIRECTORY
npm install n8n-nodes-zalo-custom

—

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

Để 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ạo một workflow mới và thêm node Zalo Login By QR.
2. Trong node này, chọn n8n Zalo API Credential bạn vừa tạo ở bước 1.
3. Chạy (Execute) node. Một mã QR sẽ được tạo ra.
4. Dùng ứng dụng Zalo trên điện thoại để quét mã QR này và xác nhận đăng nhập.
5. Sau khi đăng nhập thành công, một Zalo API Credential mới đã được tạo.

> – Bạn cần tải lại trình duyệt để thấy Zalo Credential mới xuất hiện trong danh sách Credentials.
> – Truyền Telegram Bot Token sẽ thông báo QR qua nhóm (phù hợp tự động hoá), lưu vào credential để cảnh báo lỗi.

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 Send Message, Zalo User…

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. Các node (như Zalo Send Message, Zalo User, Zalo Group) cho phép bạn chọn credential một cách linh hoạt bằng cách sử dụng Biểu thức (Expression).

1. Trong một node Zalo (ví dụ: Zalo Send Message), bên dưới Credential, chọn Select a custom credential from ID.
2. Bạn có thể truyền User ID hoặc Phone (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 Có Sẵn

🔑 Zalo Login By QR

—

⚡️ Zalo Trigger

—

💬 Zalo Send Message

—

4. 👥 Zalo Group

—

5. 👤 Zalo User

—

6. 🎨 Zalo Communication

—

⚠️ 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:

📝 Khuyến nghị:

—

🙏 Lời cảm ơn

Dự án tham khảo từ zca-js và các nodes n8n có sẵn — xin cảm ơn vì đóng góp.

—

📄 License

MIT