> For the complete documentation index, see [llms.txt](https://communityone.gitbook.io/communityone/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://communityone.gitbook.io/communityone/feature-deepdive/sparkai/spark-analytics.md).

# Spark Analytics

**Click** [**here**](https://discord.com/oauth2/authorize?client_id=1069423090225918082\&permissions=275146722545\&integration_type=0\&scope=applications.commands+bot\&redirect_uri=https%3A%2F%2Fcommunityone.io%2Fdashboard%2Fbot-auth-complete%2F%3Fsource%3Dgitbook\&response_type=code) **to introduce our bot to your server.**

The Spark Analytics tab is your single source of truth for everything happening inside your Spark agents — across both Discord and your Website Widget. Track engagement, surface the most valuable user questions, and find content gaps where your knowledge base could be improved.

<figure><img src="/files/PK5OerLJtQmhiAhSsEdH" alt=""><figcaption></figcaption></figure>

### Overview

The Analytics tab shows you four things, in order:

1. Daily Sessions — how engaged your community is, day over day
2. Content Gap — questions the bot couldn't fully answer (your highest-leverage to-do list)
3. Questions — the most valuable user questions, ranked
4. Sessions — every individual conversation, with full transcripts

A session is defined as a contiguous burst of activity from one user with gaps under 12 hours. So if a user asks three questions in a row and comes back the next morning, that's two sessions

### The Date Range Selector

At the top of the page is a global range selector with three options:

* 7 days
* 30 days (default)
* 90 days

This pill controls every section on the page — the chart, content gap, questions, and sessions all refresh together when you change the range. No need to set the date filter in multiple places.

### Daily Sessions Chart

Right below the range pill, you see three top-line stats and a chart.

#### Stats Row

| Stat             | What it means                                               |
| ---------------- | ----------------------------------------------------------- |
| Discord sessions | Total sessions on Discord in the selected range             |
| Website sessions | Total sessions on your Website Widget in the selected range |
| Total sessions   | The combined total                                          |

#### The Chart

The chart shows stacked daily sessions (Discord in purple, Website in gold) with the cumulative total overlaid as a line. Hover any day to see the exact breakdown.

This is the fastest way to spot:

* Day-of-week patterns (when is your community most active?)
* Spikes after a launch, blog post, or community event
* Which surface — Discord or Website — is driving most of your engagement

<figure><img src="/files/nC1xAGUcH0zz6jAK1hs4" alt=""><figcaption></figcaption></figure>

### Content Gap

> Content Gap is a Premium feature. It requires Spark premium or analytics premium

This is the most actionable section on the page. It surfaces inquiries where the bot couldn't fully answer — every entry is an opportunity to expand your knowledge docs.

<figure><img src="/files/IG59es2B9RubXbuPyiSi" alt=""><figcaption></figcaption></figure>

#### Filters

A status dropdown lets you slice the list:

| Status             | What it shows                              |
| ------------------ | ------------------------------------------ |
| Awaiting (default) | Gaps you haven't addressed yet             |
| Resolved           | Gaps where you've added an answer          |
| Dismissed          | Gaps you've intentionally chosen to ignore |
| All                | Everything                                 |

A Date sort button lets you toggle ascending/descending order.

#### Workflow

For each "Awaiting" gap, you have three options:

1. Add Answer — Opens the answer editor (see below)
2. Dismiss — Hides the gap if it's not worth answering (e.g. spam or off-topic)
3. Restore — Available on dismissed gaps; brings them back to "Awaiting"

#### The Answer Editor

When you click Add Answer, a modal opens with:

* The user's original inquiry with a one-click translation button (translate non-English questions to your working language)
* The detected knowledge gap (a short summary of what was missing)
* Title — a short label (e.g. *"How to login my account"*)
* Description — the full answer; supports rich text

Two AI helpers speed up the workflow:

* Polish with AI — Cleans up your rough draft into a publishable knowledge document. Premium users get a higher-quality model (`gemini-2.5-pro`); free users get `gemini-2.5-flash`. The polished version appears in a preview panel — accept it (Replace draft) or reject it (Cancel).
* Translate — Translate either the user inquiry or your final answer into any language you specify.

When you save, the answer is automatically synced to your knowledge base and the gap moves to Resolved. Spark will use this new doc for future questions.

<figure><img src="/files/d8q1ibC4hepzwALjjrjD" alt=""><figcaption></figcaption></figure>

#### Manage Your Additions

The Manage your additions link in the top-right of the section opens a modal where you can review, edit, or delete every gap-fill answer you've ever added.

<figure><img src="/files/agSrq6yucsFGixqI9uqW" alt=""><figcaption></figcaption></figure>

### Questions

> Questions is a Premium feature. It requires analytics premium level 2 and above

The Questions section ranks user questions by how many of your knowledge-doc keywords they mention. This surfaces the questions most relevant to *what your business actually does* — not just the most frequent.

#### How the ranking works

1. We scan your knowledge documents and extract topical keywords
2. Every question gets a score based on how many of those keywords it touches
3. The list is sorted highest-score first

Each row shows:

* The full question text
* Topic tags in gold — the matched keywords
* Metadata (when it was asked, which platform, the user)

#### Click to Expand

Click any question to open the full conversation transcript in a modal. This gives you the surrounding context — what the user asked before and after, and how the bot responded.

#### Pagination

Use the Load more button at the bottom to fetch more questions in batches.

#### Why this matters

Questions that score high are signals about what your community cares about most. Use them to:

* Decide what to write your next blog post about
* Spot product features people are confused by
* Prioritize which docs need updating

***

### Sessions

The Sessions table lists every individual conversation in the selected range. Click any row to view the full transcript.

#### Filters

Two filters live above the table:

| Filter   | Options                     | What it does                                                                    |
| -------- | --------------------------- | ------------------------------------------------------------------------------- |
| Platform | All, Discord, Website       | Drill into one surface at a time                                                |
| Depth    | All, 1 message, 2+ messages | "2+ messages" = high-intent, multi-turn conversations — usually your best leads |

A Reset button clears all filters at once.

#### Sortable Columns

Click any column header to sort:

* Started (UTC) — default, descending
* Platform
* User
* Messages — message count from the user

Click again to flip sort direction.

#### Pagination

Standard previous/next pagination at the bottom of the table.

#### Transcript Modal

Clicking a row opens a transcript modal showing:

* The full conversation in chat-bubble format
* Who said what (purple = user, gold = bot)
* Timestamps for every message

This is invaluable for reviewing how your bot handled a real conversation — and for spotting opportunities to refine your prompt or add an AI rule.

### Tips

* Start with Content Gap. If you have 10 minutes a week, spend it here. Resolving 3–5 gaps each week compounds into a much smarter bot.
* Use Questions to fuel content. The questions that score high against your keywords are the topics your community wants to read about. Turn them into blog posts, FAQs, or video content.
* Filter Sessions by "2+ messages" + "Website" to find your highest-intent leads. These are visitors who came back with follow-up questions — exactly the people worth a personal outreach.
* Compare Discord vs. Website in the Daily chart. Discord users tend to be casual and exploratory; Website visitors are usually purpose-driven. Different audiences, different questions, different value.
* All times are UTC. Session timestamps and date ranges use UTC across the board.

{% hint style="info" %}
Join [Discord](https://discord.gg/nVqt3z78Mw) for questions, comments, and a little gift <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f381/512.gif" alt="🎁" data-size="line">  or back to [CommunityOne Home](https://communityone.io/)
{% endhint %}
