Zalo OA Trigger icon

Zalo OA Trigger

Nhận webhook từ Zalo Official Account (sự kiện người dùng gửi tin nhắn, quan tâm OA, ...)

Zalo OA Trigger

AI-generated

Summary

Triggers a Zalo Official Account webhook for selected events and returns the event payload.

Inputs

  • events (required) — Comma-separated list of event names to listen for; empty to receive all.
  • ignoreOaEcho — If true, drops events where sender equals recipient or event name starts with oa_send_, preventing loops.
  • verifySignature — If true, validates the X-ZEvent-Signature header against the OA's secret key.
  • simplify — If true, returns a shortened payload with only core fields; otherwise returns the full raw body.

Output shape

A JSON object representing the webhook event; either the simplified structure or the raw body depending on the simplify setting.

The payload may contain optional fields; status codes are returned via webhookResponse but not as workflow output. Pagination is not applicable.

Examples

Example 1: Basic chatbot trigger on text messages

events = user_send_text, simplify = true; no verification

Example 2: Full verification and echo-filtering for production

events = all_user_send, verifySignature = true, ignoreOaEcho = true, simplify = false

Links

Discussion