Documentation Index
Fetch the complete documentation index at: https://setup.cevro.ai/llms.txt
Use this file to discover all available pages before exploring further.
Drivers is the main VoC surface inside Insights. It answers questions like:
- “What are the top reasons players contacted us last month?”
- “Which Themes have the highest escalation rate?”
- “Which Needs are growing the fastest week-over-week?”
Every closed ticket is automatically classified into a three-level taxonomy (Theme → Need → Problem) and visualized here.
URL: https://app.cevro.ai/insights/drivers
Top Bar
| Control | Purpose |
|---|
| Brand | Narrow to a single brand or “All Brands” |
| Date | Preset ranges (last 7/30/60/90 days) or a custom range |
| Group by | Switch the aggregation level for every chart and the explorer table (Theme / Need / Problem) |
| Filter toggle | Reveals the advanced-filters panel |
Group by
| Option | Best for |
|---|
| Theme (default) | High-level executive view |
| Need | Daily operations |
| Problem | Granular drill-downs |
The Charts
Trending
Side-by-side bars comparing the current period vs the previous period for each group. The label above each bar shows percent change. Quick read on which Themes/Needs/Problems are growing or shrinking. Click a bar to drill into its tickets.
Horizontal bar chart of the top 10 groups by ticket volume. Click any bar to drill in.
Top escalation drivers
Top 10 groups ranked by escalation rate. Useful for finding pain points the AI is handing off most often.
Top resolutions
Top 10 groups by resolution rate — the flip side of escalation, where your AI is winning.
Volume trend
A line chart of ticket volume for the top groups across the selected window. Lets you spot momentum changes that aren’t yet visible in the period-over-period bars.
Theme volume treemap
Each rectangle is a Theme/Need/Problem; size = volume, color = average CSAT (red <2.5 → amber → light green → green ≥4.0). Click any tile to drill in.
Topic outcome
Stacked horizontal bars showing for each group: how many tickets were Escalated, handed off via Delegated Resolution, or Resolved by the AI. The fastest way to see where AI is winning vs. handing off.
Topics Explorer table
The most powerful component on the page. A hierarchical table you can expand from Theme → Need → Problem.
| Column | Description |
|---|
| Area / Topic / Issue | The Theme/Need/Problem, indented by hierarchy |
| Vol | Conversation count |
| % | Share of total |
| AHT | Average Handle Time |
| Esc% | Escalation rate |
| Del% | Delegation rate |
| Res% | Resolution rate |
| Sentiment | Negative-sentiment share with a colored chip |
| Trend | Sparkline across the selected window |
Every numeric column is sortable. The View conversations button at the end of each row opens the Conversations Modal scoped to that node. Use the Expand all button above the table to fan out every Theme → Need → Problem in one click.
Drill-down: Conversations Modal
Almost every chart and every “View” button opens the Conversations Modal — a paginated list of the underlying tickets. Each row shows ticket ID, Title, Brand, and Creation Time. Click a row to open the full conversation in a new tab.
The modal inherits the current page-level filters (date, brand, taxonomy node, advanced filters). It’s the bridge between aggregated insight and ground-truth conversation — use it freely, quick drill-downs are the fastest way to validate a number.
Advanced Filters
Click the Filter toggle for the full filter panel. Available filters:
- Signals — tickets that triggered one or more named signals
- Contact drivers — pick specific Need-level drivers
- Status — Resolved / Escalated / Delegated
- Agent — narrow to a specific AI agent
- Browser, Platform, Language, Channel (Web / Email / WhatsApp / Messenger / SMS / API)
- Polarity — Positive / Neutral / Negative tone
- State — Urgent / Confused
- Contact type — Complaint / Help-or-question
- CSAT Rating — 1★ … 5★
- Scorecard — score-range filters per section (when QA Scoring is enabled)
- Page — substring match on the page URL where the chat started
- Player metadata — dynamic conditions on contact attributes (e.g. country = Brazil, lifetime deposits > $10k)
The badge on the filter toggle counts how many advanced filters are active.
Tips
- Start at Theme, drill to Problem. Begin with Group by Theme for the executive view, then drop into Need / Problem when you need to act.
- Compare windows. The Trending chart and the Trend sparkline make week-over-week shifts obvious. Don’t over-react to single-day spikes.
- Cross-reference with Sentinel. A spike in a Theme + low scorecard quality on those same tickets = an actionable training brief.
- If a Theme has no Need-level rows you recognize, head to Taxonomy and review the Discovery suggestions — emerging patterns may not be in your taxonomy yet.
- Taxonomy — the catalog of Themes, Needs, and Problems
- Feedback — CSAT clustering, the service-quality counterpart to VoC
- Signals — message-level detection (the “what is happening during the conversation” view)
- Overview — the executive landing page that pulls from this data