If the agent can’t finish a caller’s request, it should hand off the call to a human or another system. You can update these handoff destinations yourself.
This page covers the UI-based Call Handoff feature. Ask if your project uses the code-level transfer_call function.

​
Edit an existing destination

overview
  1. In the sidebar, select Call handoffs.
  2. Hover over the destination you want and click Edit.
  3. Change the Number / SIP URI or Description.
  4. Save.
  5. Make a quick test call in Sandbox and confirm the transfer works, then promote your version.
Common use cases:
ReasonWhat to update
Front-desk line changedReplace the number in Route
Routing after-hoursAdd a note in Description so team mates know when to switch destinations

​
Add a new handoff destination

  1. Click Add handoff.
  2. Fill in:
    • Name — e.g. “VIP host desk”.
    • Method — leave SIP REFER unless your telephony team says otherwise.
    • Route / Number — +1XXXXXXXXXX or a SIP URI.
    • (Optional) SIP headers if your PBX needs extra context (see next section).
  3. Add → test → promote.

​
Add SIP headers (optional)

SIP headers let you pass metadata — account ID, language, VIP flag, etc.
  1. While creating or editing a destination, click Add SIP header.
  2. Enter a header name (custom headers start with X-).
  3. Enter a value, or use a variable such as $caller_id.
  4. Save.

​
Using your own Twilio number

If you bring your own Twilio DID:
  1. Connect Twilio under Telephony → Twilio (enter Account SID + Auth Token).
  2. In Twilio, point the number’s Voice webhook at your agent URL.
  3. Back in Call handoffs, use that number as the Route field.
US numbers need A2P 10DLC registration for SMS.

​
Test before you ship

  1. Call the Sandbox number.
  2. Trigger the scenario that should transfer.
  3. Confirm the call operates how you are expecting.
  4. Promote the new version to Production.
If the transfer fails, double-check:
  • Number format (+ and country code)
  • Firewalls or other rules on the destination side
  • SIP header spelling

​
When to escalate

Get in contact with platform-support@poly-ai.com if:
  • You need more conditional logic the UI express
  • The destination uses a non-standard SIP method
  • You are seeing 4XX/5XX SIP errors