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

# Analytics

## Chats

**Analytics** aggregates the activity of your AI agent across conversations. It has four pages: **Chats**, **Topics**, **Sentiment**, and **Helpdesk**.

By default, it shows the activity for all AI Agents under your workspace for the last week.

<Frame>
  <img src="https://mintcdn.com/chatbase/fuaTVXjARv0sH-Me/user-guides/chatbot/images/analytics/analytics-1.jpg?fit=max&auto=format&n=fuaTVXjARv0sH-Me&q=85&s=2880b0ef0f1bf029e7e513a1cedb5803" alt="Chatbase Embed Code Example" width="1904" height="790" data-path="user-guides/chatbot/images/analytics/analytics-1.jpg" />
</Frame>

It shows the total number of chats, total number of messages, the messages that had thumbs up from the users and the messages that had thumbs down, daily active users, weekly active users and stickiness.

Below the totals, a line chart plots chats over the selected period against the **Previous period** (the dotted line), so you can see whether volume is rising or falling. Hover any point to compare the two dates directly.

**Chats by country** shades a world map by volume and lists the top countries beside it, with **View all** for the full ranking. Countries are detected from the IP of the users having conversations with the AI agent.

<Frame>
  <img src="https://mintcdn.com/chatbase/fuaTVXjARv0sH-Me/user-guides/chatbot/images/analytics/analytics-2.png?fit=max&auto=format&n=fuaTVXjARv0sH-Me&q=85&s=0fa0c11d73a5f9d9d2279db93d091051" alt="Chatbase Embed Code Example" width="1600" height="751" data-path="user-guides/chatbot/images/analytics/analytics-2.png" />
</Frame>

**Chats by channel** breaks the same total down by where the conversations came from, such as Widget/Iframe, Playground, or Slack.

**Action calls** ranks how often each of your actions ran over the period, with **View all** for the complete list. It is a quick way to see which actions your agent actually uses.

You can always filter the data by date. There are pre-defined date filters such as last 7 days, last 30 days, last 3 months and last year.

<Frame>
  <img src="https://mintcdn.com/chatbase/fuaTVXjARv0sH-Me/user-guides/chatbot/images/analytics/analytics-filter.png?fit=max&auto=format&n=fuaTVXjARv0sH-Me&q=85&s=1866daa970a795ede1aad7afb5e79ffd" alt="Chatbase Embed Code Example" width="1600" height="875" data-path="user-guides/chatbot/images/analytics/analytics-filter.png" />
</Frame>

## Topics

This section shows the topics that were included in the conversations and mentioned by the users.

<Frame>
  <img src="https://mintcdn.com/chatbase/fuaTVXjARv0sH-Me/user-guides/chatbot/images/analytics/analytics-topics-new.png?fit=max&auto=format&n=fuaTVXjARv0sH-Me&q=85&s=df0f779328cd5d57992d25ec34c9e405" alt="Chatbase Embed Code Example" width="2144" height="1182" data-path="user-guides/chatbot/images/analytics/analytics-topics-new.png" />
</Frame>

Topics Actions:

* Search topics
* Add topic
* Edit topic
* Delete topic
* Freeze topics: Stopping the AI Agent to detect any topics automatically.

The topics are detected automatically by the AI Agent. However, you can add topics manually in the View All button in the the right of the page:

<Frame>
  <img src="https://mintcdn.com/chatbase/fuaTVXjARv0sH-Me/user-guides/chatbot/images/analytics/analytics-4.png?fit=max&auto=format&n=fuaTVXjARv0sH-Me&q=85&s=e3905a7e8ba9137ab7e5410a29316b86" alt="Chatbase Embed Code Example" width="995" height="1165" data-path="user-guides/chatbot/images/analytics/analytics-4.png" />
</Frame>

## Sentiment

This section shows how the AI Agent detects the sentiment and emotion of the users during the conversations. The sentiment analysis is detected automatically by the AI Agent.

<Frame>
  <img src="https://mintcdn.com/chatbase/fuaTVXjARv0sH-Me/user-guides/chatbot/images/analytics/analytics-sentiment-new.png?fit=max&auto=format&n=fuaTVXjARv0sH-Me&q=85&s=87aaf41891f13886c7c884f31cc0da09" alt="Chatbase Embed Code Example" width="2130" height="1076" data-path="user-guides/chatbot/images/analytics/analytics-sentiment-new.png" />
</Frame>

## Helpdesk

Track ticket volume over time to monitor your support workload and resolution trends. Every metric on this page shows its change against the previous period, and each chart plots the **Selected period** as a solid line against the **Previous period** as a dotted one.

### Ticket volume

* **Created tickets** — tickets opened during the period.
* **Solved tickets** — tickets marked solved during the period.
* **Unsolved tickets** — the outstanding backlog, plotted on its own chart so you can see whether it is growing or shrinking.

### Response times

* **Median first response time** — how long a customer waits for the first human reply.
* **Median response time** — the median across all replies, not just the first.
* **Median time to close** — how long a ticket stays open before it is solved.

Medians are used rather than averages so a handful of long-running tickets don't skew the figure. A chart below the three tiles plots response time across the period.

### Tickets by channel

Breaks ticket volume down by where the tickets arrived from, such as **Email**, **Widget/Iframe**, or **API**.

### Filtering

Use the date range picker to set the period. The filter button beside it narrows the whole page by **Assignee**, **Channel**, **Type**, or **Last message by** — pick a field, choose an operator such as **is any of**, then select the values and click **Apply**. **Discard** clears the filter you were editing.

## Notes

Analytics data is updated with a 1-day delay, reflecting the previous day's information.

Data is recorded once the user subscribes to a specific plan. Topics and sentiment data will only be available after the upgrade; any data from before the upgrade will not be included.

**Activity** shows data per chat for users, while **Analytics** aggregates the information, including topics, sentiment, and thumbs down.

Each panel uses the visualization that suits it: a line chart for chats over time, a shaded world map for **Chats by country**, and horizontal bars for **Chats by channel** and **Action calls**.

The analytics page displays the total number of messages, including all conversation messages. However, credits are only calculated for AI-generated responses, excluding the initial messages.
