Prerequisites
- Your agent must be integrated with a Twilio phone number.
- You need the phone number or extension for each transfer destination.
Setup
Add a destination
Click Add Handoff and fill in:
- Handoff destination name — A descriptive label (e.g., “Billing support”, “Front desk”).
- Extension/Number — The phone number to transfer to, in E.164 format (must start with
+, e.g.,+14155551234). - Description — When this handoff should be used (e.g., “When the caller requests to speak with billing”).
Save
Click Add. The destination is now available for use in Managed Topics actions and functions.
Test your handoff
- Add the handoff as an action on a Managed Topic.
- Test in Sandbox by triggering the topic that should initiate the transfer.
- Verify the call routes to the correct destination.
Next steps
- Call Handoffs overview — Configure SIP methods and headers
- Handoff API — Retrieve handoff context programmatically
- Twilio Flex integration — Advanced contact center routing