Skip to main content
Diese Seite ist die Feldreferenz, um ein Widget in Benutzerdefinierten Dashboards von Hand zu bauen – welche Daten du abrufen kannst, wie du sie visualisierst und wie du sie filterst.

​
Datenquellen

​
Visualisierungen

Nicht jede Visualisierung passt zu jeder Quelle – der Widget-Editor bietet nur die Kombinationen an, die für die gewählte Quelle sinnvoll sind. Calls unterstützt beispielsweise Number, Line, Area, Bar, Donut, Pie und Table; Campaigns unterstützt Number, Bar und Funnel; Usage and cost unterstützt nur die zeitbasierten Ansichten (Number, Line, Area).

​
Aggregationen

Der Editor bietet nur die Aggregationen an, die für deine Auswahl sinnvoll sind:
  • Kategorie-Visualisierungen (Bar, Donut, Pie, Funnel, Table) zählen immer Datensätze.
  • Sum oder Average – Call Duration und Cost, Conversation cost, Conversation minutes.
  • Nur Sum – Calls made, Completed leads, Knowledge chunks.
  • Nur Average – Successful calls (eine Erfolgsrate) und Evaluation score.
  • Alles andere zählt Datensätze.

​
Gruppierung und Filterung

  • Group by teilt ein Aggregat in einen Trend oder eine Reihe von Kategorien auf. Calls kann nach Date, Assistant, Campaign, Status, Direction, Sentiment, Success oder Post-call outcome gruppiert werden; Campaigns, Bookings, Knowledge sources und Simulations gruppieren nach Status (Bookings zusätzlich nach Source); Usage and cost hat keine Gruppierung.
  • Filters grenzen ein einzelnes Widget ein, ohne den Rest des Dashboards zu beeinflussen. Sie stehen für die Quelle Calls zur Verfügung, für die Felder mit einer festen Werteliste – Status, Direction, Sentiment und Success –, und der einzige Operator ist derzeit is (eine exakte Übereinstimmung): Ein Widget für laufende Gespräche filtert also Status is In progress.
  • Date range legt das Zeitfenster fest: letzte 7, 14, 30 oder 90 Tage, optional mit Vergleich zum unmittelbar vorangegangenen Zeitraum gleicher Länge.
  • Assistant scope und Campaign scope begrenzen ein Widget auf einen Assistenten oder eine Kampagne. Assistant scope gilt für die Quellen Calls und Usage; Campaign scope zusätzlich für Campaigns.

​
API und MCP

Widgets lassen sich vollständig über die öffentliche API skripten – nützlich, um Dashboards programmatisch zu bauen oder zu migrieren. Das Schema akzeptiert einige Werte mehr, als der Editor im Produkt heute anbietet; ein Widget, das auf einer Kombination basiert, die das Dashboard nicht darstellen kann, zeigt an seiner Stelle einen kurzen Hinweis, es zu bearbeiten und eine unterstützte Kombination zu wählen – halte dich also an die obigen Kombinationen. Ein Widget (POST/PATCH /api/v1/dashboards/{id}/widgets[/{widgetId}], Scope dashboards:write) hat:
  • widget_type – statistic, chart oder table (die grobe Form; visualization legt den konkreten Diagrammstil innerhalb dieser Form fest)
  • visualization – auto, number, line, area, bar, stacked_bar, donut, pie, funnel, heatmap, table oder leaderboard
  • data_table – die Datenquelle (calls, campaigns, assistants, leads, bookings, knowledge_bases, simulations, tools, phone_numbers, conversions)
  • aggregation – count, sum, avg, max oder min (max und min derzeit nur über die API)
  • column_name / group_by – welches Feld aggregiert oder gruppiert wird
  • conditions – bis zu 20 Filter, jeweils ein Feld, ein Operator (Standard equals) und ein Wert
  • compare_previous_period, rate_range (7d/14d/30d/90d), show_legend, show_values
  • grid_w (3–12) / grid_h (1–4) – Layout-Größe innerhalb des Dashboards
MCP: create_dashboard_widget, update_dashboard_widget, remove_dashboard_widget, list_dashboard_widgets. Das vollständige Widget-Schema findest du in der API-Referenz.