List WhatsApp chats
list_chatsLists WhatsApp conversations by recent activity, returning chat IDs, names, unread counts, last messages, and status flags; filter by unread, groups, individuals, archived, or tag to find a chat_id.
Instructions
Conversations, most recently active first: chat_id, name, type, unread count, last message, and whether archived, pinned, muted or left. Use it to find a chat_id.
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_chats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Only chats with people filed under this tag | |
| limit | No | ||
| cursor | No | next_cursor of the previous page; same filter | |
| filter | No | "all" leaves out archived | all |
| account_id | No | ||
| include_pictures | No | Add picture_url, each chat's profile photo (links expire) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | ||
| sync | Yes | ||
| chats | Yes | ||
| count | Yes | ||
| filter | Yes | ||
| account_id | Yes | ||
| next_cursor | No |