The Request agent step
This is the handover mechanism inside a workflow. When the script reaches it, the conversation is marked as waiting for a person, an "agent requested" line is added to the thread, and the conversation sits in your inbox unassigned until somebody opens it.
Add it like any other step: click Add new action on the card where the handover should happen and pick Request agent. It has one optional setting — a message for the visitor at the moment of handover. Leave it empty and Yaplet uses its own wording.
What the visitor sees next
It depends on whether anybody who has access to this brand is online at that moment, and Yaplet checks that for real rather than assuming:
- Somebody is online. The visitor gets your expected-reply-time line — the one you set at Brand → Chat widget → Messages → Reply Time Text — so they know roughly how long they are waiting.
- Nobody is online. The visitor gets a short built-in "we are not available right now" notice, and if Yaplet does not already have their email address, an email box appears so they can leave one and be answered later.
Both messages are stored in the conversation, so a colleague opening it afterwards sees exactly what the visitor was told. There is no page anywhere in Yaplet for editing the offline notice — it is built in, in the widget's language.
What your colleague sees
- The whole scripted conversation, in order — every message the bot sent, every button the visitor clicked, and every answer they typed.
- The visitor's email address on their profile, if the script collected one.
- The same thread, continued. The visitor never has to repeat themselves.
Who is allowed to pick it up
Access is decided per brand. A teammate can only see a conversation if they have been granted the brand that the chat widget belongs to. Owners and administrators always have access to every brand; everyone else is granted brands explicitly.
- Open your account menu — your avatar in the top right — and choose Manage team.
- Open the teammate.
- Under Brand access, switch on the brands they should be able to work in, and save.
This also decides the "is anybody online?" check above: only people who can actually open the conversation are counted as available.
Setting expectations before the handover
Put a Show expected reply time step immediately before Request agent. It posts the wait-time line on its own, before the handover happens, which reads better than dropping someone into a silent queue.
Handing over to the AI instead
If what you want is an AI answer rather than a person, use Send to VEX AI in place of Request agent. You write the question that gets passed over, and the brand's Vex agent answers it from everything the brand knows. The brand needs a Vex agent for this to do anything at all.
There is a related setting worth knowing about on the AI side. On Brand → Vex → Personality → Agent Handoff there is a switch called Automatic Agent Handoff. When you turn it off, the screen tells you why you probably want a workflow instead: without it "the AI might tell visitors it's connecting them to an agent without actually doing so". It even names the recipe — build a workflow for this brand with the trigger User says and the intent "The user wants to talk to the support team", and let that workflow do the handing over.
One channel note
A Request agent step rules the whole workflow out of phone calls. On a call there is nobody to hand the caller to, so a script containing this step is simply never offered on the phone. It works normally in chat and in Facebook and Instagram messages.
Next step
Learn how several workflows behave when they could all fire at once: Run multiple workflows at the same time. Not sure whether to script this at all? Which chatbot should I use — Vex AI or workflows?