List conversations
list_conversationsRetrieve a store's customer conversations sorted by newest activity, filter by status, channel, and time window, and spot customers waiting for a human via pending handover.
Instructions
List the store's customer conversations, newest activity first. Use handover_status=pending to find customers waiting for a human. Returns a preview of the last message; call get_conversation for the full thread.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_conversations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| since | No | Only conversations with activity in this window. | |
| offset | No | ||
| channel | No | ||
| handover_status | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | ||
| has_more | Yes | ||
| conversations | Yes |