# Take over a conversation

> Stop the agent on one conversation, answer yourself from the same WhatsApp number, then hand the conversation back when you are done.

Source: https://docs.whatsetter.com/dashboard/human-takeover/

Your agent answers on its own. On any conversation you can step in: the agent
goes quiet for that person, you answer from the same WhatsApp number, and you
hand the conversation back when you are done.

## Who is answering: the line above the message box

Open a conversation in **Conversations**. Above the message box, or in its
place, one line says who answers. "Léa" stands for your agent's name.

| What you read | Meaning | Button |
|---|---|---|
| "Léa is answering for you" | The agent answers this lead. There is no message box. | **Take over** |
| **You have it.** | The conversation is taken over. The agent no longer answers in it. | **Hand back to** and the agent's name |
| **The AI is paused.** | The agent is off on this lead and nobody took it over. Nobody answers in your place. | **Hand back to** and the agent's name |
| **You answer here.** | The number follows your groups: no agent answers there. | None |
| **WhatsApp number disconnected** | Nobody can answer until the number is linked again. | **Reconnect** |

## Take over a conversation

1. Open **Conversations** and click the conversation.
2. Click **Take over** on the line under the conversation. Nothing else is asked.
3. The message box appears with the cursor in it. Write your message and press Enter.

From that moment:

- the conversation shows the note "Taken over: the AI no longer answers";
- it is listed in the **By hand** view;
- if nobody owned the lead, you become its owner.

Only this conversation changes. The agent keeps answering everyone else.

## What triggers a takeover

Five things take a conversation away from the agent:

- clicking **Take over** in a conversation of **Conversations**;
- clicking **Take over** on the **AI** line of a lead's panel in **Leads**;
- choosing **Change and take over** when you change the stage of a lead the
  AI still handles;
- answering the lead from the phone that carries the agent's WhatsApp number;
- a call from your own tools through the API.

These do not take over: opening or reading a conversation, writing a note,
adding a label, planning a next action, changing the owner or clicking
**Take it**. While the agent answers there is no message box, so you cannot
write in its conversation by accident.

## Replying from your phone takes over too

If you answer a lead in the WhatsApp app of the phone that carries the agent's
number, the dashboard sees it:

- your message is added to the conversation, with the mention
  **from their phone**;
- the conversation shows a note that ends with "replied from their phone: the
  AI steps back";
- the agent stops answering this lead, as after **Take over**, until you hand
  the conversation back from the dashboard.

This applies to the number of an agent that is active. The "New qualified
lead" notification that leaves from the agent's number does not count as a
reply from you. See [Notifications](/dashboard/notifications/).

## What the agent stops doing

While a conversation is taken over, in this conversation only:

- the agent does not reply to the lead's new messages;
- it does not analyse them either: it will not qualify the lead or mark it
  not interested while you hold the conversation;
- automatic follow-ups are not sent.

Everything already written stays in the conversation. The agent keeps working
on all its other conversations. To let it answer this lead again, hand the
conversation back.

