Skip to content
EN
Open app

For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/telephony/transfer.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.

Transfer

15 min read
Copy as Markdown
View as MarkdownOpen the raw .md file.md

The agent passes a caller to a person, a team, another AI agent or an outside number while the call is live. All of it is set inside the agent: open the agent, then Call handling - Transfer. The agent decides when to transfer during the conversation, following your Routing Instructions.

Your plan must include call transfer. If it does not, the tab shows Transfer destinations need a plan upgrade.

Call handling Transfer Enable and Warm Attended Blind
transfer-tabExpand
DestinationWhat it isWhat happens
UserA person in Active directory with a seatTheir devices ring. The first one answered gets the caller.
User groupA team from User GroupsMembers ring in order until one answers.
AI agentAnother agent in the same companyThe other agent takes over the same call. No ringing, no new call.
External numberAny phone numberA new outgoing call to that number, then the caller is connected.

A person can only receive a transfer on a device that is connected. Do this once per person:

  1. Add the person and give them a seat

    Telephony - Active directory. See Users, seats and devices.

  2. Connect at least one device

    DeviceRings when
    Windows appThe person is signed in to the app.
    SIP phone or softphoneThe person has a SIP seat and the phone is registered (shown under Online devices).
    Personal mobileAlso ring personal mobile is on in their seat, they have a mobile seat and a mobile number on their profile. The call reaches them as a normal phone call.

    All connected devices ring at the same time. The first one answered gets the caller and the others stop.

  3. Keep their status available

    The agent sees each person’s status live. If they are offline, away or on Do Not Disturb, the agent does not try to transfer to them and takes a message instead. A user group is offered only while at least one member is online.

  4. Add them as a destination on the agent

    On Available Transfer Destinations, add the User or their User group, or turn on Allow the AI to transfer to any enabled destination in this company.

If your calls come in through your own PBX and the person is not registered with Voice Logica, the agent hands the call back to your PBX and the PBX rings their extension. See Connect your PBX.

  1. A real number already rings this agent

    Get a number. Try this agent in the browser cannot transfer: transfer works only on phone calls.

  2. Turn Enable call transfer on

    Off: the agent cannot transfer. Your settings stay saved.

  3. Choose the transfer behavior: Warm, Attended or Blind. See How the handoff works.

  4. Write the Routing Instructions

    Say who handles what, in the language of your calls. For example: Billing questions go to the Accounts group. Ask for Maria by name only if the caller asks for her.

  5. Add the destinations

    Allow the AI to transfer to any enabled destination in this company
    Every enabled user and user group in the company, plus anything you add below.
    Specific destinations
    Only the list below. + Add destination - User, User group, AI agent or External number. A destination whose user, group or agent no longer exists shows in red as Destination not found: choose another one or remove the row. Saving a destination id that is not in your company is refused.
    Specific destinations Add destination type picker
    transfer-addExpand
  6. Test it on a real call

    Call the number and ask for that person. Then open the call on Calls: the transfer result and reason are on the row.

The behavior you choose on the tab applies to external numbers. You can change it for one destination on that row (Inherit, Attended or Blind).

Be sure a person answers
TURN ONWarm (Recommended)NEEDSThe caller hears hold music. Voice Logica calls the number and connects the caller only when someone answers. If nobody answers, the agent comes back to the caller.
Hand the call to your phone system to join
TURN ONAttendedNEEDSSame as Warm until the person answers. Then your carrier or PBX joins the two calls directly and Voice Logica steps out.
Send the call straight on
TURN ONBlindNEEDSThe agent tells the caller it is connecting them and hands the call to your carrier or PBX at once. Nobody checks that a person answers: it can end in voicemail, a queue or a busy line, and the agent is no longer on the call to help.

For the other destinations the behavior is fixed:

DestinationBehavior
User / User groupAlways waits for a person to answer, whatever you choose. The caller hears hold music while the devices ring.
AI agentThe new agent continues the same call.
External numberWarm, Attended or Blind as chosen.

Options for Warm and Attended:

