Before you start
Before you start, sign in to the dashboard and select the organization you want to work in.- Your role must be Admin, Member, or Auditor. Viewer and Billing do not see the Export data button. See Roles and permissions.
- Know which environment you want. Live conversations and test conversations export separately.
Open the Export data dialog
1
Open the agent's Activity page
From the agent builder, open Activity. The header ends with the Export data button. See Watch conversations for the rest of the header.
2
Pick Live or Test in the source picker
The export follows the environment of the selected source. Choosing Live exports live conversations, while Test · Published flow and every Draft entry export test conversations.
3
Select Export data
The dialog title reads Export data followed by the agent name. The subtitle repeats the environment and your timezone.
Choose the format, date range, and filter
The dialog has its own date range. It starts at the current month, not at the range on the Activity page.1
Toggle CSV or JSON
The format toggle sits at the top right of the dialog. CSV is selected by default.
2
Set the date range
Use the date range control under the title. Only conversations started inside the range are exported.
3
Pick a completion filter
The filter select offers All conversations, Completed, and Incomplete.
4
Read the match counter
The right side of the same row reads, for example, 1,240 conversations match. This count is what the export contains.
Select columns
The Columns list on the left groups fields by namespace. Every column is selected when the dialog opens.- The meta group holds conversation fields such as Conversation ID, Visitor ID, Started on, Status, Channel, Duration (minutes), Escalated, and CSAT.
- The transcript group holds Transcript, the whole conversation in one column.
- The response group holds one column per gambit that stores a variable, labeled with the gambit name.
- The agent, api, and post groups hold AI agent replies, API call results, and post-API results per gambit.
- The enduser, utm, system, flow, url, and trigger groups hold end user, campaign, and page data.
- The system.ip column holds the end user’s IP address, truncated to its network prefix (for example
203.0.113.0). Deselect it like any other column if you don’t want it in the file.
1
Expand a group and tick columns
Select the group name to expand it. The counter next to the name reads, for example, meta · 5/10. The group checkbox selects or clears the whole group.
2
Toggle the whole list or search it
One button toggles the whole list. It reads Select all, or Clear all once every column is ticked.Type in Search columns… to filter by column name or gambit name. When nothing matches, the list reads No columns match.
3
Check the sample preview
The right pane, Sample preview · latest 5 conversations, first 50 messages each, renders your selection in the chosen format. It reads Select at least one column until you tick one column.
Transcript column
The Transcript column holds the whole conversation inside the same row. It lists every message and system event, such as Alex joined or Resolved by Alex, in the order they happened. Internal notes and deleted messages are left out.- In CSV, each turn is one line inside the cell: the time in your timezone, the speaker, and the message. For example,
[2026-09-25 15:04:05] Agent: Your order ships on Friday.Line breaks inside a message become spaces, so every line is exactly one turn. - In JSON, the transcript is a list of turns. Each turn has
timestamp(in your timezone, with its UTC offset),speaker,text, andattachmentswhen the message carried files. - Speakers are User for the end user, Agent for automated replies, Agent (name) for a human agent, and System for system events.
- A CSV transcript longer than a spreadsheet cell allows ends with a line such as … [truncated: 12 more turns]. JSON transcripts are never truncated.
Generate the export
1
Select Generate export
The button repeats the count and format, for example Generate export (1,240 · CSV). It reads Starting… while the export starts.
2
Read the confirmation
The dialog closes. A toast confirms that the export started and that a download follows when it is ready.
Download from the Tasks panel
The export runs in the background, so you can keep working. Progress shows in the tasks tracker at the bottom of the main sidebar, next to your profile menu. A spinner and a running count appear while an export is active.- Open the tracker to see the Tasks panel. A running export shows a progress bar and a count such as 640/1,240, then Finishing….
- When the export finishes, a toast reads Conversation export ready. If the dashboard tab is visible at that moment, the file downloads on its own.
- The finished row keeps a Download button, so you can save the file again later. The file is named Conversation export.csv or Conversation export.json.
- A failed export shows its reason in red under the title. Select Dismiss on one row, or Clear to remove every finished task.
A large export downloads in parts, and a Preparing download… toast shows while the browser joins them. If the download fails, a toast reads Download failed. Select Download again. If the file is no longer available, the toast reads Download unavailable instead.
