> For the complete documentation index, see [llms.txt](https://docs.askyazi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.askyazi.com/monitor-fieldwork/agent-takeover.md).

# Agent takeover

Take over a live WhatsApp conversation from the study, message the participant yourself, and hand back cleanly.

Agent takeover (shown in the app as human moderator takeover) lets you step into a participant's WhatsApp chat and talk to them yourself, by text or voice note. The study pauses for that person while you hold the chat. When you hand back, they carry on where they left off.

{% hint style="info" %}
**In short:** open **Responses > Transcripts**, pick the participant and click **Connect**. Everything they send reaches you, not the bot. Hand back with **End chat** or **Release**. A held chat is released automatically after 60 minutes without moderator activity, with a warning at 45. To message someone who has been quiet for more than 24 hours, use **Request to chat**.
{% endhint %}

## When to use it

* A participant says something worth exploring further than the AI went.
* Someone is confused about a question or stuck.
* You want to ask one unscripted question.
* A participant raises something sensitive that needs a human.
* After reading transcripts, you want to follow up with the most interesting few people.
* A participant has a problem (for example a reward question) that needs a person.

Takeover works on every study type: surveys, AI interviews, diaries and multi-activity studies.

## Take over a chat

{% stepper %}
{% step %}

### Open Transcripts

Go to the study's **Responses** tab and open **Transcripts**. Search for the participant by name or number and select them. You can also open a participant's transcript from the **Share** tab.
{% endstep %}

{% step %}

### Read the conversation first

The transcript shows everything so far: their answers, the AI's questions, media with transcriptions, broadcasts they received and any reactions. Know what you want to ask before you start.
{% endstep %}

{% step %}

### Connect

Click **Connect** (top right of the transcript). The study pauses for this participant. From now on every message they send comes to you, never an automated reply.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FYHXbf1MOqM0YCVIAf6L4%2Ffs-transcript-open.webp?alt=media&amp;token=58641afe-963c-4d8a-917d-c7e09d163fc8" alt="A transcript open in WhatsApp style, with Connect to take over the chat and the 24-hour window notice with Request to chat"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Message them

Type a message, or record a voice note, play it back and send it. They receive it in the same chat, from the same number, as a normal message or a normal playable voice note. You send either text or a voice note at a time, not both together. Their buttons, list choices, forms and stickers show to you as readable text.
{% endstep %}

{% step %}

### Hand back

When you are done, end the chat. The participant goes back to the study at the question they were on, and the question is sent to them again so they know where they are.
{% endstep %}
{% endstepper %}

## What the participant sees

Messages continue in the same WhatsApp chat from your study number. Nothing announces the switch. If it matters for your research ethics, tell participants that a researcher may join the conversation, for example in your welcome message.

## Holding several chats

Chats you hold appear in a slim strip at the top of the takeover list and on the dashboard, with **Open chat** and **Release** for each, so you can hold several chats and switch between them. Only one moderator can control a given chat at a time.

## Automatic release

* If you do nothing in a held chat for **45 minutes**, you get a warning.
* At **60 minutes** without moderator activity, the chat is handed back to the study.
* If the participant starts a study, taps a start button or sends a study code, an old takeover ends automatically so they are never left talking to nobody.
* A short internet drop on your side reconnects by itself, with a "Connection lost" banner while it does. A hidden browser tab keeps the takeover alive.

While you hold a chat, the participant does not receive their next scheduled activity. Release the chat when you are done.

## The 24-hour window and Request to chat

WhatsApp only lets you send normal messages within 24 hours of the participant's last message. Chats outside that window show an **Out of 24hr** badge in the list, based on when the participant last messaged.

To reach someone outside the window:

1. Open their chat. The takeover screen shows a **Request to chat** card.
2. Click it. Yazi sends them an approved WhatsApp message with two buttons, **Accept** and **Opt out**. If your organisation does not have this message yet, Yazi creates it (in English or Portuguese), waits for WhatsApp to approve it and then sends it.
3. If they tap **Accept**, you see it straight away and can connect. **Opt out** is a real opt-out.

A participant who has just sent your study's start phrase is inside the window and can be messaged straight away. See [WhatsApp costs and the 24-hour window](/reach-participants/whatsapp-costs-and-the-24-hour-window.md).

## What is recorded

Everything in a takeover is saved in the transcript and in exports, alongside the AI's messages and the participant's replies. Moderator messages can be told apart from AI messages in the data.

{% hint style="warning" %}
**Delete Transcript** in the takeover panel deletes the participant's conversation, resets their progress in the study and cancels their queued messages. Use it only for test runs.
{% endhint %}

## Tips

* Match the tone the participant is used to. Keep it short and conversational.
* Reference something they said earlier, so it feels like a continuation.
* Reply quickly. Once a person is talking to you, slow replies feel like being ignored.
* Hand back as soon as you are done, so the study can continue.

## Limits and things to know

* Outside the 24-hour window you can only reach the participant through **Request to chat**.
* On studies with Privacy Protection, the participant's name stays hidden in the takeover screen too.
* Very long moderator conversations push earlier context further back for the AI when it resumes an interview. Keep interventions focused.
* You cannot send text and a voice note in one message.

## Related

* [Transcripts](/results-and-reporting/transcripts.md)
* [Participants tab](/monitor-fieldwork/participants-tab.md)
* [WhatsApp costs and the 24-hour window](/reach-participants/whatsapp-costs-and-the-24-hour-window.md)
* [AI interviews](/study-types/ai-interviews.md)
