List capturable chats
list_capturable_chatsList the chats a connected WhatsApp number can capture — the phone's own conversation list,
newest activity first. Every chat carries a chat_id, which the capture tools take; a 1:1 is
also named by contact_phone and a group by name, the way the user names them. chat_jid is
deprecated. When Werify already captures a chat, the row also carries the
conversation_id the read tools use and whether the capture is running or stopped. Filter by
name with query, by recent activity with active_since and by kind; total counts what
the filters kept, and large lists page with cursor. Pass the phone from
list_connected_numbers, or omit it when the user has a single connected number.
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_capturable_chats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Optional: "direct" for one-to-one chats only, "group" for groups only. Omit for both. | |
| phone | No | The connected number, as returned by list_connected_numbers. Omit it when the user has a single connected number; with more than one, the call is refused listing them. | |
| query | No | Optional substring to match against chat names (case- and accent-insensitive). | |
| cursor | No | The next_cursor from a previous page; carries the phone and every filter with it. | |
| active_since | No | Optional YYYY-MM-DD, a day on the phone's calendar: only chats with a message on or after it. Chats whose last activity the phone never reported are left out, and last_message_at comes back in UTC, so it can read as the neighbouring day. With kind, this is how to count the chats of a period from total instead of paging the whole list. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chats | No | ||
| total | No | How many chats match (before paging). | |
| next_cursor | No | Pass back as cursor to get the next page; null on the last page. | |
| estimates_used | No | How many distinct-chat estimate slots are occupied on this number. | |
| estimates_remaining | No | Remaining onboarding allowance; null when estimates are not limited. |