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
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.

Where a call can go
Section titled “Where a call can go”| Destination | What it is | What happens |
|---|---|---|
| User | A person in Active directory with a seat | Their devices ring. The first one answered gets the caller. |
| User group | A team from User Groups | Members ring in order until one answers. |
| AI agent | Another agent in the same company | The other agent takes over the same call. No ringing, no new call. |
| External number | Any phone number | A new outgoing call to that number, then the caller is connected. |
Let your users take transferred calls
Section titled “Let your users take transferred calls”A person can only receive a transfer on a device that is connected. Do this once per person:
-
Add the person and give them a seat
Telephony - Active directory. See Users, seats and devices.
-
Connect at least one device
Device Rings when Windows app The person is signed in to the app. SIP phone or softphone The person has a SIP seat and the phone is registered (shown under Online devices). Personal mobile Also 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.
-
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.
-
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.
First setup
Section titled “First setup”-
A real number already rings this agent
Get a number. Try this agent in the browser cannot transfer: transfer works only on phone calls.
-
Turn Enable call transfer on
Off: the agent cannot transfer. Your settings stay saved.
-
Choose the transfer behavior: Warm, Attended or Blind. See How the handoff works.
-
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.
-
Add the destinations
Allow the AI to transfer to any enabled destination in this companyEvery enabled user and user group in the company, plus anything you add below.Specific destinationsOnly 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.
transfer-add -
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.
How the handoff works
Section titled “How the handoff works”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).
For the other destinations the behavior is fixed:
| Destination | Behavior |
|---|---|
| User / User group | Always waits for a person to answer, whatever you choose. The caller hears hold music while the devices ring. |
| AI agent | The new agent continues the same call. |
| External number | Warm, Attended or Blind as chosen. |
Options for Warm and Attended:
Who keeps the call after the transfer
Section titled “Who keeps the call after the transfer”With Warm and an announcement, once the person accepts, the caller can be connected in one of three ways:
| How | What happens | Channels 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 PBX | The 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. |
| Attended | Your 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.
Transfer from a desk phone
Section titled “Transfer from a desk phone”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 phone | What happens |
|---|---|
| Blind transfer: press Transfer, dial the extension, hang up | The 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 up | The 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 Transfer | The 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 Hold | The 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.
When the agent will not transfer
Section titled “When the agent will not transfer”- 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.
Choose what the agent says
Section titled “Choose what the agent says”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.
How a transfer can fail
Section titled “How a transfer can fail”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 Calls | Cause | Fix |
|---|---|---|
insufficient_balance_in_voip_provider, or sip_503 on a Voice Logica (Yuboto) number | The 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 timeout | Nobody picked up within the ring timeout. | Longer ring timeout, a group instead of one person, or check that their device is online. |
busy, declined | The person was busy or pressed Decline. | - |
transfer_rejected | The person said no to the announcement. | - |
A recording or voicemail answered the transfer | With 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 out | The person answered but did not accept within 60 seconds. | - |
not_found, invalid_number | The 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_mix | The person hung up before being connected. | - |
no licensed/online channel | The user has no connected device or no seat. | See Let your users take transferred calls. |
Failed to initiate trunk transfer | No trunk was free to place the outgoing call (no outbound trunk, or all channels busy). | Check Routing - Outbound and your trunk’s channel limit. |
Troubleshooting
Section titled “Troubleshooting”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.
