---
title: "WhatsApp automatic event detected"
method: POST
path: "whatsapp.automatic_event"
tags: ["Webhook Events"]
---

# WhatsApp automatic event detected

`POST whatsapp.automatic_event` (webhook)

Fired when Meta's automatic event identification (opt-in during
Embedded Signup; not available for EU/UK/JP businesses) detects a
lead or purchase in a Click-to-WhatsApp conversation. Branch on
`eventName` (`LeadSubmitted` | `Purchase`). Carries the `ctwa_clid`
even on coexistence numbers where the inbound referral omits it (this
webhook is the only surface that delivers it there); the clid is also
written back onto the conversation, so POST /v1/whatsapp/conversions
becomes usable for the thread.

## Payload

- object
  - `id` string
  - `event` 'whatsapp.automatic_event'
  - `timestamp` string, date-time
  - `accountId` string — SocialAccount id of the WhatsApp number whose conversation was flagged.
  - `conversationId` string — Zernio conversation id, when the thread could be resolved.
  - `platformMessageId` string — The wamid of the message Meta's analysis flagged.
  - `eventName` string — Meta-detected event: `LeadSubmitted` | `Purchase`.
  - `ctwaClid` string — Meta's CTWA click id, the Conversions API match key.
  - `customData` object — Purchase events may carry the detected amount.
    - `currency` string
    - `value` number
  - `detectedAt` string, date-time

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/51932b099b2f/schema)