Skip to main content

Seen Report

Seen Report callbacks are triggered to notify your application that an end user has seen a delivered message. These callbacks provide detailed information, including the message ID, recipient, and timestamps.

Seen Webhook Payload

Parameter	Type	Required	Description	Example
`type`	`string`	`true`	Always `SEEN`	`SEEN`
`direction`	`string`	`true`	Always `Outbound`	`Outbound`
`channel`	`string`	`true`	Always `rcs`	`rcs`
`message_id`	`string`	`true`	ID of message	`4de1d075-2a7e-404e-abac-3f80560db42f`
`to`	`string`	`false`	The phone number the message was sent to (E164 format with no plus)	`1234567890`
`from`	`string`	`false`	The sender the message was sent from	`exampleSender`
`tag`	`string`	`false`	Custom defined string sent with message	`example tag`
`bulk_tag`	`string`	`false`	Custom defined string sent with message	`example bulk tag`
`event_meta`	`object`	`true`	Event specific metadata	`{ "sent_at": "2025-12-01T15:00:00Z" }`
`event_meta.sent_at`	`string`	`true`	The time the message was sent at	`2025-12-01T15:00:00Z`
`error`	`object`	`true`	The message error, if applicable	`{ "code": "0", "description": "None" }`
`error.code`	`string`	`true`	Detailed error code	`0`
`error.description`	`string`	`true`	Detailed error description	`no error`
`time`	`string`	`true`	The time of the event was received in ISO 8601 format	`2025-12-01T15:30:00Z`
`api_version`	`string`	`true`	The version of the API the message was sent on	`1`

Seen Webhook Payload