Skip to main content
Agent Tools and Actions

Transfer Calls to a Person

Let your VAW Native agent hand callers to your team: set up to 10 destinations, choose cold or warm transfer, ring time, hold audio and when to use each.

Written By voiceaiwrapper

Last updated 26 days ago

Transfer call lets your agent hand a caller to a real person, such as your front desk, a sales rep or an on-call technician. You set up the people or lines the agent can transfer to, and the agent picks the right one by name when the conversation calls for it.

You can transfer cold (the caller is connected as soon as someone answers) or warm (the agent briefs the person first).

Applies to: agents in a VAW Native Pod (an engine or provider connection), on phone calls only. Transfers aren't offered on web calls, web widget conversations or chats.

Before you start

You'll need:

  • A connected Twilio account with at least one active number. Transfers dial out through the Twilio account of the number the call is on. See Connect Your Twilio Account to VAW Native.
  • Elastic SIP Trunking enabled on that Twilio account. VoiceAIWrapper uses it to place the transfer leg. If it isn't available, you'll see an error when you save (see Troubleshooting below).
  • The phone numbers to transfer to, in international format (for example +14155550123). Extensions and SIP addresses aren't supported yet.
  • A long enough maximum call length. A transferred call still ends at the agent's Maximum call length (see Step 4 below).

Transfers place a real outgoing call on your Twilio account, so Twilio charges its usual rates for the transferred leg.

Step 1: Switch on Transfer call

  1. In your VAW Native Pod, open Agents and choose the agent.
  2. Open the Tools tab.
  3. Under Built-in system tools, click Transfer call.
  4. Turn on Enabled.

The panel reminds you that this is for phone calls only. Don't promise transfers in your prompt for every conversation, because the agent can't transfer on a web call or chat.

Step 2: Add a destination

  1. Click Add a destination. The panel switches to the Destination editor.
  2. Fill in the fields in the table below.
  3. Click Done (or Back to destinations) to return to the list.
  4. Repeat for each destination. You can add up to 10.
FieldWhat to enterLimits and defaults
NameHow the agent refers to this destination, such as "Front desk" or "Billing". The agent chooses by name only; the number stays in your settings.Up to 64 characters. Must be unique for this agent (spacing and case are ignored).
Phone numberA number that can be dialled, in international format.No extensions or SIP addresses.
ModeCold or Warm. See "Cold or warm" below.Default: Cold.
Handoff messageWarm only. What the agent says to the person before the caller is connected. Choose Let agent phrase it or Exact sentence.Required for warm. Up to 1,000 characters.
Ring for 30s before giving upHow long to ring before the agent comes back to the caller. The label shows the number you pick.5 to 120 seconds, in steps of 5. Default: 30.
The caller hears while waitingHold music, Office, City, Forest or Nothing.Default: Hold music. Nothing is only offered for cold transfers.
When to use this destinationWhen the agent should pick this one, such as "Billing questions, invoices and payments." It's added to the agent's instructions.Up to 500 characters.

Most phone networks stop ringing on their own after about 30 seconds, so a much longer ring time often makes no difference.

Agent β†’ Tools tab β†’ Transfer call β†’ one destination open in the editor (panel title 'Destination'). Name 'Billing', a phone number filled in, Mode set to Warm, Handoff message with 'Let <agent> phrase it' selected and a short brief typed in, the 'Ring for 30s before giving up' slider, 'The caller hears while waiting' set to Hold music (with no 'Nothing' option, because the mode is warm), and 'When to use this destination' filled in. 'Back to destinations', 'Remove' and 'Done' are visible. Blur the phone number.

Cold or warm

ColdWarm
What happensThe caller is connected as soon as someone picks up.When someone picks up, the agent tells them who is calling and why. Then the caller is connected.
The person answering hearsThe caller, straight away.The agent's briefing first. They don't hear the caller until the briefing ends.
The caller hearsYour hold audio while it rings.Your hold audio while it rings and during the briefing.
Best forSimple routing, such as "put me through to sales".Handing over context, so the caller doesn't have to repeat themselves.

