Delivery status | Chat Bridge

Notification of the delivery status of an outbound message.

The normal flow is SENT → DELIVERED → READ; the status never goes backwards, and FAILED and EXPIRED are terminal (no more events are received after them). Not all messages reach READ: it depends on whether the user has read receipts enabled, and DELIVERED/READ can arrive almost simultaneously.

An RCS send can consist of several cards/pieces; data.message_index indicates which piece the event refers to (0 = first).

Notification of the delivery status of an outbound message. The normal flow is `SENT` → `DELIVERED` → `READ`; the status never goes backwards, and `FAILED` and `EXPIRED` are terminal (no more events are received after them). Not all messages reach `READ`: it depends on whether the user has read receipts enabled, and `DELIVERED`/`READ` can arrive almost simultaneously. An RCS send can consist of several cards/pieces; `data.message_index` indicates which piece the event refers to (0 = first).

Payload

The payload of this webhook request is an object.

originenumOptional

Origin of the message: direct API send (API) or bulk campaign send (CAMPAIGN).

channelenumOptional

RCS channel of the send, according to the type of the agent/template used.

message_idstringOptional

The same message_id returned by POST /v1/rcs/messages, except on inbound message events, where it identifies the inbound message itself.

statusenumOptional

Delivery status. It never goes backwards; FAILED and EXPIRED are terminal. READ depends on the user having read receipts enabled; EXPIRED means the message expired (ttl_message) without being delivered.

occurred_atdatetimeOptional

Moment of the event.

timestampstringOptional

Moment of the event as epoch seconds (string). Redundant with occurred_at; use whichever you prefer.

campaign_idstringOptional

Optional. Only present when origin is CAMPAIGN and the message belongs to a campaign; omitted otherwise.

dataobjectOptional

Event-specific content; its shape depends on the event type.

Response

200

Event received by the client.

1	{
2	"origin": "API",
3	"channel": "RCS_BASIC",
4	"message_id": "b3f1c2d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
5	"status": "DELIVERED",
6	"occurred_at": "2026-07-28T19:00:05.000Z",
7	"timestamp": "1753729205",
8	"data": {
9	"sender_phone": "5215512345678",
10	"provider_id": "abc123-provider-msg-id",
11	"message_index": 0
12	}
13	}