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

# Widgets del panel

> Referencia de fuentes de datos, visualizaciones, agregaciones y filtros de los widgets

Esta página es la referencia de campos para crear un widget a mano en [Paneles personalizados](/es/analytics/custom-dashboards) — de qué datos puedes partir, cómo visualizarlos y cómo filtrarlos.

## Fuentes de datos

| Fuente                | Cubre                                                                                              | Medidas que puedes agregar              |
| --------------------- | -------------------------------------------------------------------------------------------------- | --------------------------------------- |
| **Calls**             | Llamadas telefónicas, sesiones de voz web y de avatar, chat en vivo del widget, y voz por WhatsApp | Calls, Duration, Cost, Successful calls |
| **Assistants**        | Recuento de conversaciones por asistente                                                           | Assistants                              |
| **Campaigns**         | Datos de entrega y embudo de campaña                                                               | Campaigns, Calls made, Completed leads  |
| **Usage and cost**    | Gasto de créditos a lo largo del tiempo                                                            | Conversation cost, Conversation minutes |
| **Simulations**       | Ejecuciones de prueba de asistentes y sus resultados                                               | Simulation runs, Evaluation score       |
| **Bookings**          | Reservas de calendario creadas por tus asistentes                                                  | Bookings                                |
| **Knowledge sources** | Estado de los documentos y fuentes de rastreo de la base de conocimientos                          | Documents, Knowledge chunks             |

## Visualizaciones

| Visualización       | Ideal para                                                               |
| ------------------- | ------------------------------------------------------------------------ |
| **Number**          | Una cifra principal — un total, una tasa, un promedio                    |
| **Line**            | Una tendencia a lo largo del tiempo                                      |
| **Area**            | Una tendencia a lo largo del tiempo, con el volumen debajo resaltado     |
| **Bar**             | Comparar una métrica entre categorías (asistentes, campañas, estados)    |
| **Donut** / **Pie** | La proporción de un total (mezcla de resultados, reparto de sentimiento) |
| **Funnel**          | Progreso a través de etapas ordenadas (asignado → llamado → completado)  |
| **Table**           | Detalle fila a fila en lugar de un único agregado                        |

No todas las visualizaciones se aplican a todas las fuentes — el editor de widgets solo ofrece las combinaciones que tienen sentido para la fuente elegida. Por ejemplo, Calls admite Number, Line, Area, Bar, Donut, Pie y Table; Campaigns admite Number, Bar y Funnel; Usage and cost admite solo las vistas basadas en tiempo (Number, Line, Area).

## Agregaciones

| Agregación  | Qué calcula                                                              |
| ----------- | ------------------------------------------------------------------------ |
| **Count**   | Cuántos registros coinciden                                              |
| **Sum**     | Total de una medida numérica (por ejemplo, duración total o coste total) |
| **Average** | Media de una medida numérica                                             |

El editor solo ofrece las agregaciones que tienen sentido para lo elegido:

* Las visualizaciones de tipo categoría (Bar, Donut, Pie, Funnel, Table) siempre cuentan registros.
* **Sum or Average** — Duration y Cost (de Calls), Conversation cost, Conversation minutes.
* **Sum only** — Calls made, Completed leads, Knowledge chunks.
* **Average only** — Successful calls (una tasa de éxito) y Evaluation score.
* El resto cuenta registros.

## Agrupación y filtros

* **Group by** divide un agregado en una tendencia o un conjunto de categorías. Calls puede agruparse por Date, Assistant, Campaign, Status, Direction, Sentiment, Success o Post-call outcome; Campaigns, Bookings, Knowledge sources y Simulations se agrupan por status (Bookings también puede agruparse por source); Usage and cost no tiene agrupación.
* **Filters** acota un widget sin afectar al resto del panel. Están disponibles en la fuente Calls, en los campos con un conjunto fijo de valores — Status, Direction, Sentiment y Success — y hoy el único operador es **is** (una coincidencia exacta), así que un widget de conversaciones en vivo filtra Status **is** In progress.
* **Date range** define la ventana temporal: últimos 7, 14, 30 o 90 días, con una comparación opcional respecto al periodo inmediatamente anterior de la misma duración.
* **Assistant scope** y **Campaign scope** limitan un widget a un asistente o una campaña. Assistant scope se aplica a las fuentes Calls y Usage and cost; campaign scope también se aplica a Campaigns.

## API y MCP

Los widgets se pueden crear y modificar por completo mediante la API pública — útil para construir o migrar paneles mediante programación. El esquema admite algunos valores más de los que ofrece hoy el editor del producto; un widget creado con una combinación que el panel no puede representar muestra en su lugar una breve nota pidiéndote que lo edites y elijas una combinación compatible, así que limítate a las combinaciones anteriores. Un widget (`POST/PATCH /api/v1/dashboards/{id}/widgets[/{widgetId}]`, alcance `dashboards:write`) tiene:

* `widget_type` — `statistic`, `chart` o `table` (la forma general; `visualization` define el estilo de gráfico concreto dentro de ella)
* `visualization` — `auto`, `number`, `line`, `area`, `bar`, `stacked_bar`, `donut`, `pie`, `funnel`, `heatmap`, `table` o `leaderboard`
* `data_table` — la fuente de datos (`calls`, `campaigns`, `assistants`, `leads`, `bookings`, `knowledge_bases`, `simulations`, `tools`, `phone_numbers`, `conversions`)
* `aggregation` — `count`, `sum`, `avg`, `max` o `min` (`max` y `min` solo están disponibles mediante la API por ahora)
* `column_name` / `group_by` — qué campo agregar o por cuál agrupar
* `conditions` — hasta 20 filtros, cada uno con un campo, un operador (por defecto `equals`) y un valor
* `compare_previous_period`, `rate_range` (`7d`/`14d`/`30d`/`90d`), `show_legend`, `show_values`
* `grid_w` (3–12) / `grid_h` (1–4) — tamaño del diseño dentro del panel

MCP: `create_dashboard_widget`, `update_dashboard_widget`, `remove_dashboard_widget`, `list_dashboard_widgets`. Consulta la [referencia de la API](/es/api-reference/introduction) para el esquema completo del widget.