---
title: "Analytics & Chat History — AVCodex Docs"
description: "Analytics & Chat History — AVCodex documentation for AV integrators, programmers, and ops teams."
lang: en
json-ld:
---

[](/)

Solutions

[Pricing](/pricing)[The Signal](/blog)[Resources](/resources)

Learn

[Free AI Assessment](/scorecard)[Get Started →](/pricing)

[Documentation Home](/docs)

Guides 

Getting Started

-   [The Alchemist Copilot](/docs/guides/the-alchemist-copilot)
-   [Choosing a Model](/docs/guides/choosing-a-model)
-   [Skills & Templates](/docs/guides/skills-and-templates)
-   [Pricing & Usage](/docs/guides/pricing-and-usage)
-   [Understanding Tokens](/docs/guides/understanding-tokens)
-   [Maximize AVCodex Capabilities](/docs/guides/maximize-avcodex-capabilities)

Knowledge & Memory

-   [How Knowledge Sources Work](/docs/guides/how-knowledge-sources-work)
-   [Knowledge Retrieval Settings](/docs/guides/knowledge-retrieval-settings)
-   [User Memory](/docs/guides/user-memory)
-   [Consumer Brain](/docs/guides/consumer-brain)

Agent Capabilities

-   [Image Recognition](/docs/guides/image-recognition)
-   [Image Generation](/docs/guides/image-generation)
-   [Video Generation](/docs/guides/video-generation)
-   [Deep Research and Deep Thinking](/docs/guides/deep-research-and-deep-thinking)
-   [Heartbeat (Proactive AI Outreach)](/docs/guides/heartbeat-proactive-ai-outreach)
-   [Database Connections](/docs/guides/database-connections)
-   [Agent-to-Agent Links](/docs/guides/agent-to-agent-links)
-   [Message Tagging](/docs/guides/message-tagging)
-   [Lead Generation Forms](/docs/guides/lead-generation-forms)
-   [Multilingual Apps](/docs/guides/multilingual-apps)
-   [Understanding Evaluations](/docs/guides/understanding-evaluations)

Design & Experience

-   [Style Studio](/docs/guides/style-studio)
-   [Component Studio](/docs/guides/component-studio)
-   [HQ Profile](/docs/guides/hq-profile)
-   [Multiplayer Chat](/docs/guides/multiplayer-chat)
-   [Circles](/docs/guides/circles)
-   [Desktop Agent](/docs/guides/desktop-agent)

Voice & Phone

-   [Phone Numbers](/docs/guides/phone-numbers)
-   [Outbound Calling](/docs/guides/outbound-calling)
-   [Voice Cloning](/docs/guides/voice-cloning)

Publish & Share

-   [Embed Chat Widget](/docs/guides/embed-chat-widget)
-   [Custom Domains](/docs/guides/custom-domains)
-   [PWA Installation](/docs/guides/pwa-installation)
-   [AVCodex Sites](/docs/guides/avcodex-sites)
-   [Embed on Kajabi](/docs/guides/embed-on-kajabi)
-   [How to Use AVCodex with Claude Code](/docs/guides/how-to-use-avcodex-with-claude-code)

Monetization & Access

-   [Selling Access](/docs/guides/selling-access)
-   [Consumer Monetization](/docs/guides/consumer-monetization)
-   [Access Control](/docs/guides/access-control)
-   [Bring Your Own Auth](/docs/guides/bring-your-own-auth)
-   [Clever SSO for Schools](/docs/guides/clever-sso-for-schools)

Analytics & Operations

-   [Analytics & Chat History](/docs/guides/analytics-and-chat-history)
-   [Performance Dashboard](/docs/guides/performance-dashboard)
-   [Programmatic Usage Stats](/docs/guides/programmatic-usage-stats)
-   [Session Lifecycle Webhooks](/docs/guides/session-lifecycle-webhooks)
-   [Audit Logs](/docs/guides/audit-logs)

Teams & White-Label

-   [Team Management](/docs/guides/team-management)
-   [Enterprise Whitelabel](/docs/guides/enterprise-whitelabel)

Alchemist Platform

-   [Alchemist Tickets](/docs/guides/alchemist-tickets)
-   [Alchemist Getting Started](/docs/guides/alchemist-getting-started)
-   [Alchemist Working with Tickets](/docs/guides/alchemist-working-with-tickets)
-   [Alchemist Local Development](/docs/guides/alchemist-local-development)

Alchemist Operations

-   [Alchemist Environment Variables](/docs/guides/alchemist-environment-variables)
-   [Alchemist Deploys and Domains](/docs/guides/alchemist-deploys-and-domains)
-   [Alchemist Self-Healing](/docs/guides/alchemist-self-healing)

Alchemist API & Automation

