Message status | Chat Bridge

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.

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

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.

1	{
2	"phone_number_id": "123456789012345",
3	"message_id": "wamid.HBgNNTIxNTU1MTIzNDU2NxUCABIYFjNFQjBDMTAyRjg5NzRBMEE4RUNE",
4	"type": "status",
5	"status": "DELIVERED",
6	"timestamp": "1716249605"
7	}