# Conversations

> Read every conversation your agents hold, see which ones are waiting for a reply, filter and search the list, reply by hand and export a transcript.

Source: https://docs.whatsetter.com/dashboard/conversations/

**Conversations** holds every private conversation between your agents and the
people they talk to. You read what the agent said and decided, you see who is
waiting for a reply, and you answer by hand when you want to.

## What the Conversations page shows

Open **Conversations** in the **Run** group of the menu. The page has three
parts:

- on the left, the list of conversations, with three views, a search field,
  the **Filter** menu and a sort button;
- in the middle, the open conversation, with the message box under it;
- on the right, **Details**: the lead's stage, notes, labels and actions.

**Details** sits beside the conversation when the screen is wide enough. On a
narrower screen it opens as a panel over the page. On a phone you see one part
at a time: the list, then the conversation, with a back arrow.

The list loads 25 conversations at a time and loads the next ones as you
scroll. It refreshes by itself every 60 seconds, and the messages of the open
conversation arrive live.

You need the **Read conversations** permission to open this page. See
[Team & roles](/dashboard/team/).

WhatsApp Statuses posted by your contacts, WhatsApp channels and broadcast
lists are not received: they never appear in **Conversations** or **Leads**,
and your agent never answers them. Messages from your groups are on the
**Groups** page. See [WhatsApp groups](/dashboard/groups/).

## The three views: All, To do, By hand

At the top of the list in **Conversations**, three views sort the work:

| View | What it contains |
|---|---|
| **All** | Every conversation of your agents. |
| **To do** | The conversations where a lead wrote and nobody answered, neither the AI nor a person, for more than 30 minutes, over the last 48 hours. A lone emoji does not count. It also lists the leads whose planned next action is past its date. |
| **By hand** | The conversations someone took over. The AI does not answer them until they are handed back. |

**To do** shows a counter as soon as it holds at least one conversation, with
your filters applied. When nothing waits, the view reads
**Nobody is waiting for your reply**.

The page opens on **All**. During your session, the page comes back to the
view, the filters and the sort you left.

The agent never passes a conversation to a person. There are only two cases:
the agent answers on its own, or someone clicks **Take over**, then
**Hand back to** followed by the agent's name when they are done.

## What a row of the list tells you

In **Conversations**, each row of the list is one conversation: one person
with one agent. It shows:

- the name, or the phone number when no name is known, and the time of the
  last message. For a contact of an imported list whose row gives a first name
  and a last name, the row shows both, for example "Erika Musterfrau". This
  changes nothing in what the agent calls the person;
- the last message, with who wrote it in front: the agent's name, **You** or a
  teammate's name. A voice note reads **Voice message**, a picture **Photo**,
  a file **Document**;
- a dot when the lead wrote last and a person owes the answer, because
  someone took the conversation over or the AI is paused on it;
- one more line when there is something to act on:
  **Waiting for your reply**, **Action overdue**, a booked meeting with its
  date, **Qualified, no meeting** or **Action today**.
  **Waiting for your reply** shows when a person took the conversation over
  and the lead wrote last;
- the owner of the lead, when your team has several members.

A name in bold is new since your last visit, or waits for your reply.

## Search a conversation

Type in the **Search** field at the top of the list in **Conversations**. The
search looks at the lead's name, phone number and email. It does not look
inside the text of the messages.

- Type a number the way you write it, with spaces or a plus sign: the digits
  are matched.
- The list shows how many conversations were found.
- Press `/` to jump to the search field. Press Esc in the field to empty it.
- A search applies inside the view you are on. If you find nothing in
  **To do**, switch to **All**.

## Filter the conversations

Click **Filter** above the list in **Conversations**, or press F. The menu asks
one question at a time, in three groups:

| Group | Questions |
|---|---|
| **Ownership** | **Agent** (one or several) and **Owner**: **Mine**, **Nobody** or a teammate. |
| **Follow-up** | **Stage**, **Next action** (**Overdue**, **Today**, **Upcoming**), **Meeting**, **Outcome** (**Won**, **Lost**) and **Labels**. |
| **Origin and period** | **Origin**, **Country**, **A/B variant** and **Last message** (**Today**, **Last 7 days**, **Last 30 days**). |

Each choice appears as a chip under the search field. Click the cross on a
chip to remove it, or **Clear all** to remove every filter and the search.

A question shows only when it has an answer: **Agent** with more than one
agent, **Owner** with more than one member, **Labels**, **Origin** and
**Country** when your leads have some, **A/B variant** when one agent is
picked and it runs an [A/B test](/dashboard/ab-variants/). A member limited to
their own leads sees **Mine** and **To take** under **Owner**.

