status_message, ref_message_id, url, and staff_id.messages:read| Parameter | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | Internal message record ID |
| Field | Type | Description |
|---|---|---|
id | integer | Message record ID |
interaction_id | integer|null | Chat interaction ID |
sender_id | string|null | Sender phone number or ID |
type | string|null | Message type (text, template, image, video, etc.) |
message | string|null | Message content (may contain HTML for template messages) |
status | string|null | Delivery status (sent, delivered, read, failed) |
status_message | string|null | Status description or error message |
message_id | string|null | WhatsApp message ID (wamid format) |
ref_message_id | string|null | Referenced/replied-to message ID |
url | string|null | Media URL (for media messages) |
sent_at | string | ISO 8601 timestamp (time_sent or created_at) |
is_read | boolean | Whether message has been read |
staff_id | integer|null | Staff member ID who sent (null for API/bot messages) |
| Status | Error Code | Description |
|---|---|---|
| 401 | UNAUTHORIZED | Invalid or missing API token |
| 403 | INSUFFICIENT_SCOPE | Token missing messages:read scope |
| 404 | NOT_FOUND | Message not found |
| 429 | RATE_LIMIT_EXCEEDED | Too many requests |
| 500 | INTERNAL_ERROR | Failed to fetch message |
curl --location --request GET '/messages/msg_abc123' \
--header 'Authorization: Bearer <token>'{}