Skip to main content
Esta página es la referencia de campos para crear un widget a mano en Paneles personalizados — de qué datos puedes partir, cómo visualizarlos y cómo filtrarlos.

​
Fuentes de datos

​
Visualizaciones

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

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 para el esquema completo del widget.