Ring timeout
How long to ring before the transfer counts as unanswered.
Announce Transfer Reason to Recipient
External numbers only. When the person answers, a voice tells them who is calling and why, and asks them to accept. The caller is connected only if they say yes. They have 60 seconds to answer.
Ask the Recipient to Accept
Shown when Announce Transfer Reason to Recipient is on. On (default): the person is asked to accept, as above. Off: they hear only the short summary (who is calling, what they want, the key detail), then «Connecting you», and the caller is connected right away, with no question. If they say «no» during the summary, the caller is not connected. Voicemail or a recorded message is never connected.
Show Caller ID to Transfer Recipient
On: the person sees the caller’s number. Off: they see your company number.
Hold sound while waiting
The music the caller hears while the transfer rings.
Analyze Transferred Call
External numbers only: the conversation after the transfer is transcribed and analysed too. Uses analysis minutes. A transfer to a user uses that user’s own call settings instead.

With Warm and an announcement, once the person accepts, the caller can be connected in one of three ways:

HowWhat happensChannels and billing
Warm bridge (default)Voice Logica joins the caller and the person and stays in the middle.Both calls stay open on your line until someone hangs up, and the whole conversation is billed. Your phone system does not see a transfer, so it cannot put the caller on hold or pass them on.
Hand back to your PBXThe person hears the announcement and accepts. Then their phone rings again with the caller, and your PBX takes the call.Voice Logica leaves the call and the channels are free. Billing stops at the transfer. Hold and transfer work from your phones as usual.
AttendedYour PBX joins the two calls directly.Same as hand-back, but the person’s phone does not ring a second time. Your PBX must support it.

Hand back to your PBX is for phone systems connected to Voice Logica as a PBX trunk that cannot join calls directly, such as the Panasonic KX-NS. It is a setting of the SIP trunk: ask support to turn it on, or set completeTransferByRefer with the update_sip_trunk tool of the Voice Logica MCP. on always hands back. auto hands back only when your PBX does not support joining calls. If your PBX refuses the hand-back, Voice Logica keeps the two calls joined as before. If the ring after the hand-back fails, the agent comes back to the caller.

A person who took a call on a SIP phone or softphone can pass it on with the phone’s own transfer keys, without the agent. The platform handles it like this:

On the phoneWhat happens
Blind transfer: press Transfer, dial the extension, hang upThe caller is sent to that extension at once and it rings as a new call. If the transfer fails or nobody answers, the caller comes back to your phone.
Blind transfer to an AI agent: press Transfer, dial the agent’s internal number (see Active directory), hang upThe agent takes the caller over on the same call. Nothing rings, the caller is not called again, and the agent greets them at once. The agent is told who passed the call on and the last things said before the transfer, so the caller does not have to start over. On Calls you see two rows: your part of the call, marked transferred, and the agent’s part.
Attended transfer: put the caller on hold, call the colleague, talk, press TransferThe caller is joined to the colleague you are talking to and your phone drops out. The call to the colleague is opened on the same media server as the call you are holding, so the two sides can be joined. If the two calls still end up on different servers, the caller is sent straight to the colleague’s extension, which rings again.
Hold: press HoldThe other side hears hold music until you take the call back, transfer it or hang up. This also works on calls between colleagues. The music is the agent’s Hold sound while waiting when the call came through an agent, otherwise a default track.

The same works when both calls are internal: talk to one colleague, call a second one and press Transfer, and the two colleagues are connected to each other. A blind transfer of an internal call works too: press Transfer, dial the extension and hang up, and your colleague rings that extension as a new call. If you press Transfer while the second colleague is still ringing, the first colleague rings them instead. If nobody answers, your colleague comes back to your phone.

If a transfer cannot be completed, the phone shows it as failed and the caller stays with you; nobody is cut off. Transfers made from the phone follow the phone’s keys, not the agent’s Transfer settings above, which apply only when the agent transfers. On Calls the call row shows the transfer result.

  • Enable call transfer is off, or your plan has no call transfer.
  • The call is a browser test or a chat, not a phone call.
  • Block Transfer When Company Is Closed is on and you are outside office hours.
  • Allow transfer to external numbers is off and the destination is a phone number.
  • The person or every member of the group is offline, away or on Do Not Disturb.
  • The number is international (outside Greece and Cyprus) and the call came in on a Voice Logica number, or your trunk blocks international calls. High-cost numbers are always blocked.
  • No outbound route or trunk can dial that number.