For a warm transfer, choose how the handoff message is used:

  • Let agent phrase it: your text is a brief. The agent turns it into a few short sentences for the person answering, using what it learned on the call. For example: "Say who is calling, what they need, and anything already agreed."
  • Exact sentence: the agent reads your text word for word.

Warm transfers can't use Nothing as hold audio. If you switch a destination from cold to warm while Nothing is selected, it changes to Hold music, so the caller never sits in silence during the briefing.

Step 3: Save

Back on the list, check your destinations. Each shows its name, a Cold or Warm badge and its number. Click Save changes.

The Transfer call panel's list view with Enabled on, the yellow 'Phone calls only' warning, two destinations under Destinations ('Front desk' with a Cold badge and 'Billing' with a Warm badge, each showing its number), the 'Add a destination' button, and the note about the agent leaving once a transfer connects. Save changes visible at the bottom. Blur the phone numbers.

When you save with Transfer call on, VoiceAIWrapper sets up outbound calling in the Twilio account behind each of your active numbers, if it isn't set up already. These settings save on their own, so you don't need the agent's main save bar. Changes apply from the next call.

Step 4: Raise the maximum call length

A transferred call still ends at the agent's Maximum call length, counted from the start of the call. When the limit is reached, the call closes without a goodbye, even if your caller and your team member are mid-conversation. New agents start at 5 minutes.

Open the Call Settings tab and set Maximum call length high enough to cover the AI part of the call plus the conversation with your team. It can be 1 to 240 minutes. See Call Settings: Recording, Silence Timeout and Maximum Call Length.

What happens during a transfer

  1. The agent decides a transfer is needed and picks a destination by name, guided by When to use this destination.
  2. The caller hears your hold audio while the destination rings.
  3. The person answering sees your number (the number the call is on) as the caller ID, not the caller's own number.
  4. If nobody answers within the ring time, the hold audio stops and the agent comes back to tell the caller the destination is unavailable. The call continues with the agent.
  5. If someone answers, a warm transfer plays the briefing first. Then the caller and your team member are connected, and the agent leaves the conversation. If the person answering hangs up during the briefing, the agent comes back to the caller and the call continues.
  6. The call stays open, and recorded if recording is on, until both people hang up. The silence timeout doesn't run during a transfer.

Check a transfer in Call Logs

Open the call in Call Logs and look at the transcript:

  • A divider reads transferred to destination Β· recording continues Β· transcript ends here. The transcript stops at the handover, because the agent no longer listens.
  • For warm transfers, the briefing appears under What the agent told destination before connecting the call.
  • The recording, if on, includes the whole call, including the conversation after the transfer.
  • The call's End reason reads Assistant forwarded call once the caller was connected, or Customer ended call during transfer if the caller hung up while the destination was ringing or being briefed.

Remove a destination

Open the destination and click Remove. If it has a name, you'll be asked to confirm. The agent stops offering it from the next call; past calls are unchanged. Click Save changes on the list to keep the change.

Troubleshooting

When you switch Transfer call on, VoiceAIWrapper sets up the outbound connection it uses for transfers in each Twilio account behind your active numbers. If Twilio refuses, the panel shows Twilio's own error, or "Could not set up outbound calling in your Twilio account. Elastic SIP Trunking may not be enabled on it." Check in Twilio that Elastic SIP Trunking is enabled on that account, then click Save changes again.

If you see "Could not set up outbound calling for transfers. Try again in a moment." or "Could not reach Twilio to set up outbound calling.", wait a minute and save again.

Every destination needs both before you can save. Open the destination named in the message, fill in the missing field, or remove it.

Warm destinations must have a handoff message. Open that destination and write one, or switch it to Cold.

The agent picks destinations by name, so each name must be different. Names that differ only in capital letters or spacing count as the same.

Check the call type first: transfers only happen on phone calls, not on web calls or chats. To test, use Test agent β†’ Phone call. Then check that Enabled is on, there is at least one destination, and When to use this destination clearly describes when to use it.

The call reached the agent's Maximum call length. Raise it on the Call Settings tab, as described in Step 4 above.

Not yet. Destinations must be phone numbers that can be dialled directly.