Blog · WhatsApp handoff
How to hand a WhatsApp chat from the bot to a person, without the bot talking over them
To hand a WhatsApp chat from the bot to a person, list in the agent's instructions which cases need a human and switch on the "Request human takeover" tool. The agent pauses AI replies in that one chat, tells the customer someone will reply there, and alerts you. You answer from the same chat, then resume the AI.
Key takeaways: The pause covers one chat, never the whole account, and the AI only returns when someone switches it back on. Write down exactly which cases go to a person, and test it from a phone that isn't yours.
What should a good handoff do?
A good handoff does three things: the bot stops replying in that chat, the customer knows what is happening, and someone on your team hears about it with enough context to answer. Some questions an agent should not settle alone: a wholesale price, a discount that isn't on the list, a complaint about a damaged order. A bot without a handoff either invents an answer or says "let me connect you with an agent" and then keeps replying over whoever stepped in. That second failure is the one customers notice most, because two voices answer the same question differently. With Super Agent, the handoff is built so the pause is real and the thread reaches your team complete.
What happens when the agent asks for help?
Four things happen, and the last one is the one owners most often get wrong.
- The AI pauses in that chat. Every other chat is still answered. Whatever the customer writes meanwhile shows in the conversation, but the agent does not reply to it.
- The customer is told, once. With "Send the customer a short acknowledgement when a takeover starts" on, the agent says a person from the team will reply in this same chat. It promises no time and no name.
- You are alerted. The alert always appears under Notifications, and the "Needs you" filter on Conversations gathers the chats waiting for someone. If you also choose WhatsApp, the operator's number gets a message with the priority, the customer, the channel, a summary of what they asked and a link to the conversation.
- It never resumes by itself. Not after a while, and not because you replied: the AI comes back when someone turns the chat's "AI replies" switch back on. When it does, it skips what arrived during the pause and answers only new messages.
The same switch also pauses a chat by hand, and on WhatsApp the pause covers that customer on all of your numbers. Handoff works on WhatsApp, Instagram, Messenger and your website chat, and on every one of them you can reply by hand from the console.
How do you set up the handoff?
Setup takes six steps and about the time of one coffee, and the only part that needs real thought is the third one: deciding when a person should step in. The tool grants permission to hand over, but your instructions decide when the agent uses it. If you haven't created your agent yet, you can create a free account and put your website in, and we write the first agent for you. The steps below assume the agent exists.
- Connect your channels under Integrations: your WhatsApp Business number, your Instagram account, your Facebook Page or your website chat.
- Switch on the tool. In the agent's settings, under "Bring in a real person", turn on "Request human takeover". Initial setup leaves it off, because it first needs to know whom to alert.
- Write down when to hand over. For example: "Hand the conversation to a person when someone asks for a wholesale price or a discount that isn't on the list, when there is a complaint about a damaged or missing order, or when the customer asks to talk to a person. Complaints are urgent."
- Choose how you are alerted. Under "Alert me via", the in-app alert is always on. To get it on WhatsApp too, enter the operator's WhatsApp number and pick the alert template. You can create it from that screen: Meta reviews it, and until it is approved alerts reach the console only. Send a test alert before you rely on it.
- Test it from another number. If your own contact is marked as the business owner, the agent will not hand you over (there is nobody to hand you to) and answers you directly. Write from a phone that isn't yours, or ask a teammate.
- Take the chat, then resume. Open it from the alert, reply there, and when you are done turn "AI replies" back on.
If the alert template gets rejected, the problem is usually in the wording, and why Meta rejects your WhatsApp template walks through the common causes. For deciding which conversations belong to a person in the first place, AI sales agent or human seller gives a practical split.
What does a handoff look like in a real chat?
Take a clothing store whose instructions say wholesale orders go to a person, with the WhatsApp alert on. The customer, number and order below are made up for the example. A customer writes: "Hi, I run a shop and want 40 T-shirts to resell. What price can you do?" The agent answers: "Thanks for getting in touch. Wholesale orders are handled by someone on our team, who will reply to you right here." It does not quote a price it can't back up, and the customer knows what comes next.
At that moment the operator's phone receives an alert like this:
A customer needs a person.
Priority: Normal
Customer: Laura M.
Channel: WhatsApp +573001234567
What they asked: Wants 40 T-shirts to resell and asks for a wholesale price.
Open the conversation: (link to the chat)
The AI has stopped replying in that chat until someone resumes it.
If Laura writes again ("and do you ship to Medellín?"), the message shows in the chat but the agent leaves it alone, because a person owns the conversation now. Whoever takes it opens the link, reads the whole thread and replies from the console. Replying to the alert message itself does nothing: it never reaches Laura.
What if you reply from the WhatsApp Business app?
If the number you connected is the one you also use in the WhatsApp Business app, you can answer from the app or from WhatsApp Web, and the AI pauses in that chat on its own. Those messages show as "Sent from WhatsApp" and pause the AI even if the agent never asked for help, so you don't need to touch any switch before typing. Resuming works the same as before, by hand. The exception is your own owner contact: what you send yourself pauses nothing. If you are still deciding how to keep the app and add an agent, connecting your current number without losing customers covers it.
Which way of stepping in should you use?
| Way in | Who starts it | What happens to the AI | How it resumes |
|---|---|---|---|
| Agent requests a takeover | The agent, following your instructions | Pauses in that chat; customer gets one acknowledgement; you are alerted | You switch "AI replies" back on |
| You reply from the WhatsApp Business app or WhatsApp Web | You | Pauses in that chat on its own | You switch "AI replies" back on |
| You pause a chat by hand | You | Pauses with the same switch | You switch "AI replies" back on |
How long can a chat wait for a person?
On WhatsApp, not long: once 24 hours have passed since the customer's last message, you can no longer write freely and need a template Meta has approved, as WhatsApp's own documentation on sending messages explains. A chat that sits under "Needs you" overnight is therefore fine, but one that sits for two days may need a template to reopen. Make a habit of checking that filter at the start and end of your day. The article on the WhatsApp 24-hour window explains how to keep the sale when it closes.
Frequently asked questions
Can a customer switch the bot off by typing "I want a human"?
That depends on your instructions. If they say asking for a person is a reason to hand over, the agent does. If they don't, it keeps answering: the tool is designed so a customer cannot turn the AI off just by asking.
What if the WhatsApp alert fails?
The pause holds, the alert stays under Notifications, and the chat reads "Human reply requested — alert failed", with a button to retry it. The bot never ends up replying over the customer.
What if nobody answers in time?
The chat keeps waiting under "Needs you". On WhatsApp, reply soon: 24 hours after the customer's last message you need an approved template to write. See the 24-hour window explained.
How do I know how many chats the agent handles without me?
On Conversations, "Handled without you" counts the chats the agent never had to hand to a person.
Does the handoff work on Instagram and my website chat?
Yes. It works on WhatsApp, Instagram, Messenger and your website chat, and on each one you can reply by hand from the console.
Every question the agent can settle is one less chat waiting for a person, so the handoff works best next to good answers. If you sell on Shopify, connect the store so the agent can look up prices, stock and the order of the person writing. When you are ready, start on the free plan, no card needed, and decide which cases come to you. You may also find this useful: Confirm the shipping address on WhatsApp before dispatch: fewer returned packages.
An agent that knows when to hand you the chat
Create your free account, put in your website and decide which cases the agent passes to you. No card needed, and it can be running the same day.
Start for freeFree plan, no credit card. See plans and pricing.
Keep reading
- All the guides on the blog
- Confirm the shipping address on WhatsApp before dispatch: fewer returned packages
- AI sales agent or human seller: which store conversations to give each one
- The WhatsApp 24-hour window: how it works and how to keep sales when it closes
- From the WhatsApp Business app to the API: how to connect your current number without losing customers
- Why Meta rejects your WhatsApp template, and how to fix it before you resubmit
- Store FAQ generator
- Missed-reply revenue calculator
- Free tools for online stores