In all these cases the agent tells the caller and offers to take a message.

You can set the exact answer for each case in the agent’s Transfer tab:

  • Transfers off: shown under the switch when Enable call transfer is off.
  • Outside business hours: under Block Transfer When Company Is Closed, when it is on.
  • After the last transfer attempt: under Transfer attempts per call, when a limit is set.
  • No one available to transfer to and The person asked for is away or busy: in Advanced → When a transfer can’t happen.

For each one pick:

  • Static: the agent says your text word for word. Use it for a fixed answer, e.g. «Our team isn’t available right now. Leave your name and number and we’ll call you back today.»
  • Dynamic: your text is an instruction the agent follows in its own words, e.g. «Offer a callback and take the caller’s name and number.»

Leave a field empty to keep the default answer. When a setting stops transfers and its field is empty, the tab shows a reminder to fill it in. The agent never says it is connecting the caller when it cannot.

With Warm and Attended, the agent comes back on the line, tells the caller it could not connect them and offers to take a message. With Blind there is no way back: once the call has left, the agent cannot help the caller.

What you see on CallsCauseFix
insufficient_balance_in_voip_provider, or sip_503 on a Voice Logica (Yuboto) numberThe number has no VoIP credit, so the carrier refused the outgoing call with 503. You also get the email Φόρτιση αριθμού Yuboto.Top up the number’s credit. Transfers to users who answer on the Windows app or a SIP phone, and to AI agents, do not need credit.
transfer_request_false (Blind)The carrier refused to forward the call. On a Voice Logica number this usually means no credit, and the call is ended.Top up, or use Warm.
no_answer, No answer after ringing timeoutNobody picked up within the ring timeout.Longer ring timeout, a group instead of one person, or check that their device is online.
busy, declinedThe person was busy or pressed Decline.-
transfer_rejectedThe person said no to the announcement.-
A recording or voicemail answered the transferWith an announced transfer, voicemail, a phone menu or a recorded message answered instead of a person, so the caller was not connected. A person who says «yes» only after other talk is asked once more, and their clear «yes» then connects.If a person did answer, open the call’s SIP log and send us the Call ID. To connect without the announcement, turn off Announce Transfer Reason for that destination.
Transfer confirmation timed outThe person answered but did not accept within 60 seconds.-
not_found, invalid_numberThe number does not exist or is written wrong.Write it in full international format, e.g. +302101234567.
unavailable, sip_<code>The destination’s network did not take the call.Try the number from a normal phone. Check your trunk with your carrier.
destination_hungup_before_mixThe person hung up before being connected.-
no licensed/online channelThe user has no connected device or no seat.See Let your users take transferred calls.
Failed to initiate trunk transferNo trunk was free to place the outgoing call (no outbound trunk, or all channels busy).Check Routing - Outbound and your trunk’s channel limit.

Start on Calls. Open the call: the transfer status, the reason and the SIP log are there.

Why does a transfer fail with insufficient_balance_in_voip_provider or 503?

A transfer to a phone number is an outgoing call. On a Voice Logica number it is paid from that number’s VoIP credit, so when the credit is empty the carrier answers 503 and the transfer fails: top up the credit. On your own carrier, check your balance with them.

Why doesn't my colleague's phone ring when the agent transfers the call?

Check in Active directory that the person has a seat and appears under Online devices, and that they are not on Do Not Disturb or away. A SIP phone must be registered, and the Windows app must be signed in.

Why does the caller end up in voicemail after a transfer?

That is what Blind transfer does: nobody checks that a person answers. Switch that destination to Warm, so the caller is connected only when a person answers.

Why does the agent transfer callers to the wrong destination?

Make each line of the Routing Instructions on the Transfer tab specific, and use Specific destinations instead of allowing every destination.

Why can't I pick AI agent as a transfer destination?

Transferring to an AI agent needs a second agent in the company. Create one, or upgrade if your plan is at its agent limit.

Why does the agent's Required checklist mention transfer?

Required in the agent editor header lists what will fail on a real caller. Open the named item and fix it: empty Routing Instructions, an empty specific destinations list, an incomplete destination row, Handle Silence set to forward while transfer is off, or a prompt that talks about transferring while transfer is off.