Ask a person to approve something on WhatsApp
ask_personSends a WhatsApp approval request to a named person before expensive or irreversible actions, then waits for their approval, rejection, or amendment.
Instructions
Ask a named person to approve, reject or amend something, on WhatsApp, and wait for their answer. Use this before doing anything that is expensive or impossible to undo: issuing a refund, sending a quote, posting publicly, emailing a list, deleting data. The person gets buttons on their phone and can also reply with free text to amend what you proposed. Returns their decision, or the request id if nobody has answered yet.
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": {
"title": "<title>"
},
"name": "ask_person"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | A link to the thing being decided. | |
| body | No | Why you are asking, and anything they need in order to decide. | |
| title | Yes | The decision, in one line. 'Refund AED 450 to Sara'. | |
| external_id | No | Your own id for the thing being decided. Sending the same one twice returns the existing request rather than asking a second time, so a retry is safe. | |
| wait_seconds | No | How long to wait for an answer before returning. Defaults to 120. Pass 0 to return immediately and poll with check_approval. | |
| allow_amendment | No | Offer an Edit button that asks for free text. Use it when the answer could reasonably be 'yes but change this' rather than only yes or no. | |
| expires_in_minutes | No | How long the decision stays useful. Defaults to a day. |