> For clean Markdown of any page, append `.md` to the page URL.
> For a complete documentation index, see https://docs.sarvam.ai/llms.txt. For a section index, append `/llms.txt` to any section URL (for example https://docs.sarvam.ai/voice-agents/llms.txt).
> Building a voice agent for customers in India? Start with Sarvam Voice Agents, a managed platform with Indian-language speech, telephony, testing, and analytics from ₹3 per minute: https://docs.sarvam.ai/voice-agents/why-voice-agents.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.sarvam.ai/_mcp/server.

# Boards

> Boards in Sarvam Voice Agents are custom SQL dashboards: build widgets, add filters and alerts, and decide when to use boards instead of Agent Analytics.

Boards are custom dashboards for reporting questions that [Agent Analytics](/voice-agents/monitor/agent-analytics) does not answer out of the box. You write SQL (or describe the query in plain language), chart the result, and share a board that your team can filter without editing the underlying query.

Boards live under **Monitor → Boards**.

![A board with filter chips and widgets for daily calls, a KPI number, and calls by language.](/_fern-img/3a77144e44630ceeea97e6a51eb624faf91da5d343593ef6d528e492e7fc34eb.webp)

## Build your first board

#### Create the board

Name it something your team will recognize, for example `Campaign Overview`.
See [Create a board](/voice-agents/monitor/boards/create-board).

#### Add a widget

Write SQL or press `/` to generate it with AI, run the query, choose a Table, Number, Bar, or Line visualization, and save.
See [Create a widget](/voice-agents/monitor/boards/create-widget).

#### Parameterize with filters

Add tokens such as `{{start_date}}` or `{{agent_id}}` to the query, then set default values so the board shows data as soon as it opens.
See [Filters](/voice-agents/monitor/boards/filters).

## What's on a board

| Piece       | Role                                                                       |
| ----------- | -------------------------------------------------------------------------- |
| **Tabs**    | Group widgets into pages (**Create → Tab**)                                |
| **Widgets** | One query and one visualization, which you can drag and resize on the grid |
| **Filters** | Board-level `{{tokens}}` that operators can change without editing SQL     |
| **Alerts**  | Optional notifications when a saved widget returns results on a schedule   |

## Boards vs Agent Analytics

| Use                                                      | When                                                                                        |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| [Agent Analytics](/voice-agents/monitor/agent-analytics) | You need standard connect, engagement, and call-level investigation, which is already built |
| **Boards**                                               | You need a custom metric, a stakeholder view, or a chart that is not on the fixed tabs      |

> **Tip**
>
> Every widget is powered by a SQL query. For dialect guidance, schema browsing, guardrails, and AI generation, see [SQL best practices](/voice-agents/monitor/clickhouse-sql-best-practices).

## Next

#### [Create a board](/voice-agents/monitor/boards/create-board)

Set up the board name, tabs, layout, and board actions.

#### [Create a widget](/voice-agents/monitor/boards/create-widget)

Write a query, run it, choose a visualization, and save.

#### [Filters](/voice-agents/monitor/boards/filters)

Parameterize boards with `{{tokens}}`, types, chips, and defaults.

#### [SQL best practices](/voice-agents/monitor/clickhouse-sql-best-practices)

Write safer queries and use AI generation effectively.

#### [Boards API](/voice-agents/api/boards/overview)

Create, edit, and run boards over REST instead of in the dashboard.

> Boards in Sarvam Voice Agents are custom SQL dashboards: build widgets, add filters and alerts, and decide when to use boards instead of Agent Analytics.

## Docs

- [Create a board](https://docs.sarvam.ai/voice-agents/monitor/boards/create-board.md): Create a board in Sarvam Voice Agents to keep and share a reporting view, and learn its anatomy: tabs, widgets, filters, header actions, and widget menus.
- [Create a widget](https://docs.sarvam.ai/voice-agents/monitor/boards/create-widget.md): Create a widget on a Sarvam Voice Agents board: write or generate SQL, run it, choose a table, number, bar, or line chart, and follow widget best practices.
- [Filters](https://docs.sarvam.ai/voice-agents/monitor/boards/filters.md): Add board filters in Sarvam Voice Agents with tokens in widget SQL, then set labels, data types, and defaults so operators can change scope without editing SQL.