A takeover does not freeze the agent's labels: it keeps putting and removing
the labels you set up for this lead. It stops only when someone changes this
lead's agent labels by hand. See
[Agent labels](/dashboard/labels/#you-have-the-last-word-hand-the-labels-back).

## Hand the conversation back to the agent

In **Conversations**, click **Hand back to** followed by the agent's name, on
the line above the message box. In **Leads**, the same switch is
**Hand back to the AI**, on the **AI** line of the lead's panel. Nothing else
is asked.

- The conversation shows a note saying that the agent resumes the
  conversation, and it leaves the **By hand** view.
- Handing back sends nothing to the lead. The agent is in charge again from
  the lead's next message.
- You stay the owner of the lead.

## What the lead sees

- Your messages arrive from the same WhatsApp number, in the same chat as the
  agent's. Nothing announces that a person took over, or that the agent is
  back.
- While you type in the message box, the lead sees the typing indicator on
  WhatsApp.
- When you open a conversation you hold by hand, the lead's unread messages
  are marked as read on WhatsApp.
- A reaction you add, or a message you delete for everyone, shows on the
  lead's side too.

## How a taken-over conversation shows in the lists

- In **Conversations**, it is in the **By hand** view. Its row shows a dot
  when the lead wrote last and waits for your reply.
- In the conversation, the line above the message box reads **You have it.**
- In **Leads**, a hand icon sits next to the stage, and the **AI** line of the
  lead's panel reads **Taken over**.
- To list these leads in **Leads**, click **Filter**, then **AI**, then
  **Taken over**.
- The **History** of the lead keeps "Took over from the AI" and "Handed back
  to the AI", with who did it and when.
- In an export of your leads, the **AI** column says who answers.

## Who owns the lead after a takeover

- Taking over a lead nobody owns makes you its owner.
- Sending a message by hand to a lead nobody owns does the same: the first
  person who answers owns the lead.
- If the lead already has an owner, taking over does not change it.
- Handing the conversation back keeps the owner. Who answers and who owns the
  lead are two separate things.

To take a lead without stopping the agent, open **Details** in
**Conversations**, click the **Owner** line and choose **Take it**.

## Take over from the Leads page

Open **Leads** and click a lead. In the panel, under **Where it stands**, the
**AI** line reads **The AI answers**, **Taken over** or **AI paused**, with a
button: **Take over** or **Hand back to the AI**.

Changing the stage of a lead the AI still handles opens a window titled
**The AI is still handling this lead**. It says what the AI will do with the
new stage and offers:

- **Change the stage**: the AI is told and carries on;
- **Change and take over**: the AI stops writing and the lead is yours.

The panel does not send messages. To write to the lead, click
**Reply in Conversations**.

## The Take over button asks for a permission

In **Conversations** and in **Leads**, taking over, replying by hand and
handing back all need the **Reply by hand** permission. Without it, the
button opens a message saying the action is restricted. Ask an admin of your
team to change your access. See [Team & roles](/dashboard/team/).

A member whose leads are set to **Their own and the unclaimed** can take over
their own leads and the leads nobody owns, not a colleague's.

## No Take over button: the number is disconnected

In **Conversations**, when the agent's WhatsApp number is no longer linked,
the line and its button are replaced by the notice
**WhatsApp number disconnected**. Nobody can answer this lead, neither you
nor the AI, so there is nothing to take over.

Click **Reconnect**: the **WhatsApp numbers** page opens with the connection
window already open for the agent of this conversation. Link the number's
phone with the code, with nothing to look for. For the number that follows
your groups, the button opens the **WhatsApp numbers** page, where that number
has its own **Reconnect** button. This needs the
**Reconnect a number (QR code)** permission. The message box
comes back by itself once the number is connected. See
[Connect WhatsApp](/getting-started/connect-whatsapp/).

## Conversations where no agent answers

Private messages received on a number that follows your WhatsApp groups are
listed in **Conversations** too. No agent answers on that number, so there is
nothing to take over and nothing to hand back:

- the message box is always open;
- the line above it reads **You answer here.**;
- the conversation has no stage.

See [Conversations](/dashboard/conversations/) for what these conversations
show, and [WhatsApp groups](/dashboard/groups/) for the groups themselves.

## Take over from your own tools

Your CRM or your own tools can stop the agent on a lead and start it again
through the API. It is the same switch as **Take over** in the dashboard, so
the two always agree. It applies to leads the agent has already contacted.

The calls, their answers and their errors are in the developer guide:
[API: leads](/developers/guides/leads/). To send your own messages after a
takeover, see [API: messages](/developers/guides/messages/).

## Related

- [Conversations](/dashboard/conversations/)
- [Leads & CRM](/dashboard/leads/)
- [Numbers the agent ignores](/dashboard/blocked-numbers/)
- [Team & roles](/dashboard/team/)
