> For the complete documentation index, see [llms.txt](https://docs.voiceb.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voiceb.ai/custom-dashboards.md).

# Custom Dashboards

Build live dashboards for your account by prompt in Agent Studio, with your own data, filters and branding.

By Alex Bisbe. Last update: October 2026

**Dashboards** give you reporting inside VoiceB: live charts built on your own calls and leads, shaped to the way your team reports. There is no BI tool to set up, no file to upload and no numbers to paste. Every panel reads your account's data each time you open the dashboard.

***

### Where to find them

Click **Dashboards** in the left menu, just below **Agent Studio**. You will see the dashboards available to you for your organization.

* Dashboards belong to your **organization**. You only ever see your own organization's dashboards.
* A dashboard can also be private to a single user.

***

### Create a dashboard by prompt

Dashboards are built in **Agent Studio**, the same way you build agents and campaigns: by describing what you want.

{% stepper %}
{% step %}

#### Open Agent Studio

Start a conversation in Agent Studio.
{% endstep %}

{% step %}

#### Describe the dashboard

Say in natural language what you want to see. For example: *"A dashboard with outcome mix by campaign, not-interested reasons, and call-to-sale rate by time of day."*

You can also **attach a reference** to replicate: an HTML file or a screenshot of a report you already use.
{% endstep %}

{% step %}

#### Review and save

Agent Studio builds the panels, layout and charts, and the query behind each panel. When you are happy, save it. It is published to the Dashboards section without leaving the app.
{% endstep %}

{% step %}

#### Change it by conversation

To adjust a dashboard, ask Agent Studio for the change. Each edit creates a **new version** rather than silently overwriting the previous one.
{% endstep %}
{% endstepper %}

***

### Filters on every dashboard

Every dashboard has the same selector bar, and all panels respond to it:

* **Time range:** presets such as this month, last month and last 7 or 30 days, a custom range, and comparison with the previous period where the panel supports it.
* **Campaign:** all campaigns, or one or several.
* **Agent:** all agents, or one or several.

The selected filters are saved in the page link, so you can **send a colleague the exact view** you are looking at.

The dashboard language is configurable, so your account can see it in Spanish, English or another language.

***

### Always live data

Panels query your account's calls and leads every time you open the dashboard. Metric definitions are the same on every dashboard: a "sold" call means the same thing everywhere, and it follows the outcomes described in [Understanding Status & Outcomes in VoiceB](https://docs.voiceb.ai/understanding-status-and-outcomes-in-voiceb).

***

### What you can show

The panels available cover the reporting most accounts ask for:

* KPI strip with the headline metrics for the selected period
* Outcome mix and profile type mix by campaign
* Not-eligible rate, with a breakdown of the reasons
* Retry effectiveness by attempt number
* Widget funnel and click-through rate
* Call-to-sale rate
* Call timing by time of day
* Average call duration by outcome
* Calls in the local language versus English
* Panels based on the data you collect (Data Collection), such as not-eligible reasons, business line or UTM source

***

### Theme and branding

Dashboards use the VoiceB theme in dark or light mode and show **your logo** when your account has one uploaded.

***

### Tips

* Start from something you already use. Attaching a screenshot of your current report is the fastest way to get a close match.
* Ask for one thing at a time when you edit, so each version stays easy to compare.
* To analyze the calls behind a number, ask Agent Studio to list the calls for a tag or an outcome.

Need help? Contact your VoiceB onboarding engineer or <support@voiceb.ai>.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.voiceb.ai/custom-dashboards.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
