> ## 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.

# Hub map

> A scannable index of every Insights tile — what question each one answers, how tiles group into comparison, cohort, operations, and cost task families, which roles see which tiles, and how to export a read.

# Hub map

The Insights hub at `/insights` is a grid of roughly thirty-five tiles. This page is the map: one line per tile — the question it answers and when to open it — before you click, plus the task families the tiles group into, the roles that see each cluster, and the export paths out of every surface. The [Insights hub overview](/insights/overview) walks the same grid top to bottom with worked examples; this page is the fast index.

## What each tile answers

Each row names the tile, the route it opens, and the one question it exists to answer.

| Tile | Route | The question it answers |
| - | - | - |
| Analytics | `/insights/analytics` | What changed across channels in the last 24 hours, 7 or 30 days — sends, deliveries, latency? |
| Dashboard Builder | `/insights/dashboards` | Can I pin the charts I reopen every morning onto one custom page? |
| Logs | `/insights/logs` | What did this one API request or message do — filterable event history? |
| KPI Alerts | `/insights/alerts` | Which CSAT/NPS/CES/LLM-spend/containment thresholds are armed, and which fired? |
| Usage anomalies | `/insights/anomalies` | Which usage spikes or drops did the anomaly detector flag? |
| Usage alert rules | `/insights/usage-alert-rules` | Which transport signals (delivery rate, volume, spend) am I watching on a rule? |
| Reports | `/insights/reports` | Can I generate a stakeholder-ready report (delivery, cost, campaign ROI) right now? |
| Scheduled Reports | `/insights/scheduled-reports` | Which reports leave on a cadence, and to whom? |
| Agent comparison | `/insights/agent-comparison` | Which AI-agent variant is winning on containment, resolution, cost, and margin? |
| AI Containment | `/insights/containment` | How much traffic do AI agents resolve without a human, and where do they escalate? |
| Per-language AI quality | `/insights/language-quality` | Does agent quality hold per language, or does one locale degrade first? |
| Conversation Intelligence | `/insights/conversations` | What themes and outcomes recur across conversations? |
| Contact Reasons | `/insights/contact-reasons` | What are customers contacting us about, and in what proportion? |
| Topic Intelligence | `/insights/topic-intelligence` | Which topics trend up or down across the conversation corpus? |
| Sentiment | `/insights/sentiment` | Where does customer sentiment sit per channel, and which way is it moving? |
| Customer Journey Paths | `/insights/journey-paths` | Which sequences of steps do customers actually take through our flows? |
| High-friction sessions | `/insights/high-friction-sessions` | Which sessions show struggle signals that predict abandonment? |
| Retention | `/insights/retention` | Do entry cohorts come back — did the improvement hold after week one? |
| Funnels & Retention | `/insights/funnels` | Where between two defined steps do CDP events drop off? |
| Account Scores | `/insights/account-scores` | Which accounts rank healthiest or riskiest on the composite score? |
| Conversion Goals | `/insights/goals` | Which defined goals convert, and at what rate? |
| Attribution | `/insights/attribution` | Which channels earn conversion credit, under each touch model? |
| Marketing mix model | `/insights/media-mix-model` | What does the model say about marginal return per marketing channel? |
| Surveys | `/insights/surveys` | What do CSAT/NPS surveys say, per campaign and channel? |
| Campaign analytics | `/insights/campaign-analytics` | Which campaign performed on sends, deliveries, and conversions? |
| SMS Click-Through | `/insights/sms-ctr` | What CTR does each SMS campaign or queue get on tracked links? |
| Link Tracking | `/insights/links` | Which short links were clicked, and by how many unique clickers? |
| Deliverability | `/insights/deliverability` | Which destinations and routes cost deliveries, and where does the rate sag? |
| Search Analytics | `/insights/search-analytics` | What do users search, and which queries return nothing? |
| Auto-drafted knowledge | `/insights/kb-auto-draft` | Which agent answers were drafted into knowledge articles for review? |
| Channel Costs | `/insights/costs` | Where does the budget go per channel, per destination? |
| LLM spend | `/insights/llm-spend` | Where do AI tokens flow per model, and what is the bill per agent? |
| Sustainability | `/insights/sustainability` | What is the carbon and energy estimate of the channel mix? |
| Agent ROI | `/insights/agent-roi` | What margin does each agent return against its operating cost? |
| ROI attribution | `/insights/agent-roi` | Which revenue does each agent attribute — same surface, credit view. |

