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

# Chat Analytics

> View headline chat metrics, volume trends, and outcome distribution for your chat channel

The *Chat Analytics* page gives you a concise, data-rich view of how your AI agent is handling chat conversations. It combines five headline KPI cards with interactive charts so you can monitor chat performance, resolution trends, and escalation patterns at a glance.

## Headline Metrics

<Columns cols={2}>
  <Card title="Total Chats" icon="comments">
    Total number of chat conversations handled by the workspace in the selected period.
  </Card>

  <Card title="Unique Users" icon="users">
    Count of distinct users who initiated a chat conversation with your agent.
  </Card>

  <Card title="Avg Turns" icon="arrow-right-arrow-left">
    Average number of message exchanges per conversation, giving a sense of chat depth and complexity.
  </Card>

  <Card title="Resolution Rate" icon="circle-check">
    Percentage of conversations resolved entirely by the AI without requiring a human escalation.
  </Card>

  <Card title="User Satisfaction" icon="face-smile">
    Aggregate satisfaction score derived from user sentiment signals across conversations.
  </Card>
</Columns>

Each metric displays the value for the selected time window alongside a **% change** compared with the equivalent prior period, so you can quickly identify positive or negative trends.

***

## Charts

### Chat Volume by Day

<ResponseField name="Chat volume by day" type="chart">
  A stacked bar chart plotting the number of chat conversations for every calendar day in the selected period. Each bar is segmented by outcome type (Contained, Transferred, User-Abandoned, Error), making it easy to see both total volume and the composition of outcomes on any given day. Hover over a segment to inspect its exact count.
</ResponseField>

### Chat Outcomes

<ResponseField name="Chat outcomes" type="chart">
  A pie chart that breaks down the final disposition of each conversation:

  * **Contained** – the issue was resolved entirely by the AI agent
  * **Transferred** – the conversation was escalated to a human agent
  * **User-Abandoned** – the user left the conversation before it concluded
  * **Error** – the conversation ended due to a system or processing error

  Each segment is labelled with its percentage share and absolute count.
</ResponseField>

### Transfer Dispositions

<ResponseField name="Transfer dispositions" type="chart">
  A secondary pie chart that breaks down transferred conversations by the **disposition** (Freshchat channel) the AI selected when escalating. This helps you understand which channels are receiving the most escalations and whether your disposition descriptions are routing correctly.
</ResponseField>

***

## Containment Management

The **Transfer Dispositions** chart is paired with a containment management panel that lets you reclassify disposition outcomes:

* **Mark as Contained** — if a transfer to a particular channel is considered a successful self-service outcome in your workflow, you can mark that disposition as "contained" so it is counted toward your Resolution Rate rather than against it.
* **Mark as Transferred** — revert a disposition back to its default "transferred" classification.

Changes apply immediately to the analytics view and persist across sessions.

***

## Real-Time Updates

The Chat Analytics dashboard updates **live** as new conversations complete. A green pulse indicator in the top-right of the page confirms that live updates are active.

* **Pause** — click the pause button to freeze the view. This is useful when reviewing a specific snapshot without the numbers shifting.
* **Resume** — click resume to reload with the latest data and re-enable live updates.

***

## Time Range Filtering

Use the date range selector to focus on a specific window:

| Preset           | Description                                                 |
| ---------------- | ----------------------------------------------------------- |
| **Today**        | All conversations since midnight in your workspace timezone |
| **Last 7 Days**  | Rolling seven-day window                                    |
| **Last 30 Days** | Default view — rolling thirty-day window                    |
| **Custom Range** | Pick any start and end date for ad-hoc analysis             |

All charts and headline metrics update together when the range changes.

***

## Where to go next

<Columns cols={2}>
  <Card title="Call Analytics" icon="chart-line" href="/analyze/call-analytics">
    View the equivalent analytics dashboard for your voice channel.
  </Card>

  <Card title="Chat Escalation" icon="comments" href="/build/ai-agents/chat-escalation">
    Configure how and when your AI agent escalates to Freshchat.
  </Card>
</Columns>