Place call and track it
place_call_and_trackPlace one real outbound US phone call from a structured request, then wait for its first event, exactly like track_call. Keep calling track_call with the returned call_id until the event is ended. With delegation poll, the phone agent can ask you questions during the call; answer each with track_call's reply. 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_track"
}
}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. | |
| delegation | No | none (default): the phone agent works from the request alone. poll: you stay with the call and answer what the phone agent needs to look up, by calling track_call until it returns ended. webhook: each question arrives at the webhook connected with connect_webhook as a call.delegation event with the call transcript so far, and you answer it with reply_on_call; it needs a connected webhook. Choose poll when you can stay with the whole call, or webhook when your host starts you from a webhook, and the call may need something you could not put in the request. Both still need complete facts. | |
| 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | Yes | ||
| event | Yes | ||
| call_id | Yes | ||
| pending | Yes | ||
| lifecycle | Yes | ||
| reply_result | No |