Start capturing a chat's new messages
start_live_captureStart capturing the new messages of WhatsApp chats from today on: today's messages from before the call are brought in too, as in Werify's "From today". It brings no earlier history; for that, use start_history_capture. Obtain the user's agreement first. A chat already capturing is left as it is; a stopped one resumes in its conversation. Pass a list of up to 100 chat_ids to start several. Name the chat with chat_id, contact_phone or chat_name from list_capturable_chats; phone may be omitted when the user has a single number. A new account starts with free capture: its first chats on one number capture at no charge, for a limited time. Every other capture, and every capture once free capture ends, is paid from the account's balance or by that number's subscription. list_connected_numbers says what funds each number, and what to tell the user, in its funding_note. 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": "start_live_capture"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phone | No | The connected number, from list_connected_numbers. Omit it when the user has a single connected number. | |
| chat_id | No | The chat, by the chat_id list_capturable_chats returns, or a list of 1–100 of them. Pass exactly one of chat_id, contact_phone and chat_name. | |
| chat_name | No | The chat, by its name exactly as list_capturable_chats returns it. Pass exactly one of chat_id, contact_phone and chat_name. | |
| transcribe | No | Transcribe the voice notes that arrive. Omitted: false on a new chat, unchanged on a resumed one. | |
| contact_phone | No | The chat, when it is a 1:1: the other party's number in E.164. Pass exactly one of chat_id, contact_phone and chat_name. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| results | No | Batch only: one per distinct chat_id, in input order. | |
| chat_name | No | ||
| transcribe | No | Whether arriving voice notes are transcribed. | |
| captures_from | No | The local day the capture starts from (YYYY-MM-DD); null for all history. | |
| contact_phone | No | A 1:1's other party in E.164; null otherwise. | |
| conversation_id | No | The conversation the capture feeds. | |
| conversation_url | No | ||
| already_capturing | No | True when nothing changed. |