Check a call before placing it
check_call_briefValidates a call or meeting brief without placing the call or joining the meeting, returning blocking problems, warnings, missing fields, and carried-note count so issues can be fixed first.
Instructions
Validate a brief exactly as start_call would, without placing a phone call or joining a meeting. Returns ok, the brief as it would be placed, the problems that would stop it (such as missing setup or a refused number), warnings that would not stop it but may keep it from working (such as a Google Meet link without dialIn: fix them when you can), and how many earlier calls' notes it would start with. For a phone call it also tests that the phone provider can reach this computer, starting the tunnel if needed (a few seconds), so a network that blocks it shows up before you dial: worth running before a demo. Missing fields come back as brief_incomplete with a question to ask the user. Use it when unsure whether a brief is complete; start_call runs the same checks itself.
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": "check_call_brief"
}
}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 |