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 tới (chat cá nhân + chat nhóm)
Zalo Reaction Trigger	Reaction
Zalo Undo Trigger	Thu hồi tin
Zalo Group Event Trigger	Quản trị nhóm (thêm/xóa TV, đổi tên…) — không phải tin nhắn

Workflow mẫu

1. Đăng nhập QR → lưu credential (theo zalo-node-dev)

Node Zalo Login QR — chỉ cần Proxy nếu có
Execute step → sau ~10–30s mở tab Binary → data (không phải qrCode)
Quét QR bằng app Zalo
(Tùy chọn) Gắn credential n8n API (n8nZaloApi) → sau khi quét, credential Zalo API được tạo tự động
Hoặc copy cookie thủ công từ ZaloDataExtractor

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

Tạo credential Zalo API hợp lệ (từ QR hoặc cookie trình duyệt)
Dùng node Zalo Message Trigger (không dùng Group Event Trigger cho tin nhắn)
Chọn User Messages / Group Messages tùy nguồn tin
Self Listen: tắt = chỉ tin người khác gửi; bật nếu bạn tự nhắn để test
Bấm Listen for test event (hoặc Active workflow) — node dùng WebSocket trực tiếp, không cần webhook URL
Nhờ người khác gửi tin, hoặc bật Self Listen rồi tự gửi
Node Zalo Message → Send Text:
- threadId = {{ $json.threadId }}
- message = nội dung trả lời
- Bật Reply To Message → From Input Item để trích dẫn tin vừa nhận

Phân biệt trigger:

Node	Khi nào chạy
Zalo Message Trigger	Có tin nhắn mới (1-1 hoặc trong nhóm)
Zalo Group Event Trigger	Thêm/xóa thành viên, đổi tên nhóm, admin…

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