Place call and wait briefly
place_call_and_waitPlace one outbound US call from a structured request and wait up to max_wait_seconds (default 45, max 90) for completion. Suited to a single call, not parallel campaigns. If the call is still running when the wait ends, call track_call with the returned call_id until the event is ended. get_calling_guide topic outbound documents the request fields. The user may see a live card for the call.
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": {
"to": "<to>",
"recipient": "<recipient>",
"on_behalf_of": "<on_behalf_of>",
"goal": "<goal>",
"authority": "<authority>"
},
"name": "place_call_and_wait"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | US E.164 destination such as +14155550123. Look up official public business numbers; ask the user for private details or when listings conflict. | |
| goal | Yes | The result wanted from this call. Include the full context needed to understand the outcome. | |
| facts | No | Reference details the recipient may need for this goal, such as account or order numbers, dates, preferences, callback numbers, known menu paths, and prior-call outcomes. The phone agent knows only what the request contains. | |
| voice | No | Audio voice: eric (default), jessica, sarah, or chris. Omission uses the saved voice. | |
| handoff | No | Presence enables loop-in. The assistant rings the account's loop-in contacts, or its verified phone when none are set. Include it on most calls. List every situation only the user can handle in handoff.when: one-time codes, account-holder-only policies, identity questions, payments, and decisions outside the authority. The assistant also loops in when the other side asks for the user or a real person. | |
| language | No | Language to speak, when you know the recipient prefers one other than English. Speech recognition is tuned for it and English; the assistant can follow the other side into another listed language, less reliably. Omit for English. One of ar (Arabic), bn (Bengali), de (German), en (English), es (Spanish), fr (French), he (Hebrew), hi (Hindi), id (Indonesian), it (Italian), ja (Japanese), kn (Kannada), ko (Korean), mr (Marathi), ms (Malay), nl (Dutch), pl (Polish), pt (Portuguese), ta (Tamil), te (Telugu), th (Thai), tl (Tagalog), tr (Turkish), vi (Vietnamese), zh (Mandarin Chinese). | |
| authority | Yes | Commitments the assistant may make and their limits. An empty allow list means ask and relay only. | |
| questions | No | Questions to ask the recipient, including alternatives and follow-up details. Anything the recipient must tell the user, such as a confirmation number or price, belongs here. | |
| recipient | Yes | Business, department, or person you expect to reach, including the location. | |
| voicemail | No | Mailbox outcome: end (default) ends the call without leaving a message; leave_message carries only the words to convey, including authorized callback details. The agent leaves this message on the voicemail, so write it as the message itself, with exact names, numbers, and dates. Put no instructions to the agent inside message. | |
| on_behalf_of | Yes | Person or organization the assistant represents. This identifies the requester; it grants no account access. | |
| assistant_name | No | A plain assistant name, such as Jordan. Without it, the agent uses a default name, usually Alex. | |
| max_wait_seconds | No | Seconds to wait for finalization, from 5 to 90; default 45. If the call is still running, call track_call. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||