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

# Natural-language dashboards

> Turn a plain-language analytics question into reviewable dashboard insights

Natural-language dashboards let you describe an analytics view in everyday language. Famulor prepares a preview, and nothing is added to your dashboard until you confirm it.

## Build a dashboard view

1. Open a [custom dashboard](/analytics/custom-dashboards).
2. Select **Create with Milian**.
3. Describe the metrics, time range, comparison, and filters you need.
4. Select **Preview insights** and review every proposed card.
5. Select **Add insights** to save the cards.

For example:

> Show success rate and average duration for outbound calls in the last 30 days.

Generated cards work like manually created [dashboard widgets](/analytics/dashboard-widgets). You can edit, resize, reorder, or remove them afterward.

## Supported questions

You can ask about conversation volume, activity over time, success rate, call duration, assistant and campaign performance, outcomes, status, direction, sentiment, and recent conversations. Supported time ranges include 7, 14, 30, and 90 days, with optional comparison to the previous period.

Filters use the values available in Famulor. If a request cannot be represented, the preview explains what to change instead of adding an uncertain result.

<Note>
  Dashboards always use data from the active workspace. Preview every proposed card before adding it, especially when your question contains several filters.
</Note>

## Public API

Use `POST /api/v1/dashboards/{id}/natural-language` to generate a preview. Send the returned plan to `PUT /api/v1/dashboards/{id}/natural-language` to validate and save its widgets.

Both operations require the `dashboards:write` scope. See the API reference for the complete request and response schema.