Handoff tool
Transfer the call to another assistant, squad, or dynamically determined destination
The Handoff tool transfers a live call from one assistant to another. This section covers where a handoff can go, what conversation context and variables travel with it, what the caller hears while it happens, and what to check when a handoff never fires.
Overview
The Handoff tool transfers calls between assistants during a conversation. You can:
- Transfer to a specific assistant by ID or by name (within a squad)
- Transfer to an entire squad with a designated entry assistant
- Support multiple destination options for the AI to choose from
- Determine the destination dynamically at runtime via a webhook
- Control what conversation history the next assistant receives
- Extract structured variables from the conversation for downstream use
- Configure spoken messages for each phase of the handoff
- Reject handoff attempts based on conversation state
In this section
Configure handoff destinations
Declare where a handoff can go, from a fixed assistant to a runtime webhook decision.
Pass context and variables
Control which conversation history and extracted variables reach the next assistant.
Configure messages and rejection rules
Set what the caller hears during a handoff and when a handoff attempt is blocked.
Troubleshoot handoffs
Diagnose handoffs that never fire, starting with the system prompt.