Read a conversation
get_conversationRead one conversation's transcript by id (from search_conversations), one page at a time,
most recent first. Page one is the newest window of messages; pass cursor (the
next_cursor from the previous page) to walk backward into older history, a null
next_cursor meaning you've reached the start of the conversation. Within each page the messages
are in chronological order (oldest→newest) with timestamps, senders and audio transcripts, so a
page reads naturally. Optionally bound the range with start_date / end_date — the cursor
already carries that range, so you do not re-send the dates when paging. Only conversations the
user owns or has been shared are accessible.
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": {
"id": "<id>"
},
"name": "get_conversation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The conversation id. | |
| limit | No | Messages per page, 1–200 (default 100). | |
| cursor | No | The `next_cursor` from a previous page; omit for the first page. | |
| end_date | No | Optional ISO 8601 date (YYYY-MM-DD) upper bound. | |
| start_date | No | Optional ISO 8601 date (YYYY-MM-DD) lower bound. | |
| include_comments | No | Include the user's comment annotations on messages as `# comment (...)` lines (default false). The cursor carries the choice, so it applies to every page. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The conversation id this page belongs to. | |
| url | No | Where a person can open this conversation in Werify. | |
| name | No | The conversation or group name. | |
| text | No | One page of transcript, oldest→newest within the page, with timestamps, senders and audio transcripts on `> ` continuation lines. | |
| phone | No | The user's connected number that captures this conversation, the phone the capture tools take; null when no number of theirs captures it. | |
| chat_id | No | This chat on that number, the chat_id the capture tools take; null when phone is null or the number's chat list does not hold it. | |
| metadata | No | ||
| next_step | No | Present only when capture is paused for billing on one of the user's numbers — the transcript still reads, but nothing new is arriving. Relay it to the user. | |
| next_cursor | No | Pass back as `cursor` to read the window *before* this one. `null` means you have reached the start of the conversation. |