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