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

# Conversations

> Browse, filter, and analyze customer conversations to improve AI performance

Your [conversation history](https://platform.botbrains.io/~/conversations) is the most valuable source of insights for improving your AI. Browse, filter, and analyze conversations to identify knowledge gaps, track satisfaction, and validate improvements.

Every conversation has a [status](https://docs.botbrains.io/concepts/chat-performance.md#conversation-status) (resolved, unresolved, escalated) and an [AI involvement level](https://docs.botbrains.io/concepts/ticketing-performance.md#why-involvement-rate-not-resolution-rate) (autonomous, public, private, not involved). You can manually change a conversation's status by clicking the status tag on the conversation detail page.

## Filters

Use filters on the [conversations page](https://platform.botbrains.io/~/conversations) to drill down to specific segments.

| Filter | Description |
| - | - |
| **Date range** | Focus on a specific time range (last 7 days, 30 days, 90 days, or custom) |
| **Involvement** | Segment by AI participation level |
| **Labels** | Include or exclude conversations by label-see [Labels](https://docs.botbrains.io/concepts/labels.md) for details |

![Conversations page with the Channel filter open from the Filter menu, next to the involvement, labels and date range controls](https://mintcdn.com/botbrains/l5xn3aEFMtkQ541l/images/conversations/filters-panel.png?fit=max\&auto=format\&n=l5xn3aEFMtkQ541l\&q=85\&s=372f7e19110d32343f0e8f280c8d6a80)

Click **Filter** to add more filters:

| Filter | Description |
| - | - |
| **Channel** | Filter by channel (Browser, App, Slack, WhatsApp, Zendesk, Salesforce) |
| **Topic** | Filter by automatically detected conversation topics |
| **Status** | Filter by resolution outcome (Resolved, Unresolved, Escalated) |
| **Rating** | Filter by customer satisfaction score (1–5 stars, Abandoned, Unoffered) |
| **Conversation attributes** | Filter by an attribute's value or a scorecard's score, see [Filter by Attributes](https://docs.botbrains.io/concepts/conversation-attributes.md#filter-by-attributes) |
| **Monitor** | Show the conversations a [monitor](https://docs.botbrains.io/concepts/monitors.md#reviewing-results) flagged, didn't flag, or evaluated |
| **Procedure** | Show conversations that ran a [procedure](https://docs.botbrains.io/concepts/procedures.md), optionally by procedure status |
| **Incident** | Show the conversations linked to an [incident](https://docs.botbrains.io/concepts/incidents.md) |

> [!TIP]
>
> Filter to ratings 1–2 and status Unresolved to find the most problematic conversations requiring immediate attention.

## Conversation Details

Click any conversation to open the detail view. The header shows message count, topic, status, rating, channel, and timestamps. The timeline displays user messages, AI responses (with source attribution), and operator messages in chronological order.

![Conversation detail view showing message timeline, conversation header with status and rating, and user information sidebar](https://mintcdn.com/botbrains/l5xn3aEFMtkQ541l/images/conversations/detail-view.png?fit=max\&auto=format\&n=l5xn3aEFMtkQ541l\&q=85\&s=15164893937dd9d57417abe415857028)

### Customer Feedback

If the customer rated the conversation, a feedback card appears at the top of the timeline showing the star rating (1–5), the label (Terrible to Amazing), and any text feedback.

### User Information Sidebar

The right sidebar shows the user's profile (ID, email, device info, location), channel details, and applied labels. Click the user to view their full conversation history.

### Hiding a Conversation

Open the conversation, select the three-dot menu in the top-right corner, then choose **Hide Conversation**. A hidden conversation disappears from your metrics and conversation list views, which makes this the quickest way to clean up test conversations you created while configuring your AI. To hide many at once, use [Batch Operations](#batch-operations).

## Improving Answers

Click any AI message to open the knowledge sidebar, which shows which sources the AI referenced and any available but unused sources. From there you can add missing information as a snippet, navigate to source documents to correct errors, or adjust guidance for tone and style.

![Improve Answer sidebar next to the selected AI message, showing the customer question, Edit Guidance and Add Snippet buttons, and Used Sources with a cited excerpt](https://mintcdn.com/botbrains/l5xn3aEFMtkQ541l/images/conversations/knowledge-sidebar.png?fit=max\&auto=format\&n=l5xn3aEFMtkQ541l\&q=85\&s=c6bfc7b4e10b7bf15fd188321bda1467)

> [!NOTE]
>
> "Used Sources (0)" means the AI answered from general knowledge rather than your data-this signals a knowledge gap. Create a snippet to address it.

## Batch Operations

Select multiple conversations by clicking the selection circle on conversation cards. The batch toolbar lets you apply labels, remove labels, export data, or hide conversations in bulk.

> [!WARNING]
>
> Batch hide is permanent. Hidden conversations cannot be recovered. Use this only for spam or test data.

## Exporting Data

Click **Export** on the [conversations page](https://platform.botbrains.io/~/conversations) to download conversations matching your current filters as CSV or JSON. You can also set up recurring exports in your [data export settings](https://platform.botbrains.io/~/settings/data-export).

## Next Steps

* [Message Search](https://docs.botbrains.io/concepts/message-search.md) - Find specific content across all conversations
* [Topics](https://docs.botbrains.io/concepts/topics.md) - Understand what users are asking about
* [Metrics](https://docs.botbrains.io/concepts/metrics.md) - Monitor aggregate performance indicators
* [Improve Answers](https://docs.botbrains.io/guides/improve-answers.md) - Use conversation insights to refine AI responses
* [Labels](https://docs.botbrains.io/concepts/labels.md) - Organize conversations with custom categorization


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