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

# Ask your data — natural-language questions on Analytics

> Operator guide to the Ask your data panel on the Insights → Analytics page: type a plain-English question about your messaging, voice, and contact metrics and get an instant answer over the window you asked about, with a chart where one exists.

# Ask your data — natural-language questions on Analytics

**Insights → Analytics** (`/insights/analytics`) carries an **Ask your data** panel below the KPI cards. Type a plain-English question about your own communication metrics — "What's my delivery rate?", "How many calls did we handle?", "How much did we spend?" — and the panel answers in one sentence over the date window you actually asked about, with a small trend chart when the metric has a daily series to chart.

The panel is a reading aid over the same numbers the page already shows: the answer is computed from the same metric snapshot that backs the KPI cards beside it, so the sentence can never disagree with the figures around it. It never touches your data with a language model, and every question is answered in your browser — nothing is sent to a third-party model or a new API surface.

## How questions resolve

Three things happen when you type a question and click **Ask**:

1. **The metric is detected.** The question is matched against the answerable metric catalogue (below). "How many messages did we deliver this week?" resolves to the delivered count; "what's my delivery rate?" resolves to the delivery rate. If nothing recognizable names a metric, the panel answers with your overall message volume and shows an "I wasn't sure which metric you meant" hint alongside the answer — name a metric (messages, delivery rate, calls, talk time, contacts, or spend) to get a specific answer.
2. **The window is detected.** A question can name its own date window. When it does, and that window differs from the one currently selected, the page's date filter pivots to match the question, and the answer is computed over the period you asked about. The presets a question can name are the ones on the page's filter: today / yesterday and the last 24 hours, this week and the last 7 days, this month and the last 30 days, this quarter and the last 90 days, this year, the last 12 months, and year to date. A custom day count the presets can't express — "last 20 days", "past 85 days" — clamps the filter's custom calendar range to that span instead.
3. **The answer is rendered.** One sentence, over the resolved window, phrased in the human label for that window ("You sent 12,480 messages across all channels over the last 30 days."). Answers are screen-reader announced through a live region, and the example chips remain clickable while data loads — on a slow window the panel shows a loading indicator and resolves the answer the moment the snapshot arrives.

## Anatomy of an answer

An answer has up to two parts:

* **The sentence** — the headline number with its unit (count, percent, minutes, or your billing currency) and the window label, followed by the "name a metric" hint only when the question didn't match one.
* **The governed chart** — when the question resolves to overall message volume, the answer is accompanied by a compact area chart of message volume by day, built from the same daily per-channel series as the page's big message-volume chart. The chart ships with an accessible text summary (the total across the days shown) underneath it. Metrics that have no daily series on the page — delivery rate, voice, contacts, and spend — stay text-only, so a chart never shows a number the rest of the dashboard doesn't already show.

## Example questions

The panel seeds the input with example chips; each of these is a ready-made prompt:

* "How many messages did we send?"
* "What's my delivery rate?"
* "How many calls did we handle?"
* "How much did we spend?"

Useful phrasings beyond the chips:

| You type                                        | The panel reports                         |
| ----------------------------------------------- | ----------------------------------------- |
| "How many messages did we deliver this week?"   | delivered count, over a 7-day window      |
| "How many messages failed this month?"          | failed count, over a 30-day window        |
| "What's my deliverability today?"               | delivery rate, over the last 24 hours     |
| "How many customers were active this quarter?"  | active contacts, over a 90-day window     |
| "How much talk time did we use this year?"      | call minutes, over a 12-month window      |
| "How much did we spend on voice?"               | voice spend, in your billing currency     |
| "What did voice cost us over the last 20 days?" | voice spend, over a clamped 20-day window |

## Which metrics are answerable

Nine metrics, spanning volume, delivery, voice, contacts, and cost:

| Metric             | You ask about                                          | Unit                  |
| ------------------ | ------------------------------------------------------ | --------------------- |
| Message volume     | messages, SMS, texts, WhatsApp, RCS, volume, sent      | count                 |
| Delivered messages | delivered anything                                     | count                 |
| Failed messages    | failures, undelivered, bounces, rejections             | count                 |
| Delivery rate      | delivery rate, deliverability, delivery percentage     | percent               |
| Calls              | calls, phone, voice, dialing                           | count                 |
| Talk time          | minutes, talk time, call duration, airtime             | minutes               |
| Voice spend        | voice cost, call cost, spend on voice                  | your billing currency |
| Active contacts    | contacts, audience, customers, subscribers, recipients | count                 |
| Total spend        | spend, cost, bill, charges, budget                     | your billing currency |

Anything richer — per-carrier and per-country breakdowns, error-code histograms, cohort curves, channel-level splits, or saving the view — is the territory of the [custom dashboard builder](/guides/insights-dashboard-builder), which composes the same underlying endpoints into widgets you can share and embed.

## Limits

* **The window is bounded by the page itself.** Questions are answered in your browser from the metric snapshot the Analytics page has already loaded for the selected window. A question can't reach past the 12-month ceiling of the page's date filter; for longer windows use the [Insights API](/api-reference/insights) or the dashboard builder.
* **Deterministic, not conversational.** The panel maps one question to one metric and one window. It doesn't follow up, and it doesn't infer intent beyond the pattern catalogue above — if a question is outside that vocabulary you get overall message volume with the "name a metric" hint.
* **No new data surface.** Because answers reuse the page's existing snapshot, asking a question never triggers a reload or exposes data outside your tenant.