-   [Alchemist API Keys](/docs/guides/alchemist-api-keys)
-   [Alchemist MCP Server](/docs/guides/alchemist-mcp-server)
-   [Alchemist Pipeline Configuration](/docs/guides/alchemist-pipeline-configuration)
-   [Alchemist Pipeline Permutations](/docs/guides/alchemist-pipeline-permutations)

Developer Platform

-   [Building Custom MCP Servers](/docs/guides/building-custom-mcp-servers)
-   [Consumer OAuth for Custom MCP Servers](/docs/guides/consumer-oauth-for-custom-mcp-servers)

AVCodex MCP Server

-   [Overview](/docs/guides/overview)
-   [MCP Reference](/docs/guides/mcp-reference)
-   [Setup & Installation](/docs/guides/setup-and-installation)
-   [Authentication](/docs/guides/authentication)
-   [Tools Reference](/docs/guides/tools-reference)
-   [Common Workflows](/docs/guides/common-workflows)
-   [Rate Limits](/docs/guides/rate-limits)

Custom Actions 

Pro Actions 

API 

Builder API 

Agentic Commerce (ACP) 

Integrations 

[Docs](/docs)/ Guides / Analytics & Operations 

# Analytics & Chat History

Last updated · MAR 2026 · [Read as Markdown](/docs/guides/analytics-and-chat-history.md)

# Analytics and Chat History

See every conversation your AVCodex agent has had with techs, programmers, and end-clients. Track usage. Export data so you can feed it back into your operations review.

Browse every conversation, watch the metrics that matter (volume, repeat questions, unresolved threads), and pull data out for your own analysis.

## [Accessing Chat History# ](#accessing-chat-history)

Open **Chats** in your agent's navigation. The page has two tabs:

-   **Chatlogs**: browse and view conversations.
-   **Actions**: download data and wire up output integrations.

## [Chat List# ](#chat-list)

The left side shows every session with filters:

### [Filters# ](#filters)

Filter

Options

**Search**

Search message content

**Status**

All or Unread only

**Source**

Web, API, Slack, WhatsApp, Email, Voice

**Tag**

Filter by conversation tags

**Phone Number**

Filter by phone (voice or SMS conversations)

### [Chat Session Info# ](#chat-session-info)

Each session shows:

-   User name or email (if collected) or anonymous.
-   Source channel badge.
-   Preview of recent messages.
-   Timestamp.
-   Unread indicator.

## [Viewing Conversations# ](#viewing-conversations)

Click a session to open it.

### [Transcript Tab# ](#transcript-tab)

-   Full message history.
-   User and agent turns.
-   Timestamps on every message.
-   Attachments and images shared (a photo of a bad signal-flow indicator, an iPad screenshot of a Q-SYS UI, a control panel error code).

### [Memory Extracted Tab# ](#memory-extracted-tab)

-   Facts the agent pulled out of this conversation.
-   Used for the User Memory feature.

## [Usage Metrics# ](#usage-metrics)

In the **Actions** tab you get a high-level read:

Metric

Description

**Total Sessions**

All chat sessions

**Unread**

Sessions you have not opened

**Today**

Sessions from today

**Avg Messages**

Average messages per session

**Unique Users**

Distinct users who chatted

For an AV helpdesk agent, the metrics that matter most are usually: total sessions per site (which buildings are calling for help most often), unique users (are the same techs hitting the same issues), and avg messages (long conversations often signal a docs gap).

## [Downloading Chat Data# ](#downloading-chat-data)

### [Download as CSV# ](#download-as-csv)

1.  Open **Chats** -> **Actions**.
2.  Click **Download Chatlogs**.
3.  A CSV downloads with every conversation.

The CSV contains:

-   Session ID.
-   User info (if collected).
-   Source channel.
-   Timestamps.
-   All messages with roles.

### [Google Sheets Integration# ](#google-sheets-integration)

Sync new conversations to Google Sheets automatically:

1.  Open **Chats** -> **Actions**.
2.  Click the **Output** card.
3.  Connect Google Sheets.
4.  New conversations land as new rows.

Useful for AV ops managers who want a single sheet of every interaction across all client sites.

## [Managing Conversations# ](#managing-conversations)

### [Mark as Read# ](#mark-as-read)

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

### [Filter by Source# ](#filter-by-source)

Use the Source filter to see only conversations from a given channel:

