Skip to navigation
WhatsAppWebhooks

Message status

Notification of the status of an outbound message (type: status).

A single message can generate several events in order: SENT, DELIVERED, READ. The FAILED status is terminal (no more events are received after it) and carries Meta’s errors array with the failure detail.

Not all messages reach READ; it depends on whether the user has read receipts enabled. The order may vary: in some cases DELIVERED and READ are received almost simultaneously.

Payload

The payload of this webhook request is an object.
phone_number_idstringOptional
message_idstringOptional

Message identifier (wamid.xxx). For sends queued by the API before reaching Meta, it is the message_id returned in the synchronous response.

type"status"Optional
statusenumOptional
Allowed values:
timestampstringOptional
Unix timestamp of the event.
campaign_idstringOptional
Optional. Only present when the message belongs to a bulk campaign.
errorslist of maps from strings to anyOptional

Optional. Only present on FAILED: Meta’s error detail for the failure (e.g. code 131026 — Unconfirmed Number).

Response

200
Event received by the client.