Level up your Twilio API skills in TwilioQuest, an educational game for Mac, Windows, and Linux. Download Now


Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Warm Transfer - End User Guide

With warm transfers, agents are able to:

  • Call another agent or a queue for consultation about an ongoing customer call
  • Start a conference call between another agent and a customer, and
  • Transfer the customer to another agent

An animated diagram of 6 steps involved in a standard warm transfer flow.

As outlined in the diagram above, a common warm transfer scenario involves the following steps:

  1. The agent and customer are on an initial call. The agent (Agent A) decides they want to initiate a warm transfer.
  2. Agent A initiates the transfer by calling an agent or a TaskRouter queue with the Flex UI.
  3. Agent B answers the call. At this point, Agent A and Agent B can discuss the customer's needs without the customer hearing the conversation. The connection to Agent B is the consult call.
  4. Once they're ready to transfer, Agent A can put Agent B on hold, remove the Customer from hold, and let them know who will be joining the call.
  5. Agent A can now remove Agent B from hold. This will allow Agent A, Agent B, and the Customer to all speak at the same time.
  6. Agent A can leave the call. Agent B and the Customer will continue the conversation. The warm transfer is now complete.

This feature is in public beta and requires version 1.11 or greater of the Flex UI. You can enable warm transfers on the versioning page within Flex Admin.

Call an Agent Directly

  1. Open the Directory in the Flex UI
  2. Go to Agents
  3. Find the agent you want to call and click the phone icon


Start a Consult Call to a Queue

  1. Open the Directory in the Flex
  2. Go to Queues
  3. Find the queue you want to call and click the phone icon.


Cancel a Consult Call

While waiting for Agent B to accept or reject the call, Agent A can press the red X near Agent B's name to cancel the call and get back to the customer.


Toggle Between Customer Call and Consult Call

To toggle between the customer call and the consult call, put one participant on hold and unhold the other participant.

To allow all three participants to speak at the same time, unhold both calls.


Remove an Agent from the Conference Call

An agent can remove another agent from the conference by clicking on the red circle with a phone icon under the agent's name. The agent will need to confirm the action by clicking on the check mark.



Complete the Warm Transfer

To leave the call, click the red Leave Call button or the button with an icon of a phone with an arrow. Agent B will continue the call with the Customer, and the Warm Transfer will be complete.

If Agent B was put on hold before Agent A left, Agent B can unhold themselves and continue the conversation with the customer.


Connect all Callers

Click on the filled in pause icon to unhold any participant. When all calls have a status of Live, participants can talk to each other. This is also known as a call merge.


Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.