> ## Documentation Index
> Fetch the complete documentation index at: https://help.ciarem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversations

> Review finished and ongoing chats with duration, message counts and first response, read any transcript, and export the full history of many conversations at once.

**Conversations** is where admins review chats rather than answer them. The [Inbox](https://help.ciarem.ai/using-ciarem/inbox.md) is for replying: one row per contact, the newest conversation on top. Conversations lists every conversation as its own row, with the numbers you need to judge how it went, and lets you export the full history of many of them at once. It sits under **Metrics** in the sidebar, beside **Overview**, and only admins and [Viewers](https://help.ciarem.ai/using-ciarem/roles-and-permissions.md#viewer) see it. Viewers can read and export chats here, but change nothing.

## What the table shows

Each row is one conversation, from every channel:

* **Contact**: the contact's name, with their phone number, email or handle under it. **No contact** means the conversation is not linked to a contact; the handle still shows.
* **Channel**: the channel, and which line when you have several (say, two WhatsApp numbers).
* **Started**: when the conversation opened.
* **Finished**: when it was resolved. Empty while it is still open.
* **Duration**: from the conversation's start to its last message (for example 14 min, 2 h 05, 3.5 d).
* **Messages (in / out)**: messages the contact sent, then messages sent to them by the AI or your team.
* **Handler**: who has the conversation now: **AI**, the assigned team member with their photo, **Team** when nobody is assigned, or **WhatsApp Business app** when someone answers from the app.
* **Journey**: how it got there. **AI → Ana** means the AI answered first and then handed the conversation to Ana; **(+2)** counts further hand-overs and transfers. Click it to see the whole journey as a timeline: who held the conversation, in order, when each one took it and for how long. A team transfer shows the team and, under it, the person who picked it up.
* **First response**: the time between the contact's first message and the first reply after it. Empty when nobody answered.
* **Status**: **Open** or **Resolved**.
* **Survey**: the satisfaction survey score, when the contact answered one (for example CSAT 4 or NPS 9).
* **Last message**: the latest message as the Inbox shows it: delivery ticks for a message you sent, and an icon and label for a photo, voice note or file.

On a phone or a tablet in portrait, the rows become cards with the same information.

## Filters

Search sits on the left. **Filters** opens the full panel; a red dot on it means something narrows the list, and **Clear filters** next to it puts everything back, sort order included. The panel holds:

* **Sort by**: last message, start, duration or survey score, in either direction. Conversations without a duration or without an answered survey always come last.
* **Status** (open or resolved) and **Handled by** (AI, team or WhatsApp Business app).
* **Duration**: a range such as under 5 min, 5 to 30 min, 30 min to 2 h, 2 h to 1 day, or over 1 day, 3 days or 1 week.
* **Survey**: answered or not. For answered ones, pick the kind (CSAT, NPS or both) and a score range, for example NPS from 0 to 6 to read the unhappy chats.
* **Transfers**: at least a number of hand-overs and transfers, to find chats that bounced between people.
* The Inbox's own filters: channel, window state, assigned person or unassigned, tags, funnel stage, start date, last response and reply status.

The list starts with the conversations that **started in the last 30 days**. Change the start date in the filters to look further back.

## Saved views and columns

Save a set of filters as a **view**, as in Contacts: click **+** above the search box, name it (say, "Long resolved chats") and it becomes a tab. While a view is open, every change to its filters, search or sort is saved to it for every admin. **Overview** is the unsaved default and keeps your changes only until you leave. Each tab's menu can rename, duplicate, delete or **Export view**, which exports the chat history of every conversation in that view.

**Customize columns** (the button at the right of the toolbar) hides, shows and reorders the columns. The layout is yours: other admins keep their own.

## Reading a transcript

Click a row to read the conversation in a side panel: every message with its sender and time, voice notes and files you can play or open, and markers such as when the AI handed over. The panel is read-only. Use the arrows at the top to move to the previous or next conversation, and **Open in inbox** to answer, assign or tag it.

## Exporting chat history

**1. Select the conversations**

Tick the rows you want, or tick the box in the table header (**Select all** on a phone) to take every conversation that matches the filters. Untick any you want to leave out.

**2. Click Export history**

The button is in the bar at the bottom of the page.

**3. Pick a format and click Generate**

* **CSV**: one row per message, with the date, channel, contact, who sent it and the text. On WhatsApp it also shows when each message you sent was delivered and read. It opens in Excel or Google Sheets.
* **Transcripts**: one text file per conversation that reads like the chat itself, all in one ZIP.

In both, voice notes, images and files appear as a link with the file name.

What the files include:

* Every message exchanged with the contact. Transcripts also show events such as hand-overs and resolutions; the CSV holds messages only. **Internal notes are never included.**
* Labels and events are written in the language you use Ciarem in.
* Up to **20,000 conversations** per export. Above that, narrow the date range or the filters and export again.
* Files of up to **100,000 messages**. A bigger export arrives as several numbered files (Part 1 of 3, Part 2 of 3, and so on), so nothing is cut off.

## Downloading

The **Exports** panel (top right of the page) opens as soon as an export starts. Each file shows **Queued**, then **Generating**, and a **Download** button once it is ready. The same files are also listed in **Metrics**, on the **Exports** tab.

Files can be downloaded for **one day**; after that they leave the list. To get the same history again, filter and export again. If a file could not be generated, it says so and offers **Generate again** to admins.

> [!NOTE]
>
> To give a customer a copy of everything you hold about them, including the photos, voice notes and files themselves, use the contact's own export (**Export all data**). See [Contacts and funnel stages](https://help.ciarem.ai/using-ciarem/contacts-and-stages.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.