whatsapp.message.delivered
A WhatsApp message reached the recipient's phone.
When it fires
The message reached the recipient's phone. It fires once per message, when the message reaches delivered. If WhatsApp reports read first, this event doesn't fire for that message; whatsapp.message.read does.
Event fields
data.idstringWhatsApp message ID, starting with
msg_. The same ID the send returned.data.senderstringPhone number the message was sent from, in E.164 format.
data.recipientstringRecipient phone number, in E.164 format.
data.templateobject or nullThe template sent:
id,name, andlanguage.data.occurred_atstringISO 8601 time WhatsApp reported for this status.
The payload never includes message content or variable values. Retrieve the message with data.id for its content, cost, and all its timestamps.
Handle this event
Mark the message as delivered. A delivered message beyond your plan's included messages is charged at this point; retrieve the message for its cost.
Verify the signature before reading the payload. Deduplicate by the envelope id, not the message ID: one message has several events. Events can arrive out of order; compare data.occurred_at, or retrieve the message, before moving a status backwards.