n8n-nodes-tran-minh-long-zalo

Custom n8n community nodes for Zalo Web sessions used by TaskKit workflows.

Nodes

• Zalo Message Trigger: listens for Zalo user/group messages and emits normalized payloads.
• Zalo Send Message: sends text, unlimited image attachments in batches, mentions, and video messages.
• Zalo Health Check: validates the cookie/imei/userAgent session.
• Zalo Login By QR: refreshes credentials by scanning a QR code.
• Zalo Group: reads group information.
• Zalo User: reads user profile information.

Notes

This package uses the unofficial zca-js Zalo Web API. CAPTCHA, forced login,
account security checks, and duplicate Zalo Web sessions can still require a
manual QR login. The nodes surface these failures with explicit ZALO_* error
codes instead of silently dropping messages.

For image sends, the node converts input URLs, base64 data URLs, local paths, or
n8n binary images into temporary files before calling Zalo. It never calls Zalo
with a null file path.

Zalo Send Message does not cap the total number of images. It sends images in
configurable batches, with a delay between batches to reduce Zalo rate-limit or
reject risk. Mentions support single UID, UID arrays, JSON objects with names,
and all/@all/-1 for @All. If a mention label is missing from the text,
the node can append @Name or @All automatically so Zalo receives valid
mention pos/len values.