Warm transfer to a PBX call group: Is an internal handoff between groups considered a successful transfer

Hi Retell team,

Wanted to confirm how a warm transfer works. Suppose we set the Transfer Ring Duration to 60 seconds. Suppose the destination is a call group on a clients phone system ending in 1000.

The setup:

  • Call group 1000 rings for 20 seconds.
  • If no one answers, the phone system forwards the call to a call group 2000.

My question:
When the call moves from 1000 to 2000 on the phone system’s side, does Retell treat that as a successful transfer (the call was answered or connected)? Or does Retell keep waiting for the full 60-second ring duration and then return the call to the agent if no one picks up on the second call group as well?

What I’m trying to confirm:

  1. Does the call return to the agent after 60 seconds if nobody in either group answers?
  2. Does an internal handoff between groups ever end the transfer attempt early?

We also wanted to ask whether dynamic variables are supported in the custom sip headers on a transfer

Thanks!

Hey @hussain

Regarding dynamic variables in custom SIP headers, yes — Retell supports using dynamic variables as header values during transfers. Header names must begin with X-, or use User-to-User or Diversion.

A couple of important notes:

  • Custom SIP headers are preserved when transferring directly to a SIP endpoint, but they may be stripped when transferring to a PSTN number.

  • For cold transfers using SIP REFER, some providers may ignore custom headers, including Twilio.

For the Transfer Ring Duration, Retell’s documentation states that this controls how long the destination rings before the transfer attempt is considered unanswered.

For the specific case where your PBX forwards the call internally from group 1000 to group 2000 during that window, I’ll confirm the exact behavior with the relevant team and get back to you once I have an update.

Thank you!

Hi @mark1, thanks for the quick reply.

Following up on transfer ring duration, we primarily want to understand what counts as “answered” for a warm transfer, and whether internal handoffs could be considered a successful transfer

Thanks again

Hey @hussain

The Transfer Ring Duration is the maximum amount of time Retell will wait for the outbound transfer leg to be answered. Retell considers the transfer successful when the SIP leg is actually answered, for example with a final 200 OK response. If the destination continues to ring and is not answered before the timer expires, Retell treats the transfer as failed and returns the call to the agent.

Based on the scenario you described, the 1000 → 2000 movement sounds like an internal transfer or forwarding behavior within the client’s phone system. Those internal legs may not be visible to Retell. In that case, Retell would typically just see the same transfer attempt continuing to ring, rather than seeing a separate handoff between group 1000 and group 2000.

If the PBX keeps the SIP leg in a ringing/provisional state while it forwards from group 1000 to group 2000, Retell would continue waiting within the configured 60-second Transfer Ring Duration. If nobody answers within that window, the transfer would fail and the call would return to the agent. If the PBX answers the SIP leg before forwarding internally, then Retell would treat that as an answered/successful transfer from our side.

To dig deeper into the exact behavior for this specific setup, we would need a full packet capture including SIP signaling. That would let us confirm whether the PBX is keeping the call in a ringing state, returning a failure response, or sending a final answer before the internal forwarding happens.

Best Regards.