Choose chats to capture
choose_chats_to_captureShow the user a picker of a connected number's WhatsApp chats, where they search, tick the ones they want and start capturing their new messages from today. Use it when the user wants to choose which chats to capture, or to capture many at once, instead of listing and starting them yourself; it starts nothing on its own. Narrow it to what the user asked with query, kind and active_since, as in list_capturable_chats; phone may be omitted when the user has a single number. Follow the first text of its result: where the picker shows, end your turn, and the user's choice arrives as the next message. If this tool answers an error whose code is currency_selection_required, the user has not confirmed the account's currency: show them the action_url and do not retry until they say it is done.
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": "choose_chats_to_capture"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Optional: "direct" for one-to-one chats only, "group" for groups only. | |
| phone | No | The connected number, as returned by list_connected_numbers. Omit it when the user has a single connected number. | |
| query | No | Optional substring of the chat names to show (case- and accent-insensitive). | |
| active_since | No | Optional YYYY-MM-DD on the phone's calendar: only chats with a message on or after it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | ||
| chats | No | ||
| phone | No | The number the picker captures for. | |
| query | No | ||
| total | No | How many chats match the filters. | |
| locale | No | The Werify account's language as a BCP 47 tag, for the widget's own text. | |
| next_cursor | No | The next page, for list_capturable_chats; null on the last page. | |
| active_since | No |