## Sort the list

Click the arrows button next to **Filter** in **Conversations**:

| Sort | Order |
|---|---|
| **Newest first** | By last message, most recent first. This is the default. |
| **Oldest first** | By last message, oldest first. |
| **Next action** | By the date of the next action. Only the conversations that have one are listed. |
| **First contact** | The latest leads first. |

The time shown on each row follows the sort: last message, next action or
first contact. With **Next action**, an overdue date is highlighted.

## See the leads waiting for their first message

In **Conversations**, click **Filter**, then **Stage**, then
**In the sending queue** under **Not contacted yet**. The list then shows the
leads who have not been written to yet, soonest first, each with the planned
time of its first message. It holds up to 100 leads. Pick one agent under
**Agent** to see only its queue.

Under the same heading, **First message held back** shows the leads whose
first message was held back and never left.

An open conversation that is still in the queue says when the first message
will leave, with a countdown.

A lead whose first message has not left yet shows
**First message pending** in the list, and the note "First message not sent
yet" in the conversation.

The pace of first messages is set on the list. See
[Lists & import](/dashboard/lists/).

## Read a conversation

Click a row in **Conversations**. The top of the conversation shows the lead's
name, the stage, the phone number (click it to copy it) and, when you have
several agents, the name of the agent. **Hidden number** means WhatsApp did
not share the number.

In the conversation:

- the lead's messages are on the left, yours and the agent's on the right;
- above each group of messages from your side, a line says who wrote it: the
  agent's name with **AI**, **first message** or **automatic follow-up**,
  **You**, or a teammate's name. A reply sent from the phone reads
  **from their phone**;
- when the agent runs an A/B test, that line also names the variant;
- centred notes mark what changed: the lead was qualified, marked not
  interested, taken over, or handed back to the agent.

Each day starts with its date.

## Photos, voice notes and documents

In an open conversation of **Conversations**:

- click a picture to open it full screen. Zoom with the mouse wheel and
  double-click to reset;
- a voice note plays in the conversation. Its transcript appears under the
  player once it is ready;
- a document opens in a new tab, where you can download it;
- reactions appear under the message they belong to.

When a file can no longer be loaded, the message reads
**Image unavailable**, **Document unavailable** or **Audio unavailable**. The
rest of the conversation is not affected.

## The Details panel

Open a conversation in **Conversations** and click **Details** at the top
right. The panel shows, from top to bottom:

- **Where they stand**: the next action, the stage, the meeting, the owner and
  the outcome. You change each one here, as on the
  [Leads](/dashboard/leads/) page;
- **Notes**: write a note for your team and read the latest ones;
- **Labels**;
- **Groups**: the followed WhatsApp groups this person is a member of;
- **About**: the agent, where the lead comes from, the first contact, the
  number of messages and the email;
- the actions: **Open the full record**, **Copy the conversation**,
  **Download the conversation**, **Stop the AI answering this number** and
  **Delete this lead…**.

Click **Hide details** to fold the panel. Your choice is kept on this browser.
Changing a stage, a note or a label needs the **Edit leads** permission.

## Reply by hand

1. Open the conversation in **Conversations**.
2. If the agent is answering, click **Take over**. The message box appears and the agent stops answering this lead.
3. Write your message and press Enter. Shift+Enter adds a line break.
4. When you are done, click **Hand back to** followed by the agent's name.

Your message leaves from the agent's WhatsApp number, in the same chat. In the
conversation it is signed **You**, and with your name for your teammates.

On WhatsApp there is no time limit to reply: you can write at any time.

Replying needs the **Reply by hand** permission. What taking over changes for
the agent is on [Take over a conversation](/dashboard/human-takeover/).

## Send a file or a voice note

In **Conversations**, once you have the conversation by hand:

- click **Attach file** (the paperclip) to send one file at a time. Accepted:
  JPEG, PNG, GIF and WebP images, and PDF, Word, Excel, text, CSV and ZIP
  files, up to 3 MB. You can add a caption before sending;
- click **Record voice message** (the microphone) to record. The microphone
  shows while the message box is empty. Click **Stop recording and send** to
  send, or **Cancel recording** to drop it.

Your browser asks for access to the microphone the first time. If you refuse,
recording stays impossible until you allow it in the browser settings.

## React to a message or delete one

In an open conversation of **Conversations**:

- hover a message from the lead and click the smiley to react with one of six
  emojis. One reaction per message: a new one replaces the previous one.
  Reactions are sent only while you have the conversation by hand;
