Package Exports

n8n-nodes-zalo-gemazo
n8n-nodes-zalo-gemazo/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (n8n-nodes-zalo-gemazo) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

n8n-nodes-zalo

Community node n8n tích hợp Zalo cá nhân qua thư viện zca-js.

Cảnh báo: Đây là API không chính thức, mô phỏng Zalo Web. Việc sử dụng có thể vi phạm điều khoản Zalo và dẫn đến khóa tài khoản. Nên dùng tài khoản phụ để thử nghiệm.

Cài đặt

Community Nodes (khuyến nghị)

Mở n8n → Settings → Community Nodes
Cài package: n8n-nodes-zalo
Tải lại editor

Cài thủ công

cd ~/.n8n/nodes
npm install n8n-nodes-zalo

Phát triển local

git clone <repo-url>
cd zalo-node-hygge
npm install
npm run build
cd ~/.n8n/nodes
npm link <path-to-zalo-node-hygge>
n8n start

Credential `zaloApi`

Field	Mô tả
Cookie	JSON cookie từ Zalo Web hoặc output node Zalo Login QR
IMEI	`localStorage.getItem('z_uuid')` trên chat.zalo.me
User Agent	`navigator.userAgent` từ trình duyệt
Proxy	Tùy chọn, ví dụ `http://user:pass@host:port`

Hướng dẫn lấy cookie thủ công: zca-js – Đăng nhập Cookie

Nodes

Node	Mô tả
Zalo Login QR	Đăng nhập QR, trả cookie + ảnh QR
Zalo Message	Gửi text/sticker/voice/card, xóa, undo, reaction, typing
Zalo User	Bạn bè, block, alias, tìm user, profile
Zalo Group	Tạo/sửa nhóm, thành viên, phó nhóm, avatar
Zalo Account	Thông tin tài khoản, pin, report, test credential
Zalo Sticker	getStickers, getStickersDetail
Zalo Poll	createPoll, lockPoll
Zalo Note	createNote, editNote
Zalo Message Trigger	Tin nhắn mới (user/group)
Zalo Reaction Trigger	Reaction
Zalo Undo Trigger	Thu hồi tin
Zalo Group Event Trigger	Sự kiện nhóm

Workflow mẫu

1. Đăng nhập QR → lưu credential

Cách nhanh (mặc định):

Node Zalo Login QR — để Wait For Login = OFF
Execute step → sau ~10s mở tab Binary → qrCode để xem/quét QR
Lấy cookie bằng ZaloDataExtractor hoặc bước 4

Cách tự động lấy cookie (chạy lâu ~2 phút):

Bật Wait For Login = ON
Execute → node hiển thị "Executing..." cho đến khi bạn quét QR xong
Khi xong, JSON có cookie, imei, userAgent → dán vào credential Zalo API

Không cần điền User Agent / Proxy (nằm trong Additional Options nếu cần).

2. Nhận tin → trả lời

Tạo credential Zalo API hợp lệ (từ QR hoặc cookie trình duyệt)
Bật Active workflow có Zalo Message Trigger
Gửi tin nhắn tới tài khoản Zalo đã đăng nhập
Node Zalo Message → Send Text, threadId = {{ $json.threadId }}

Lưu ý trigger: Workflow phải Active (không chỉ Test workflow). n8n self-hosted; queue mode có thể cần worker chạy liên tục.

3. Kiểm tra credential

Zalo Account → operation Test Credential

Kiểm thử

Kiểm tra	Cách làm
Build	`npm run build`
Credential hợp lệ	Zalo Account → Test Credential
Gửi tin	Zalo Message → Send Text
Trigger	Kích hoạt workflow có Message Trigger, gửi tin từ Zalo

License

MIT — xem LICENSE.

Ghi nhận

Cảm ơn zca-js và cộng đồng n8n-nodes-zalo-nnt vì các ý tưởng triển khai.

n8n-nodes-zalo-gemazo