JSPM

  • Created
  • Published
  • Downloads 4655
  • Score
    100M100P100Q121569F
  • License MIT

Unofficial Zalo integration for n8n powered by zca-js

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

  1. Mở n8n → SettingsCommunity Nodes
  2. Cài package: n8n-nodes-zalo
  3. 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

  1. Thêm node Zalo Login QR, chạy workflow
  2. Quét QR bằng app Zalo
  3. Copy cookie, imei, userAgent từ output vào credential Zalo API
  4. (Tùy chọn) Bật Auto Save Credential + credential n8n API để tự tạo credential

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

  1. Zalo Message Trigger (credential zaloApi) → kích hoạt workflow
  2. Zalo Message → operation Send Text, threadId = {{ $json.threadId }}

3. Kiểm tra credential

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