List connected WhatsApp numbers
list_connected_numbersList the WhatsApp numbers connected to the user's Werify account, with each one's status. Use it after connect_whatsapp_number to confirm the pairing landed (linking → syncing → ready), and before telling the user what a number can do. A number is keyed by its phone; a linking entry with no phone is a pairing still waiting for its code. With no number at all, the result carries a next_step on how to connect one: offer it to the user.
A pairing can also end at sync_stalled instead of ready: WhatsApp sent no history at all and will not. That one does not resolve by waiting or by polling this tool, so stop doing both and tell the user what stall_remedy says.
ready means the initial sync finished and the number can capture conversations through start_live_capture when capture_funded is true. A positive wallet balance is enough, or the user can enable auto-topup with a card in Werify. A suspended number cannot capture: follow its funding_note, even if the account-level capture_funded is true. A positive remaining balance does not mean a suspension was lifted. 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.
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_connected_numbers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| numbers | No | ||
| next_step | No | Present only when no number is connected: how to connect one, to offer the user. | |
| funding_hint | No | Present only when capture_funded is false: what the user must do, and where. | |
| capture_funded | No | Whether the user's wallet can fund capture on any number (positive balance, or auto-topup on with a card), or a free capture is still unused. On an account without a wallet, whether some number can capture or a free capture is still unused. A number may also be funded on its own — see each number's capture_funded. Connecting a number never needs funding; capturing does. This does not lift an individual number's billing suspension: check its status and funding_note. |