List conversations
list_conversationsLists one store's chat conversations, newest first, 20 per page: customers waiting for the team now (waiting), requests to follow up after hours (follow_up), conversations the team is in (with_team) or all. Each row has its state, request reason, labels, rating and the opening line. 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>"
},
"name": "list_conversations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mine | No | Only conversations this person took. | |
| page | No | ||
| show | No | waiting | |
| label | No | A team label's name. | |
| period | No | The days covered, by when the conversation or email arrived. | 30d |
| search | No | ||
| store_id | Yes | The store's store_id (not its name). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| from | No | ||
| more | No | ||
| page | No | ||
| show | No | ||
| total | Yes | ||
| store_id | Yes | ||
| conversations | Yes | ||
| dashboard_url | No |