Read a conversation
get_conversationRead a single customer conversation with messages oldest first, including bot reply sources, knowledge-base titles, and confidence scores. Reading may mark messages as read for store agents.
Instructions
Read one conversation with its messages, oldest first. Bot replies carry how they were produced: response_source (rag, function_calling, template, tool_error, handover...), the knowledge base titles used, and the bot's confidence score. The server asks the API not to mark the conversation as read (mark_read=false). Known limitation: the Kustomer Suite API does not honor that yet, so reading marks the messages as read for the store's agents.
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": {
"conversation_id": "<conversation_id>"
},
"name": "get_conversation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max_messages | No | Keep only the most recent messages. | |
| conversation_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| channel | Yes | ||
| messages | Yes | ||
| truncated | Yes | True when older messages were left out because of max_messages. | |
| handover_status | Yes | pending: the bot handed the customer over and nobody answered yet. taken: an agent is handling it. closed: finished. none: the bot is handling it. |