- hover a message sent from your side and click the bin, then
  **Delete for everyone**. The message is withdrawn on WhatsApp for both sides
  and removed from the conversation. WhatsApp can refuse when the message is
  too old: it then stays visible.

The bin does not show on messages that can no longer be withdrawn.

## Copy or download a conversation

Open the conversation in **Conversations**, click **Details**, then:

- **Copy the conversation** puts the whole exchange in your clipboard;
- **Download the conversation** saves it as a text file (.txt) named after the
  lead.

The export lists every message in order, with its time and who spoke: the
lead's name, or the agent's name for what was sent from your side. When the
agent runs an A/B test, the variant is written next to its messages. It
contains text only: pictures and files are not included.

To export the list of your leads to Excel or CSV, use **Export** on the
[Leads](/dashboard/leads/) page.

## Why there is no message box

In **Conversations**, when the agent is in charge of a conversation, the
message box is replaced by one line, for example "Léa is answering for you",
and a **Take over** button. Two voices never answer the same lead at once.

Click **Take over** to get the message box. The agent stays quiet in this
conversation until you hand it back.

If the button opens a message about a missing permission, ask an admin of
your team for the **Reply by hand** permission. See
[Team & roles](/dashboard/team/).

## WhatsApp number disconnected: nobody can reply

In **Conversations**, when the agent's WhatsApp number is no longer linked,
the message box is replaced by the notice **WhatsApp number disconnected**.
Neither you nor the AI can answer this lead until the number is back. The
notice says since when, and the top of the conversation shows "number
disconnected" next to the agent's name.

Click **Reconnect** to open **WhatsApp numbers** and link the number again.
This needs the **Reconnect a number (QR code)** permission.

While the number is down, the page checks it every 30 seconds. The message
box comes back by itself once the number is connected. See
[Connect WhatsApp](/getting-started/connect-whatsapp/).

## Private messages from people in your groups

A number that follows your WhatsApp groups also receives private messages.
Those conversations are in **Conversations** with the others. No agent answers
on that number, so:

- the message box is open at once, with the line **You answer here.**;
- there is no stage and no **Take over** button;
- the top of the conversation names the followed group the person is a member
  of. Click the name to open the group;
- **Details** lists the person's groups under **Groups**, and keeps the next
  action and the owner.

In the **Agent** filter, such a number reads **Groups number**. These people
are not listed on the Leads page. Seeing the groups needs the
**See the groups** permission. See [WhatsApp groups](/dashboard/groups/).

## Stop the AI answering a number

Open the conversation in **Conversations**, click **Details**, then
**Stop the AI answering this number**. From then on the agent ignores this
number. Messages still arrive in the conversation and you can still write by
hand. The contact is not blocked on WhatsApp.

The top of the conversation then shows **Ignored**. Click
**Let the AI answer again** in **Details** to lift it.

This needs the **Edit leads** permission. When a whole dial code is ignored
for your team, the action is replaced by a sentence that says so. The full
list is on [Blocked numbers](/dashboard/blocked-numbers/).

## Delete a lead from Conversations

Open the conversation in **Conversations**, click **Details**, then
**Delete this lead…**. The lead, its conversation, its notes and its history
go to the trash, and the next conversation of the list opens.

- You can restore everything for 30 days, from **Trash** on the Leads page.
- The chat stays on WhatsApp. If the person writes again, they start over as
  a new contact.
- A box lets you stop the AI answering this number at the same time.

The action shows only with the **Delete leads** permission. See
[Leads & CRM](/dashboard/leads/).

## Move faster with the keyboard

In **Conversations**:

| Key | Action |
|---|---|
| J and K | Next and previous conversation. |
| `/` | Jump to the search field. |
| F | Open **Filter**. |
| Enter | Send the message you wrote. |
| Shift+Enter | Add a line break in your message. |

With the list selected, the up and down arrows also move from one
conversation to the next. The shortcuts are inactive while you type in a
field or while a menu is open.

## Share a conversation or a view

The address of the **Conversations** page carries the view, the filters, the
sort and the open conversation. Copy it from your browser to send a teammate
to the same place. They see it within what their role lets them see. The
address also survives a reload: you land on the same conversation.

When you leave the page and come back during the same session, you find the
view, the filters and the sort you left. A search is not kept.

## Related

- [Take over a conversation](/dashboard/human-takeover/)
- [Leads & CRM](/dashboard/leads/)
- [Blocked numbers](/dashboard/blocked-numbers/)
- [Team & roles](/dashboard/team/)
