whatsapp.message.received: a customer sent a WhatsApp message
Sent to webhook endpoints subscribed to this event (or to every event).
Sent to webhook endpoints subscribed to this event (or to every event).
webhook-id?stringThe event id (evt_…). Same on every retry and redelivery: use it to drop duplicates. Webhook endpoints only.
webhook-timestamp?stringWhen this attempt was sent, Unix seconds. Webhook endpoints only.
webhook-signature?stringSpace-separated v1,<base64 signature> values (two for 24 hours after a secret rotation). Webhook endpoints only.
X-Webhook-Id?stringSame on every retry of this delivery (the event id for webhook endpoints).
X-Webhook-Event?stringThe event type, for example call.completed.
X-Signature-SHA256?stringHex HMAC-SHA256 of the raw request body only. On webhook endpoints it is a compatibility header, keyed with the whole whsec_... string: it covers neither webhook-id nor webhook-timestamp, so a captured request can be replayed. Verify webhook-signature and reject a webhook-timestamp more than 5 minutes from your clock instead. On a campaign or agent webhook URL it is the only signature, keyed with that URL's secret (when one is set); the signed body carries timestamp, so reject one more than 5 minutes old.
application/json- body
apiVersion*stringcreatedAt*stringWhen the event happened, ISO 8601 UTC.
date-timedata*id*stringEvent id, evt_ and 32 hex characters. Same on retries and redeliveries.
type*stringReceived. Anything else is retried.
{ "apiVersion": "v1", "createdAt": "2019-08-24T14:15:22Z", "data": { "conversationId": "ee6e55e8-45fe-4a3e-9bc8-4669f9fdf77a", "message": {} }, "id": "string", "type": "whatsapp.message.received"}{}webhook.test: sent by the send test event operation Webhook
Sent to webhook endpoints subscribed to this event (or to every event).
Redeliver an event POST
Queues the same event (same `id` and `webhook-id`) to the same endpoint again, due now. Returns the new delivery. Tests and redeliveries share a cap of 10 per endpoint per minute (429 with `Retry-After`).