> ## 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.

# Message Search

> Find and analyze specific messages across all conversations

Message Search lets you search the content of individual messages across all conversations. Use it to discover knowledge gaps, validate AI responses, and identify patterns in how users phrase their questions.

Open the [message search](https://platform.botbrains.io/~/messages/search) to get started.

## Search Syntax

The search bar supports full-text search with operators.

<img src="https://mintcdn.com/botbrains/mrGgmLFCJjw3qsuy/images/message-search/search-interface-with-filters.png?fit=max&auto=format&n=mrGgmLFCJjw3qsuy&q=85&s=5743dd8f12d0d57302677c826260b45d" alt="Message search interface showing the search bar with filters applied as removable chips below" data-generation-prompt="Navigate to https://platform.botbrains.io/~/messages/search. Apply multiple filters (e.g., Channel = 'Website', Rating = '1-5 stars', Sentiment = 'negative'). Show the search bar with at least 2-3 filter chips visible below it. Use a 1920x1080 viewport and collapse the sidebar for a full-page shot. Focus on capturing the search bar and filter chip area." width="1920" height="1080" data-path="images/message-search/search-interface-with-filters.png" />

| Syntax                        | Example                   | Effect                                    |
| ----------------------------- | ------------------------- | ----------------------------------------- |
| Single word                   | `refund`                  | Messages containing "refund"              |
| Multiple words (implicit AND) | `refund policy`           | Messages containing both words            |
| OR                            | `refund or cancellation`  | Messages containing either word           |
| NOT (minus)                   | `refund -approved`        | Messages with "refund" but not "approved" |
| Exact phrase (quotes)         | `"annual subscription"`   | Messages with the exact phrase            |
| Combined                      | `"password reset" -email` | Exact phrase excluding a term             |

## Filters

Beyond text search, narrow results with these filters:

| Filter        | Options                                       | Use case                                                |
| ------------- | --------------------------------------------- | ------------------------------------------------------- |
| Date range    | Last 7/30/90 days, custom                     | Focus on a specific time window                         |
| Channel       | Website, Zendesk, Salesforce, Slack, WhatsApp | Compare AI performance across channels                  |
| Rating        | 1–5 stars, abandoned, unoffered               | Find messages from poorly or highly rated conversations |
| Completeness  | Complete, partial, no answer                  | Identify knowledge gaps (filter to "no answer")         |
| Sentiment     | Positive, neutral, negative                   | Find frustration points or successful patterns          |
| Language      | English, German, Spanish, etc.                | Analyze multilingual performance                        |
| File types    | Image, PDF, document, video, audio            | Find messages with attachments                          |
| Visited pages | URL or path                                   | See what users ask on specific pages (web channel)      |
| Handoff       | Offered, accepted, requested, none            | Understand escalation patterns                          |
| Labels        | Has / doesn't have specific labels            | Segment by your custom categories                       |

All active filters appear as removable chips below the search bar. Click any chip to remove it, or "Clear All" to reset.

## Working with Results

Results display as message cards showing the message content, sender, timestamp, sentiment, and a link to the full conversation. Results load progressively as you scroll.

<img src="https://mintcdn.com/botbrains/mrGgmLFCJjw3qsuy/images/message-search/search-results-with-bulk-actions.png?fit=max&auto=format&n=mrGgmLFCJjw3qsuy&q=85&s=64c0840fe9a774e2b392de9c25706918" alt="Search results page showing multiple message cards with checkboxes and an Export button visible" data-generation-prompt="Navigate to https://platform.botbrains.io/~/messages/search and perform a search (e.g., search for 'refund' or another common term). Select 2-3 messages using the checkboxes on the left side of the cards. Show the results list with at least 3 message cards visible, highlighting the checkboxes, message content, sender/timestamp, and the Export button in the top toolbar. Use a 1920x1080 viewport and collapse the sidebar." width="1920" height="1080" data-path="images/message-search/search-results-with-bulk-actions.png" />

Select multiple messages via checkboxes to apply labels in bulk or export the selection.

## Exporting

Click **Export** to download results as CSV (for spreadsheets) or JSON (for programmatic analysis). Exports respect all active filters, so you only get the messages that match your current search.

## Next Steps

* [Conversations](/concepts/conversations) - View complete conversation threads
* [Topics](/concepts/topics) - Understand automatic topic detection
* [Improve Answers](/guides/improve-answers) - Use search findings to refine knowledge and guidance
* [Labels](/concepts/labels) - Label conversations you find for follow-up tracking