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

# Insights hub orientation

> What the /insights landing grid is, how its native vs cross-linked tiles behave, which tiles are role-gated, and where each tile's read guide lives.

# Insights hub orientation

The **Insights** hub is the landing grid at `/insights` that groups every analytics surface in the dashboard into one navigable tile set — the answer to "where do I go to look at the numbers?" when you open the sidebar's **Insights** entry.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/zeelaltd/images/insights-hub-grid-placeholder.png" alt="Insights hub grid" />

Each row below is a hub tile. Tiles marked `future` have no read guide yet — the page works, the gap is in the docs tree.

## The tile model

Every section card answers four questions before you click:

* **Name and one-line description** — the surface's headline metric and scope, with an icon.
* **Native vs Cross-link badge.** Native tiles route under `/insights/<name>`; a Cross-link badge means the tile hands off to a surface that lives in a sibling tree (the omnichannel wallboard, the voice tree, the quality hub) — the badge's hover hint reads "Lives in another section of the dashboard."
* **Coming soon badge.** Occasionally a tile ships pre-launch as a teaser: the route exists and is navigable, the underlying endpoint ships later. Read-intent tiles lose the badge when their endpoint goes live.
* **Role-gating.** A handful of tiles only render for an allow-listed seat (see [RBAC visibility](#rbac-visibility)). The filter is the same normalised org role the sidebar uses, and the destination page re-checks it server-side — the tile hide is presentation-only, never an authorisation boundary.

## RBAC visibility

Three gating families live on the hub:

* **Finance cluster** — Channel Costs, LLM spend, Sustainability, Agent ROI, and Agent comparison render only for owner/admin/developer/billing seats. A viewer or agent sees none of these tiles, and the destination page 403s them regardless — the grid simply avoids showing a surface a role can't read.
* **CDP-family cluster** — Retention, Funnels & Retention, Account Scores, and Auto-drafted knowledge render only for owner/admin/developer, mirroring the read gate over the PII-bearing customer-event stream.
* **Quality cluster** — Quality Management renders to owner/admin, Performance Leaderboard to owner/admin/supervisor, and QA Evaluations also to `agent` (an agent sees only their own evaluations page).

Everything else on the hub — Analytics, Logs, KPI Alerts, Usage anomalies, Usage alert rules, Reports, SMS Click-Through, Link Tracking, Conversation Intelligence, Contact Reasons, Topic Intelligence, Sentiment, Journey Paths, High-friction sessions, Deliverability, Conversion Goals, Attribution, Marketing mix model, Surveys, AI Containment, Per-language AI quality, Search Analytics, the two wallboards, Voice Quality, and Scheduled Reports — renders for every member, including viewers, because its read route is genuinely member-readable. Writes on alerting rules stay owner/admin/developer-gated at the API, but the read views are open.

## How to navigate

In the dashboard, open the sidebar's **Insights** entry — the hub is its landing page. Direct URLs work the same: `/insights` renders the grid, and any tile href (`/insights/<route>` for native tiles, the absolute path for Cross-link tiles) is bookmarkable.

The hub headers two live stat rows above the tiles — a 24-hour API-count / latency / messages / agents row and the flagged-transactions strip — and one cross-link row below. Use the sidebar only when you want the grid again; every tile name doubles as its direct route segment for scripting or sharing links.

## Section map

| Tile                      | Dashboard route                    | Read guide                                                                                                                           |                                                                    |
| ------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ |
| Analytics                 | `/insights/analytics`              | \[Insights                                                                                                                           | real-time analytics reading]\(/guides/insights-analytics-realtime) |
| Dashboard Builder         | `/insights/dashboards`             | [Insights dashboard builder](/guides/insights-dashboard-builder)                                                                     |                                                                    |
| Conversation Intelligence | `/insights/conversations`          | `future` (conversation-intelligence guide covers the per-conversation view; no roll-up guide yet)                                    |                                                                    |
| Contact Reasons           | `/insights/contact-reasons`        | [Contact reasons](/guides/contact-reasons)                                                                                           |                                                                    |
| Topic Intelligence        | `/insights/topic-intelligence`     | [Topic intelligence](/guides/insights-topic-intelligence)                                                                            |                                                                    |
| Sentiment                 | `/insights/sentiment`              | [Sentiment portfolio reading](/guides/sentiment-portfolio-reading)                                                                   |                                                                    |
| Customer Journey Paths    | `/insights/journey-paths`          | [Journey paths reading](/guides/journey-paths-reading)                                                                               |                                                                    |
| High-friction sessions    | `/insights/high-friction-sessions` | [High-friction sessions reading](/guides/high-friction-sessions-reading)                                                             |                                                                    |
| Logs                      | `/insights/logs`                   | [Insights logs viewer](/guides/insights-logs-viewer)                                                                                 |                                                                    |
| KPI Alerts                | `/insights/alerts`                 | [KPI alerts](/guides/kpi-alerts)                                                                                                     |                                                                    |
| Usage anomalies           | `/insights/anomalies`              | [Usage anomaly alert rules](/guides/usage-anomaly-alert-rules)                                                                       |                                                                    |
| Usage alert rules         | `/insights/usage-alert-rules`      | [Usage anomaly alert rules](/guides/usage-anomaly-alert-rules)                                                                       |                                                                    |
| Reports                   | `/insights/reports`                | `future` (no consolidated reports-catalogue guide yet)                                                                               |                                                                    |
| SMS Click-Through         | `/insights/sms-ctr`                | [SMS click-through](/insights/sms-ctr)                                                                                               |                                                                    |
| Link Tracking             | `/insights/links`                  | `future` ([short links and click tracking](/guides/short-links-and-click-tracking) covers the mint; no per-link analytics guide yet) |                                                                    |
| Retention                 | `/insights/retention`              | [Cohort retention](/guides/insights-cohort-retention)                                                                                |                                                                    |
| Funnels & Retention       | `/insights/funnels`                | [Funnels over CDP events](/guides/insights-funnels-cdp-conversion)                                                                   |                                                                    |
| Account Scores            | `/insights/account-scores`         | [Account scores](/guides/account-scores)                                                                                             |                                                                    |
| Wallboard                 | `/wallboard`                       | [Wallboard](/guides/wallboard)                                                                                                       |                                                                    |
| Inbox Wallboard           | `/wallboard#digital`               | [Wallboard](/guides/wallboard)                                                                                                       |                                                                    |
| Voice Quality             | `/voice/quality`                   | `future` (no carrier-route MOS guide yet)                                                                                            |                                                                    |
| Quality Management        | `/quality`                         | [Quality management program](/guides/quality-management-program)                                                                     |                                                                    |
| QA Evaluations            | `/quality/evaluations`             | [QA evaluations](/guides/quality-evaluations)                                                                                        |                                                                    |
| Performance Leaderboard   | `/quality/leaderboard`             | [Quality leaderboard](/guides/quality-leaderboard)                                                                                   |                                                                    |
| Deliverability            | `/insights/deliverability`         | [Deliverability reading](/guides/insights-deliverability-reading)                                                                    |                                                                    |
| Conversion Goals          | `/insights/goals`                  | [Conversion goals and attribution](/guides/conversion-goals-attribution)                                                             |                                                                    |
| Attribution               | `/insights/attribution`            | [Multi-touch attribution](/guides/multi-touch-attribution)                                                                           |                                                                    |
| Marketing mix model       | `/insights/media-mix-model`        | [Marketing mix model](/guides/marketing-mix-model)                                                                                   |                                                                    |
| Surveys                   | `/insights/surveys`                | [Surveys and Voice-of-Customer](/guides/surveys-voc)                                                                                 |                                                                    |
| Channel Costs             | `/insights/costs`                  | [Channel costs](/guides/insights-costs)                                                                                              |                                                                    |
| LLM spend                 | `/insights/llm-spend`              | [LLM spend](/guides/insights-llm-spend)                                                                                              |                                                                    |
| Sustainability            | `/insights/sustainability`         | [Sustainability and ESG reporting](/guides/sustainability-esg-reporting)                                                             |                                                                    |
| Agent ROI                 | `/insights/agent-roi`              | [Agent ROI attribution](/guides/agent-roi-attribution)                                                                               |                                                                    |
| AI Containment            | `/insights/containment`            | [Agent containment dashboard](/guides/agent-containment-dashboard)                                                                   |                                                                    |
| Per-language AI quality   | `/insights/language-quality`       | [Language quality](/guides/language-quality)                                                                                         |                                                                    |
| Auto-drafted knowledge    | `/insights/kb-auto-draft`          | [Auto-drafted knowledge](/guides/kb-auto-draft)                                                                                      |                                                                    |
| Agent comparison          | `/insights/agent-comparison`       | [Agent comparison](/guides/agent-comparison)                                                                                         |                                                                    |
| Search Analytics          | `/insights/search-analytics`       | [Search analytics reading](/guides/search-analytics-reading)                                                                         |                                                                    |
| Scheduled Reports         | `/insights/scheduled-reports`      | `future` ([scheduled reports](/guides/scheduled-reports) covers on-demand + scheduled; the dedicated tile guide is open)             |                                                                    |

## Role-specific views

Two worked examples of the same hub, one per seat:

* **A viewer or agent** opens the grid and never sees the finance cluster (Channel Costs, LLM spend, Sustainability, Agent ROI, Agent comparison) or the CDP-family cluster — every tile they do see is one their role's read route is entitled to, so the grid is always the full set of what they can open. An agent additionally sees QA Evaluations (their own evaluation scores, acknowledge/appeal workflow) but not the org-wide Quality Management rollup.
* **An admin** sees every tile on the grid including the finance and CDP families, because their seat passes the hub's normalised-role filter and the destination page's server-side guard in the same way.

## Fraud alerts strip

Below the stat row, the hub renders the **flagged-transactions strip** — the top open fraud alerts raised on this account's spend traffic. Each alert deep-links to its evidence; the strip collapses entirely when the fraud-shield queue is empty rather than rendering an empty container. For alert triage, verdicts, and the how-it-scans model, see the [Compliance fraud shield](/guides/compliance-fraud-shield) guide.

## See also

* [Dashboard Home walkthrough](/guides/dashboard-home) — the triage surface pointing into this hub
* [Insights dashboards](/guides/insights-dashboards) — the analysis surface this hub aggregates
* [Insights → Logs viewer](/guides/insights-logs-viewer) — the wider, filterable form of the activity feed
