calls_dispatch_agent
Send a workspace AI agent into a live call — ONE tool for every surface; target decides where: a Google Meet, Microsoft Teams or Zoom link → meeting bot; a Telegram @group / t.me link / chat_id / t.me/call slug → Telegram group voice chat or conference; 'new' → creates a NEW Telegram conference call and returns its shareable link; a WhatsApp group JID (digits@g.us) → WhatsApp group call; a live session UUID (from calls.list_active), or thread_id of a running call → WAKES the agent on the bot already in that call instead of spawning a second one. For a meeting link the router also checks for a bot already in that meeting and wakes it rather than double-joining. Always pass agent_id (from agents.list). For a live TRANSLATOR use calls.dispatch_translator instead. agent_id must be an ACTIVE agent of this workspace — a system template is refused (create an agent from it first with agents.create). To take the agent off the call again while the bot keeps transcribing, use calls.dismiss_agent.
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": {
"agent_id": "<agent_id>"
},
"name": "calls_dispatch_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | target='new' only: label for the new conference. | |
| target | No | Where to send the agent: a Google Meet, Microsoft Teams or Zoom link, a Telegram @group / t.me link / chat_id / t.me/call slug, 'new' for a fresh Telegram conference, a WhatsApp group JID (digits@g.us), or a live session UUID to wake the agent on a running call. Omit only when passing thread_id. | |
| agent_id | Yes | ID of an active agent in this workspace (from agents.list). Any active agent can be dispatched — a voice trigger is NOT required. | |
| greeting | No | First line the agent speaks on a 1:1 call. Omit to use the agent's configured default greeting. | |
| thread_id | No | Inbox thread id of a RUNNING call — wakes the agent on the bot already in it. Alternative to a session UUID target. | |
| vision_mode | No | Screen-share capture mode (Meet + Telegram spawns): 'off', 'on_demand' (agent can call vision_query), 'continuous_0_3fps' (ambient scene captures each turn). OMIT to use 'off' (the default). | |
| in_workspace | No | Run this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected. | |
| instructions | No | Task brief for the agent, e.g. 'take notes and answer questions about the roadmap'. On a spawn it is woven into the voice system prompt; on a wake it is the kickoff turn the agent responds to. OMIT for a generic listening/greeting agent. | |
| start_immediately | No | Spawn routes only: if true the agent starts talking as soon as it joins instead of waiting to be addressed. OMIT (default false) to stay silent until addressed. Wake routes always speak immediately. | |
| channel_account_id | No | The workspace account that places or joins the call (id from channels.list): the Telegram account, the WhatsApp number, the phone number. Optional with exactly one account of that channel. Telegram: required with several. WhatsApp group: with several numbers the one in the group calls; several of them in the group is refused with the list. |