Start a phone call or join a meeting
start_callPlace a phone call, join a Zoom, Teams or Meet meeting, or open a new meeting room so an AI voice agent can handle the conversation from your brief and return a structured outcome.
Instructions
Place a phone call, join a video meeting, or start a new meeting room for the user. Smitline talks with people in real time using GPT-Live and returns a structured result when the call ends. Write a complete brief: the goal, what to find out (questions), what may be agreed to, and what must not be shared. Pass the facts the call needs as context (summary, facts, and long details) so the assistant can answer questions like someone who knows the story, and set canDo whenever you could help the people on the call, at least by answering questions about the user's work. The user's profile (who they are, the people they know) is added automatically; keep it current with update_profile. If anything required is unknown, ask the user instead of guessing. For a first call to someone new, offer a rehearsal on the user's own phone. Returns at once. Then follow the call in the same turn: call wait_for_call again and again until its status is completed, failed, or canceled, because once your turn ends nothing from the call reaches you. next, the result's first field, says what to do now. If your app asks the user before each tool call, suggest once, as you start the first call, that they set wait_for_call, get_call and list_calls, and the two tools you use during a call (send_call_instruction, reply_to_call_request), to "Always allow" so you can follow and help a call without a click each time; never suggest it for start_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": {
"channel": "<channel>",
"objective": "<objective>"
},
"name": "start_call"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | E.164 phone number such as +14155550142; the meeting invite URL (Zoom, Teams, Google Meet or Daily; joining by link can take a minute or two, while a hosted service starts a machine for the meeting); "new" for a meeting Smitline starts itself, a room people join from a link in any browser with no account, ready in seconds: the call then carries the room's link as to, for you to send them; or, to join a meeting by phone, its dial-in number, also as a one-tap number such as +14388097799,,85951289482#,,,,*123456# (see dialIn). Omit only for a rehearsal, which rings the user's own phone, or a meeting whose dialIn has the number. For a Google Meet link, add dialIn too when the invitation has a phone number. | |
| task | No | The job several calls serve, such as getting quotes from ten roofers. Use the same id for each call in it. | |
| tone | No | How to come across, such as "casual, he is a close friend". Defaults to matching the relationship. | |
| canDo | No | What you will do for the people on the call when they ask, such as "look things up in the repo and edit the docs". Set it whenever you could help them, at least to answer questions about the user's work. With it, the voice passes you their requests within it and any question it cannot answer itself (live.requests in wait_for_call), and you answer each with reply_to_call_request; it declines other tasks. Without it nothing they ask reaches you: the voice can only say the user will follow up. Name only what you can do and the user would approve. | |
| voice | No | GPT-Live voice for this call only (see list_voices). Leave it out to use the user's default voice for phone calls or for meetings. | |
| dialIn | No | Meetings: join by phone. Pass the meeting's dial-in details whenever the user has them, or just paste the invitation text as invite: Smitline reads the number, the meeting ID and the passcode from it. Smitline dials in, the phone keys in the ID and passcode, and it takes part by audio, saying out loud that it is an AI. With a link in to, it joins by link and dials in if the platform turns it away (or first, where this service joins that platform by phone); with no link it always dials in. For Google Meet, pass it whenever the invitation has a Join by phone number: Google often turns guest bots away, and Smitline then joins by phone by itself. Zoom's own dial-in numbers can be dialed any time; any other number keeps the calling hours and call limits of a phone call. | |
| notify | No | ||
| record | No | Phone only: record this call. Smitline keeps the recording with the call, each side on its own channel, and the assistant tells the other person the call is recorded. Only when the user asks for a recording. | |
| channel | Yes | phone to place a call; meeting to join a Zoom, Teams, Google Meet or Daily meeting, by link or by phone, or to start a new meeting room (to "new") | |
| contact | No | Who is being called, when the user's profile does not already know this number. | |
| context | No | The facts the call needs that the other party may ask about. Text, or an object: summary (a few sentences), facts, decisions, openQuestions, and details (long reference material). The voice starts with a short version and looks details up when asked; it never recites them. | |
| language | No | Language tag such as en or es | |
| carryFrom | No | Start with short notes from earlier calls (at most 10). task: earlier calls in this brief's task; contact: earlier calls to the same number (phone only), or false to skip what the user switched on for that contact; calls: these call ids. Only carry what this call needs: the assistant may mention it to the other party, so do not carry one business's details to another unless the objective calls for it. | |
| objective | Yes | What the call must achieve, in one or two sentences | |
| questions | No | What to find out on the call. The result answers each one. | |
| rehearsal | No | Phone only: practice a call to someone else on the user's own phone first, with the user playing that person. Not for calling the user themselves: when they say "call me", place a normal call to their number, without rehearsal. | |
| afterHours | No | Phone calls, and meetings with dialIn: call even though it is outside calling hours (8 AM to 9 PM) where the number rings. Set only when the user confirms the person expects a call now, or for a meeting that it is on now and the number is its own. | |
| forRequest | No | When this call does what someone on another call asked (such as phoning Smith because a meeting asked you to): that call's id and the request's id. This call then reports to the request by itself: ringing, picked up, and the outcome or why it failed, so the people who asked hear how it went even while you are busy. You can still reply yourself. If they cancel the request, the call ends: at once if no person has spoken on it yet, otherwise after a short goodbye. | |
| maxMinutes | No | Phone calls: at most 60 (default 10). Meetings: at most 240 (default 120). | |
| mayAgreeTo | No | What the assistant may agree to without checking back, such as acceptable times or prices | |
| onBehalfOf | No | The person the call is for, normally the user's own name, spoken in the opening: Hi, I'm calling on behalf of NAME about... I'm NAME's AI assistant. Never an AI, model, or app name such as ChatGPT or Claude. Defaults to the name given at setup; a hosted service may set it to the account holder. | |
| phoneMenus | No | Phone only: let the assistant press keys in an automated phone menu ("press 2 for billing", "enter your account number") for a call to a business, such as a bank, utility or airline. Off by default; turn it on only when the call needs it, because menus make calls longer and cost more. The assistant keys in menu choices and numbers the brief gives for this call, never card numbers, PINs or passwords. | |
| mustNotShare | No | Information the assistant must never share | |
| successCriteria | No | How to tell the call succeeded |