Zalo Message Trigger icon

Zalo Message Trigger

Listen for Zalo user and group messages with reconnect and heartbeat checks

Zalo Message Trigger

AI-generated

Summary

Listens for selected Zalo user and group messages and emits normalized message data to the workflow. It logs in with the required Zalo API credential, checks the session periodically, and retries after listener or session errors.

Inputs

  • Event Types — Choose group messages, user messages, or both (default). Messages outside the selection are ignored.
  • Self Listen — Whether to emit messages sent by the logged-in Zalo account; defaults to false.
  • Heartbeat Seconds — How often to validate the session while the workflow is active; defaults to 300 seconds, with a 30-second minimum.
  • Reconnect Base Seconds — Base delay for reconnect attempts after listener errors; defaults to 20 seconds, with a 5-second minimum. Retry delays increase by this amount per attempt and cap at 5 minutes.
  • Emit Health Errors — When enabled (default), emit workflow items for successful connections and listener/session errors. Requires the Zalo API credential, which supplies the cookie, IMEI, and user agent.

Output shape

A stream of workflow items: normalized Zalo message events, plus optional connection and error status events.

Message items include source, ok, type, raw message and data, normalized thread and sender IDs, message type, text, image URLs and count, event timestamp, self flag, thread type, and receive timestamp. With Emit Health Errors enabled, connection items include cookie status; error items include a ZALO_* code, phase, message, and occurrence time. Errors are emitted only when that option is enabled.

Links

Discussion