WhatsApp webhooks
Events for WhatsApp template review status and Meta-detected CTWA lead/purchase events.
WhatsApp product events that aren't number lifecycle (those live under Phone number webhooks): template review outcomes and Meta's automatic lead/purchase detection in Click-to-WhatsApp conversations. Delivery, retries, idempotency, and signature verification work the same for every event and are covered in the webhooks overview.
Events
| Event | Description |
|---|---|
whatsapp.template.status_updated | Fired when Meta finishes (re)reviewing a WhatsApp Business template attached to a connected WABA. |
whatsapp.automatic_event | Fired when Meta's automatic event identification detects a lead or purchase in a Click-to-WhatsApp conversation. |
whatsapp.template.status_updated
Fired when Meta finishes (re)reviewing a WhatsApp Business template attached to a connected WABA. Forwarded from Meta's message_template_status_update webhook field on the WhatsApp Business Account. Branch on template.status (APPROVED, REJECTED, PENDING, PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION); template.reason is Meta's free-form reason or "NONE". Meta does not include the previous status or the template's category in this event. Subscribe with Create webhook settings or Update webhook settings.
Stable webhook event ID
"whatsapp.template.status_updated"ISO-8601 timestamp the webhook was produced.
date-timeResponse Body
whatsapp.automatic_event
Fired when Meta's automatic event identification detects a lead or purchase in a Click-to-WhatsApp conversation (opt-in during Embedded Signup; not available for EU/UK/JP businesses). Branch on eventName (LeadSubmitted or Purchase); Purchase events may carry the detected amount in customData (currency, value).
The payload carries the ctwa_clid (the Conversions API match key) even on coexistence numbers where the inbound referral omits it; on those numbers this webhook is the only surface that delivers it. The clid is also written back onto the conversation, so POST /v1/whatsapp/conversions becomes usable for the thread.
Subscribe with Create webhook settings or Update webhook settings.
"whatsapp.automatic_event"date-timeSocialAccount id of the WhatsApp number whose conversation was flagged.
Zernio conversation id, when the thread could be resolved.
The wamid of the message Meta's analysis flagged.
Meta-detected event: LeadSubmitted | Purchase.
Meta's CTWA click id, the Conversions API match key.
Purchase events may carry the detected amount.
date-time