-   **Web**: browser widget or iframe (a QR code in a conference room).
-   **API**: API integrations (a custom dispatch app).
-   **Slack**: Slack bot messages (your internal #av-ops channel).
-   **WhatsApp**: WhatsApp integration (a field tech in transit).
-   **Email**: email conversations.
-   **Voice**: phone call transcripts.

## [Improving Your Agent# ](#improving-your-agent)

Use chat history to make the agent better:

1.  **Find common questions.** Search for patterns. If 40% of conversations are "audio is too low in BOS-14", that is a real-world signal.
2.  **Spot confusion.** Long back-and-forth threads usually mean a docs gap or a missing tool.
3.  **Update knowledge.** Add the missing AS-built drawing, programming guide, or commissioning checklist.
4.  **Refine prompts.** Adjust the system prompt based on the conversations you actually see, not the ones you imagined.

## [Troubleshooting# ](#troubleshooting)

### [No conversations showing# ](#no-conversations-showing)

1.  Confirm the agent is published and reachable.
2.  Check that users have actually chatted (test it yourself).
3.  Clear all filters.

### [Cannot find a specific chat# ](#cannot-find-a-specific-chat)

1.  Use the search box on message content.
2.  Filter by source if you know the channel.
3.  Confirm the status filter is not hiding it.

### [Download not working# ](#download-not-working)

1.  Wait for the download to finish (large datasets take a moment).
2.  Check your browser's download folder.
3.  Try a different browser if it persists.

## [Using with MCP# ](#using-with-mcp)

Pull analytics programmatically through the AVCodex MCP Server. Useful for AI-assisted reviews and bulk reporting.

### [Available Tools# ](#available-tools)

Tool

Description

`get_app_analytics`

Summary metrics (sessions, messages, users, satisfaction)

`search_conversations`

Find conversations with filters and search

`get_conversation`

Full conversation transcript

`get_top_queries`

Most common user questions

`export_conversations`

Export conversation data to JSON

`get_tag_analytics`

View tag detection metrics

### [Example Prompts# ](#example-prompts)

code 

```
"Show me analytics for my AV helpdesk agent for the past week."
"Find conversations where techs mentioned 'no audio'."
"What are the top 10 questions techs ask my Crestron-programmer assistant?"
"Export all conversations from December."
```

### [Workflow: Weekly Operations Review# ](#workflow-weekly-operations-review)

code 

```
You: Show me a summary of all my agents' performance this week.

Agent: [calls get_app_analytics for each agent]
Weekly summary:
- AV Helpdesk: 1,247 conversations, 4.5/5 satisfaction
- Crestron Programmer Assistant: 432 conversations, 4.3/5
- Spec-Sheet Bot: 298 conversations, 4.1/5

You: What are techs asking about most?

Agent: [calls get_top_queries]
Top queries across your agents:
1. "How do I reset the Q-SYS Core remotely?" (142)
2. "What is the firmware version for DM-NVX-360?" (98)
3. "Audio is dropping out on Shure MXA920 in BOS-14." (74)
...
```

> **Note:** MCP server access requires a Builder plan or higher.

\*AVCodex · Your AV expertise. Amplified by AI.\*

Was this helpful? 

[Edit this page →](#)

[

Previous

Clever SSO for Schools

](/docs/guides/clever-sso-for-schools)[

Next

Performance Dashboard

](/docs/guides/performance-dashboard)

On this page

-   [Accessing Chat History](#accessing-chat-history)
-   [Chat List](#chat-list)
-   [Filters](#filters)
-   [Chat Session Info](#chat-session-info)
-   [Viewing Conversations](#viewing-conversations)
-   [Transcript Tab](#transcript-tab)
-   [Memory Extracted Tab](#memory-extracted-tab)
-   [Usage Metrics](#usage-metrics)
-   [Downloading Chat Data](#downloading-chat-data)
-   [Download as CSV](#download-as-csv)
-   [Google Sheets Integration](#google-sheets-integration)
-   [Managing Conversations](#managing-conversations)
-   [Mark as Read](#mark-as-read)
-   [Filter by Source](#filter-by-source)
-   [Improving Your Agent](#improving-your-agent)
-   [Troubleshooting](#troubleshooting)
-   [No conversations showing](#no-conversations-showing)
-   [Cannot find a specific chat](#cannot-find-a-specific-chat)
-   [Download not working](#download-not-working)
-   [Using with MCP](#using-with-mcp)
-   [Available Tools](#available-tools)
-   [Example Prompts](#example-prompts)
-   [Workflow: Weekly Operations Review](#workflow-weekly-operations-review)

[](/)

The AI platform built exclusively for professional AV. Build, deploy, and sell AI tools that understand your industry.

### Platform

-   What You Can Build
-   Templates
-   [Pricing](/pricing)

### Services

-   [Done-For-You](/pricing)
-   [Academy](/academy)
-   [Contact](/contact)

### Company

-   About
-   [The Signal](/blog)
-   [Docs](/docs)
-   [LinkedIn](#)

© 2026 AVCodex. A Future Ready Holdings Inc. product. SOC 2 Type II Certified · HIPAA Compliant