Skip to main content

Before you start

Two or more AI agents on the same line — the same WhatsApp line, the same SMS number, or the same Facebook Page. A transfer never crosses lines.
On SMS, every agent involved runs on Lumina. Aurora agents aren’t listed as destinations and can’t use the tool.
On Messenger, the destination answers incoming messages. An agent that doesn’t is never offered.
Write permission for the channel — WhatsApp, SMS or Messenger — to create the tool and attach it to agents.
The tool is a channel’s tool. A WhatsApp transfer tool lists WhatsApp agents and is attached to WhatsApp agents; SMS and Messenger each have their own.

Steps

Open the channel's tool library

Chat → WhatsApp → Tools, Chat → SMS → Tools or Chat → Messenger → Tools, then create a new tool.

Pick the type

In the Configure rail, choose Transfer to another AI agent — “Hand the chat to a better-suited AI agent”. In lists it carries the AI TRANSFER badge.
The type can’t be changed after creation. To turn a transfer tool into something else, create a new tool.
New WhatsApp tool in the tool builder, with the Transfer to another AI agent card (AI TRANSFER badge) selected in the Configure rail and the AI Agent Transfer pane showing the How it works note and an empty Destination 1 with Pick an agent and a When to transfer to this agent box.

The tool type cards, with Transfer to another AI agent selected

Add the destinations

Under Destinations, press + Add agent for each agent this one can hand the chat to. For each destination:
  • Agent — pick it from the list. You can search by name, number or Page. Each agent can only appear once.
  • When to transfer to this agent — the topics that agent owns. The AI reads this text to decide where to go, and a topic check compares it with what the customer actually wrote.
Destinations are shown to the agent in the order you list them; use Move up / Move down to reorder.
Write each “when” as a list of topics, not as an instruction: “The customer asks about tyres, tyre prices or tyre fitting”. Vague texts like “anything else” make the topic check reject transfers, or worse, let wrong ones through.
A saved Transfer to another AI agent tool for WhatsApp: the How it works note, Destinations with a count of 4, Destination 1 Ventas Llantas and Destination 2 Peajes TAG each showing the line and direction (Inbound & outbound, Inbound) and its When to transfer to this agent text, and the Summary panel listing Transfers to.

WhatsApp: each destination has its own when

Transfer to another AI agent tool for SMS with the notice Only works with Lumina SMS agents, the How it works note, and two SMS agent (Lumina) destinations, SMS Llantas and SMS Peajes, each showing its number and its when text.

SMS: only Lumina agents are listed

Transfer to another AI agent tool for Messenger with Destination 2 FB Peajes on the Rueda Firme Page and Destination 3 FB Postventa marked No Page with the warning This agent is not on any Facebook Page, so it is never offered, plus a warning under the list that the agents are on different Facebook Pages.

Messenger: an agent on no Facebook Page is never offered

The builder warns you, but still lets you save, when:
  • “This agent is switched off — it is skipped until you turn it back on.”
  • “These agents are on different WhatsApp lines. In each conversation only the ones on that conversation’s line are offered.” (SMS: different numbers; Messenger: different Pages.)
  • Messenger only: “This agent does not answer incoming messages — it is skipped until you turn that on.” and “This agent is not on any Facebook Page, so it is never offered.”
  • “Agent #ID no longer exists. Pick another agent or remove this destination.”
Saving is blocked when there’s no destination (“Add at least one agent to transfer to”), a destination has no agent or no “when”, or the same agent appears twice.

Save the tool

The tool is now in the library. It does nothing until it’s attached to an agent.

Attach it to every agent that should transfer

Open each agent, press Tools in its top bar, tick the transfer tool and save the agent.The row shows Transfers to: followed by the destinations. On WhatsApp and SMS, destinations that aren’t on that agent’s line are listed separately: “Not on this agent’s line, so never offered here: …” (SMS: “Not on this agent’s number…”).
The Tools window of the Ventas Llantas agent with two tools ticked, a Handoff tool and transferir_al_especialista with its AI TRANSFER badge, whose row reads Transfers to: Peajes TAG, Asistencia en vía, Promociones (inactivo).

The agent's Tools window: what this agent can transfer to

Transfers only go where a tool sends them. If agent A carries the tool and agent B doesn’t, B can never send a customer back to A. For two-way transfers, attach the same tool to both — an agent never transfers to itself, so listing it as a destination on its own tool is harmless.

Write the Alcance block in each agent’s prompt

The tool gives the agent the ability to transfer. The prompt has to say when not to. Without a scope block, an agent asked about something nobody handles tends to transfer it to whoever is listed — a tyres agent hands a travel-insurance question to the toll-tag agent, which then has to say “we don’t sell that”. Add a block like this to every agent that carries the tool, adjusted to its topics.
Why each line matters:
Dialtu adds its own hidden instructions on top: when no transfer is possible, the agent is told to help first and to ask before handing off to a person. The Alcance block makes that behaviour consistent instead of leaving it to the model.

Check it in the test chat

Open an agent that carries the tool, go to the Test tab and ask about a topic owned by a destination.
  • The transfer appears as a terminal card: “Transferred to another AI agent — not performed in a test”. Its detail reads would transfer to Tyres Agent: … with the agent’s reason.
  • If the topic check rejects it, you’ll see would not transfer: topic_mismatch with a one-line explanation, and the agent keeps answering.
  • The test chat never switches agents. To see the second agent’s reply, test that agent directly.
The test chat checks less than a live conversation. It checks the line, that the destination is active, and that it isn’t the same agent — but not the direction or the client tag audience. A transfer that works in the test can still be skipped in a real conversation for those reasons. On Messenger, a brand-new agent that hasn’t been saved yet has no Page, so it’s offered no destinations in the test.

What doesn’t exist

  • Transfers across lines, numbers or Pages.
  • Automatic return to the first agent.
  • Aurora SMS agents as a source or destination.
  • Web Chat and voice — voice has its own agent swap.
  • Changing the tool type after creation.

Next step

How transfers work

Eligibility, limits, the topic check and every note you’ll see in Conversations.