Zalo OA Webhook icon

Zalo OA Webhook

Xử lý các sự kiện webhook từ Zalo OA

Zalo OA Webhook

AI-generated

Summary

Receive and process webhook events from a Zalo Official Account (OA), filtering by selected event types and optionally verifying message authenticity with a MAC signature.

Inputs

  • OA Secret Key (required) — The OA Secret Key from Zalo OA management page, used for MAC signature verification.
  • Các Loại Sự Kiện (required) — The list of Zalo OA event types to receive, such as user follows, unfollows, sends messages, clicks buttons or links. Use 'all' to receive all event types.
  • Xác Thực Mac — Boolean to enable or disable verification of the MAC signature sent by Zalo OA for security.

Output shape

A single webhook event per execution with full event data including event type and a timestamp, or an error event if verification fails or the HTTP method is unsupported.

The webhook listens only to POST (event) or GET (verification) requests. Events that are not in the selected event types are ignored with a 200 response. If MAC validation is enabled and fails, the workflow returns an error with a 401 status code. On GET requests with a 'hub.challenge' query parameter, it responds for webhook verification. The output JSON includes an 'event_type' field describing the nature of the emitted data (e.g., actual events, errors, ignored events).

Discussion