Read a sent message's status
get_message_statusRead where one of the user's own messages stands, from the receipts WhatsApp sent about it:
sent until the first receipt, then delivered to a phone, read, or played for a voice note
or a video, with each recipient's own stages and when they happened (UTC). In a group, read the
recipients: one of them reading is the whole status. Only a message the user sent in a
conversation under capture has one; find it with search_messages, or use the message_id a send
tool returned. A recipient who turned read receipts off never reports read.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"message_id": "<message_id>",
"conversation_id": "<conversation_id>"
},
"name": "get_message_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message_id | Yes | The message: the message_id search_messages or a send tool returned. | |
| conversation_id | Yes | The conversation id (from the read tools). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | sent, delivered, read or played: the furthest stage any recipient reached. | |
| message_id | No | The message. | |
| recipients | No |