For per-tile read guides, open the [Section map on the hub overview](/insights/overview#section-map). Cross-link tiles that live in sibling dashboards — Wallboard, Voice Quality, QA program, Performance Leaderboard — are listed there too; the badge reads "Lives in another section of the dashboard."

## The task families

Four families cover the grid. Pick a family before a tile — it narrows where to look.

1. **Comparison** — Agent comparison, Attribution, Conversion Goals, Funnels & Retention. Decide which of two variants, channels, or steps wins. Start a rollout here.
2. **Cohort** — Retention, Account Scores, Funnels & Retention. Confirm the comparison win survived its entry cohort. Route a variant through here before signing off.
3. **Operations** — Logs, KPI Alerts, Usage anomalies, Usage alert rules, Scheduled Reports, Reports. Watch the live stream, arm the tripwires, and package numbers for stakeholders.
4. **Cost** — Channel Costs, LLM spend, Sustainability, Agent ROI. Reconcile the budget per channel, model, and agent.

Cross-cutting reads — Conversation Intelligence, Contact Reasons, Topic Intelligence, Sentiment, Journey Paths, High-friction sessions — explain *why* a comparison or cohort read moved; open them in any family when the headline number needs a reason.

## The decision loop

Operators run the grid as one loop:

1. **Compare** two variants on [Agent comparison](/insights/agent-comparison).
2. **Confirm** the win held per cohort on [Retention](/insights/retention).
3. **Assign** credit on [Funnels & Retention](/insights/funnels) and [Attribution](/insights/attribution).
4. **Pin** the deciding metric with an alert on [KPI Alerts](/insights/alerts).

The worked narrative — same four steps through a realistic exec decision — is in [Read the Insights dashboards as one decision picture](/guides/insights-agent-comparison-cohort-loop). The operator walkthrough with screenshots-is-reference numbers is on [Build a comparison view across two variants](/insights/overview#build-a-comparison-view-across-two-variants).

## RBAC — who sees which tiles

Tile visibility mirrors the normalised org role; the destination page re-checks it server-side, so the grid only hides what a role cannot open. Three clusters gate:

* **Finance cluster** — Channel Costs, LLM spend, Sustainability, Agent ROI, Agent comparison: owner/admin/developer/billing seats.
* **CDP cluster** — Retention, Funnels & Retention, Account Scores, Auto-drafted knowledge: owner/admin/developer.
* **Quality cluster (cross-link tiles)** — Quality Management: owner/admin; Performance Leaderboard: owner/admin/supervisor; QA Evaluations: additionally `agent`, own evaluations only.

Everything else — Analytics, Dashboard Builder, Logs, KPI Alerts, Usage anomalies, Usage alert rules, Reports, Scheduled Reports, Campaign analytics, SMS Click-Through, Link Tracking, Deliverability, Conversion Goals, Attribution, Marketing mix model, Surveys, AI Containment, Per-language AI quality, Conversation Intelligence, Contact Reasons, Topic Intelligence, Sentiment, Journey Paths, High-friction sessions, Search Analytics — renders for every member, including viewers. Writes on alert rules stay with owner/admin/developer at the API; the read views are open. The full worked examples per seat are on the hub overview's [Role-specific views](/insights/overview#role-specific-views).

## Export — three shapes, one per purpose

* **Ad-hoc snapshot (CSV/PDF).** The **Reports** tile generates a report in the viewer toolbar — use it when a stakeholder asks for the numbers once.
* **Scheduled snapshot.** The **Scheduled Reports** tile emails the same reports on a cadence to a recipient list — use it when the ask repeats weekly.
* **API / BI snapshot.** Every tile's surface resolves over the [Insights API](/api-reference/insights) as JSON, so the same view lands in Tableau, Power BI, Looker, Superset, or Metabase through the [CDP BI-tool connectors](/guides/cdp-bi-connectors).

## Troubleshooting

Two failure modes recur on the comparison and cohort families:

* **Attribution returns nothing, or everything lands in `unattributed_conversions`.** A conversion with zero in-window touchpoints surfaces as unattributed, not dropped. If the share is large, sends are dropping the stitchable id (`contact_id` or `anonymous_id`) before the touchpoint lands — stamp the id at send time. Widen the lookback before changing the tracking plan: attribution joins per conversion across `lookback_days` (1–365, default 30).
* **Funnel and attribution totals diverge.** The funnel counts events in its own window; attribution joins conversions against a per-conversion lookback — the scopes differ by design. When two stakeholders quote different numbers, align on model + lookback first, not on which tile is "right."

Per-tile misreads — undefined CTR denominators, stale rollups, window-label mismatches — sit in each tile's linked guide from the [Section map](/insights/overview#section-map).

## See also

* [Insights hub overview](/insights/overview) — the entry page through the same grid, with the role-specific worked examples
* [SMS click-through](/insights/sms-ctr) — the per-campaign and per-queue CTR definition page
* [Campaign analytics](/insights/campaign-analytics) — per-campaign performance reading
* [Insights dashboards](/guides/insights-dashboards) — the analysis surface the hub aggregates
* [KPI alerts](/guides/kpi-alerts) — full alert mechanics behind the pin step