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

# Analytics

> Monitor guest conversations, see your receptionist in action, and keep track of your credits.

The Analytics page is your window into every guest interaction — text conversations, voice calls, and credit usage. Use it to monitor performance, spot knowledge gaps, and continuously improve your receptionist.

<Info>
  **This is where the self-improving loop happens.** Your receptionist automatically evaluates every conversation, identifies where it couldn't help, and flags those as training opportunities. You review them here, add the missing knowledge to [Training Materials](/admin-panel/documents), and your receptionist gets smarter with every cycle.
</Info>

The page has three tabs: **Chat History**, **Voice History**, and **Usage**.

***

## Chat History

Shows every text conversation your receptionist has had with guests.

### Conversation Table

Each row in the table displays:

| Column         | What It Shows                                                           |
| -------------- | ----------------------------------------------------------------------- |
| **Date/Time**  | When the conversation started                                           |
| **Session ID** | Unique identifier for the conversation                                  |
| **Messages**   | Total number of messages exchanged                                      |
| **Feedback**   | Guest thumbs up/down reactions (if any)                                 |
| **Status**     | Quality evaluation result — see [Quality Status](#quality-status) below |

Click any row to open the **Conversation Details** panel on the right side.

### Filters

Use the toolbar at the top to narrow down conversations:

| Filter         | Options                                                         | What It Does                                                                                                                                                         |
| -------------- | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Date Range** | Start and end date pickers                                      | Show conversations within a specific period. Defaults to the last 30 days.                                                                                           |
| **Feedback**   | All, With Feedback, Positive, Negative                          | Filter by guest reactions. "With Feedback" shows any conversation where a guest gave a thumbs up or down.                                                            |
| **Quality**    | All, Successful, Needs Training, Other Issues, Partial, Pending | Filter by how well your receptionist performed. **"Needs Training"** is the most actionable — these are conversations where adding knowledge will make a difference. |
| **Search**     | Free text                                                       | Search through conversation content                                                                                                                                  |

<Tip>
  **Start with "Needs Training" filter.** These conversations show exactly where your receptionist couldn't help because it was missing information. Fix these first for the biggest impact.
</Tip>

### Export

Click **"Export JSON"** to download all visible conversations as a JSON file. Useful for external analysis or record-keeping.

### Conversation Details

Click any conversation row to open a slide-in panel with two tabs:

**Overview tab:**

* **Session metadata** — Session ID, start time, end time, message count
* **Guest Feedback** — Every thumbs up/down the guest gave, including any written comments with timestamps
* **Quality Criteria** — Each evaluation criterion shows a pass/fail result with a rationale explaining why. See [Quality Status](#quality-status) for details.
* **Training Opportunity** — If the conversation failed, this box shows the specific topics your receptionist couldn't answer. These appear as tags (e.g., "spa hours", "parking policy") so you know exactly what to add to [Training Materials](/admin-panel/documents).
* **Mark as Trained** — After you've added the missing information, click this button to mark the conversation as resolved. See [Training Workflow](#training-workflow) below.

**Transcript tab:**

* The complete conversation between the guest and your receptionist, displayed as a chat timeline with timestamps for each message.

***

## Voice History

Shows every voice conversation — whether the guest called through the website widget, a lobby kiosk, or a phone line.

### Call Table

| Column        | What It Shows                                   |
| ------------- | ----------------------------------------------- |
| **Date/Time** | When the call started                           |
| **Duration**  | Call length (minutes:seconds)                   |
| **Messages**  | Number of conversation turns                    |
| **Status**    | Evaluation result — Success, Failed, or Unknown |
| **Details**   | Eye icon — click to open the call details panel |

### Filters

| Filter         | Options                       | What It Does                    |
| -------------- | ----------------------------- | ------------------------------- |
| **Date Range** | Start and end date pickers    | Defaults to the last 30 days    |
| **Status**     | All, Success, Failed, Unknown | Filter by call outcome          |
| **Search**     | Free text                     | Search through call transcripts |

### Export

Click **"Export JSON"** to download all visible voice conversations.

### Call Details

Click the eye icon on any row to open the details panel:

* **Audio Player** — Listen to the recorded call directly in the panel (when recording is available)
* **Overview tab** — Call metadata (date, duration, messages, status) plus evaluation criteria results with pass/fail for each criterion
* **Transcription tab** — Full text transcript of the voice conversation, showing what the guest said and how your receptionist responded

<Info>
  Voice evaluation criteria are configured on the [Voice Settings](/admin-panel/voice-agent#guest-satisfaction-criteria) page. If you haven't set up criteria yet, conversations will show as "Unknown" status.
</Info>

***

## Usage

Track your credit consumption and manage your plan.

### Plan Header

At the top you'll see:

* **Plan badge** — Your current plan name (e.g., RECEPTIONIST)
* **Next renewal date** — When your credits reset
* **Current billing cycle** — The date range for your current period
* **Upgrade Plan** — Button to view available plan upgrades

### Voice Credits

A progress bar showing your monthly voice minute consumption:

* **Monthly Allowance** — Used minutes vs. total allocation (e.g., "628 / 100.0K")
* **Percentage indicator** — Color-coded: green (normal), orange (approaching limit), red (near limit)
* **Sync button** — Refresh the usage data to get the latest numbers
* **Buy More** — Purchase additional voice credits if you're running low

### Chat Credits

Same layout as Voice Credits:

* **Monthly Allowance** — Used credits vs. total allocation
* **Percentage indicator** — Same color-coded system
* **Buy More** — Purchase additional chat credits

<Info>
  If you've purchased add-on credits (via "Buy More"), they appear as a separate purple progress bar below the monthly allowance, with their expiration date shown.
</Info>

### Your Feature Add-ons

Shows any premium features you've activated — WhatsApp integration, Telegram integration, Custom Avatar, and more. If you haven't purchased any add-ons yet, you'll see a **"Browse Features"** button to explore available options.

<Tip>
  For details on purchasing add-ons and managing your subscription, see the [Billing](/admin-panel/billing) page.
</Tip>

***

## Quality Status

After each conversation ends, your receptionist automatically evaluates it against the success criteria you've defined on the [Chat Settings](/admin-panel/conversation-agent) or [Voice Settings](/admin-panel/voice-agent) page. The result appears as a colored badge:

| Badge              | Color             | Meaning                                                              | Action Needed                                                                  |
| ------------------ | ----------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| **Success**        | Green             | All quality criteria were met                                        | None — your receptionist handled it well                                       |
| **Needs Training** | Red               | Your receptionist couldn't answer because it was missing information | **Yes** — add the missing info to [Training Materials](/admin-panel/documents) |
| **Other Issues**   | Gray              | The conversation didn't go well, but it's not a knowledge gap        | Review the conversation to understand what happened                            |
| **Partial**        | Orange            | Some criteria passed, some failed                                    | Review which criteria failed and whether adding knowledge would help           |
| **Pending**        | Yellow (animated) | Still being analyzed — results ready in about 5 minutes              | Wait — the evaluation is processing                                            |
| **Skipped**        | Gray              | Evaluation was skipped (e.g., conversation was too short)            | None                                                                           |
| **Trained**        | Purple            | Previously "Needs Training" but you've marked it as resolved         | None — you've already handled it                                               |

<Warning>
  **No criteria = no evaluation.** If you haven't set up quality criteria on the [Chat Settings](/admin-panel/conversation-agent) or [Voice Settings](/admin-panel/voice-agent) page, conversations won't be evaluated and will show as "Skipped".
</Warning>

***

## Training Workflow

This is the most important workflow in RecepAI — the cycle that makes your receptionist smarter over time:

<Steps>
  <Step title="Spot the gap">
    Your [Dashboard](/admin-panel/dashboard) shows a **Training Opportunities** badge with the number of conversations that need attention. Click it to jump directly to Chat History, pre-filtered to show only "Needs Training" conversations.
  </Step>

  <Step title="Review the conversation">
    Click a conversation to open the details panel. In the **Training Opportunity** box, you'll see the specific topics your receptionist couldn't answer — displayed as tags like "spa hours", "parking rates", "late checkout policy".
  </Step>

  <Step title="Add the missing knowledge">
    Go to [Training Materials](/admin-panel/documents) and add the information your receptionist was missing. Use **Write Notes** in Q\&A format for the fastest results.
  </Step>

  <Step title="Mark as Trained">
    Return to the conversation and click **"Mark as Trained"**. The status changes from "Needs Training" to "Trained" (purple badge), and the Dashboard badge count decreases.
  </Step>
</Steps>

<Tip>
  **Check every 2-3 days.** Regular reviews help your receptionist improve quickly. Focus on "Needs Training" conversations first — "Other Issues" are usually not fixable with documents alone.
</Tip>
