# Analytics & Chat History

View conversations, track usage metrics, and download chat data for analysis.


View all conversations with your AI chatbot, track usage metrics, and export data for analysis.

## Accessing Chat History

Go to **Chats** in your app's navigation. The page has two tabs:

- **Chatlogs**: Browse and view conversations
- **Actions**: Download data and connect outputs

## Chat List

The left side shows all chat sessions with filters:

### Filters

| Filter | Options |
|--------|---------|
| **Search** | Search message content |
| **Status** | All or Unread only |
| **Source** | Web, API, Slack, WhatsApp, Email, etc. |
| **Tag** | Filter by conversation tags |
| **Phone Number** | Filter by phone (for voice/SMS) |

### Chat Session Info

Each chat session shows:
- User name/email (if collected) or anonymous
- Source channel badge
- Preview of messages
- Timestamp
- Unread indicator

## Viewing Conversations

Click a chat session to view the full conversation:

### Transcript Tab

- Full message history
- User and AI responses
- Timestamps for each message
- Attachments and images shared

### Memory Extracted Tab

- Facts extracted from this conversation
- Used for [User Memory](/docs/guides/user-memory) feature

## Usage Metrics

In the **Actions** tab, you'll see key metrics:

| Metric | Description |
|--------|-------------|
| **Total Sessions** | All chat sessions |
| **Unread** | Sessions you haven't viewed |
| **Today** | Sessions from today |
| **Avg Messages** | Average messages per session |
| **Unique Users** | Distinct users who chatted |

## Downloading Chat Data

### Download as CSV

1. Go to **Chats** > **Actions** tab
2. Click **Download Chatlogs**
3. A CSV file downloads with all conversations

The CSV includes:
- Session ID
- User info (if available)
- Source channel
- Timestamps
- All messages with roles

### Google Sheets Integration

Automatically sync new conversations to Google Sheets:

1. Go to **Chats** > **Actions** tab
2. Click the **Output** card
3. Connect Google Sheets
4. New conversations are added as rows

See [Google Sheets Integration](/docs/integrations/google-sheets) for setup details.

## Managing Conversations

### Mark as Read

Conversations are marked as read when you view them. The unread count in the sidebar updates automatically.

### Filter by Source

Use the Source filter to see conversations from specific channels:
- **Web**: Browser widget or iframe
- **API**: API integrations
- **Slack**: Slack bot messages
- **WhatsApp**: WhatsApp integration
- **Email**: Email conversations
- **Voice**: Phone call transcripts

## Improving Your Bot

Use chat history insights to improve your AI:

1. **Find common questions**: Search for patterns in what users ask
2. **Identify confusion**: Look for long back-and-forth conversations
3. **Update knowledge**: Add missing information to your knowledge base
4. **Refine prompts**: Adjust your system prompt based on real conversations

## Troubleshooting

### No Conversations Showing

1. Make sure your app is published and accessible
2. Check that users have actually chatted with your bot
3. Clear all filters to see all conversations

### Can't Find a Specific Chat

1. Use the search box to search message content
2. Filter by source if you know the channel
3. Check the status filter isn't hiding it

### Download Not Working

1. Wait for the download to complete (may take time for large datasets)
2. Check your browser's download folder
3. Try a different browser if issues persist