ask
Ask the human a question on WhatsApp and BLOCK until they reply (or timeout).
`text` is the question. `buttons` (optional, up to 3) render as tappable reply
buttons; omit them to invite a free-text answer the human types on their phone —
use this to let the human steer you mid-task. `timeout` is seconds to wait
(max 90). Returns the human's reply (free text and/or the chosen option). On
timeout, returns a note — the question was delivered and the answer is still
retrievable via `check_replies`. `to` (optional): "me" (default), "team" or a list
of team member names or ids; to a group, the first answer wins and names who.
`mode` (optional, a group): "first" (default) or "all" (every recipient's answer).
`escalate` (optional, mode "first"): while nobody answers, ask the next people: up
to 3 steps {"to": "team" or [member names/ids], "after_s": seconds after the send,
>= 60, each >= 60 after the previous}, or a policy name (POST /v1/team/policies).
The first answer stops it; it goes on after `timeout`.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"text": "<text>"
},
"name": "ask"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | me | |
| mode | No | ||
| text | Yes | ||
| buttons | No | ||
| timeout | No | ||
| escalate | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |