Read a conversation
get_conversationReturns one conversation of a store: its last 50 messages (from the customer, the chat's assistant or the team) and the open request for the team with its reason, question and summary. Photos, files and phone numbers are left out and email addresses are masked. Each read is recorded in the store's activity log with the app's name. Needs the conversations permission and the store's switch for AI assistants in Settings > Security, and works only for stores the person owns.
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": {
"store_id": "<store_id>",
"thread_id": "<thread_id>"
},
"name": "get_conversation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| store_id | Yes | The store's store_id (not its name). | |
| thread_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | ||
| channel | No | ||
| request | No | ||
| language | No | ||
| left_out | No | Why messages are not listed: older than the last 50, or the system's own notes. | |
| messages | Yes | ||
| store_id | Yes | ||
| thread_id | Yes | ||
| started_at | No | ||
| dashboard_url | No | ||
| messages_left_out | No |