> ## Documentation Index > Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt > Use this file to discover all available pages before exploring further. # Dashboard-Widgets > Referenz für Widget-Datenquellen, Visualisierungen, Aggregationen und Filter Diese Seite ist die Feldreferenz, um ein Widget in [Benutzerdefinierten Dashboards](/de/analytics/custom-dashboards) von Hand zu bauen – welche Daten du abrufen kannst, wie du sie visualisierst und wie du sie filterst. ## Datenquellen | Quelle | Umfasst | Aggregierbare Kennzahlen | | --------------------- | --------------------------------------------------------------------------------- | --------------------------------------- | | **Calls** | Telefonanrufe, Web-Voice- und Avatar-Sessions, Widget-Livechat und WhatsApp-Voice | Calls, Duration, Cost, Successful calls | | **Assistants** | Gesprächszahlen je Assistent | Assistants | | **Campaigns** | Kampagnen-Delivery- und Funnel-Daten | Campaigns, Calls made, Completed leads | | **Usage and cost** | Guthabenverbrauch über die Zeit | Conversation cost, Conversation minutes | | **Simulations** | Testläufe und Ergebnisse von Assistenten | Simulation runs, Evaluation score | | **Bookings** | Über deine Assistenten erstellte Kalenderbuchungen | Bookings | | **Knowledge sources** | Zustand von Wissensdatenbank-Dokumenten und Crawl-Quellen | Documents, Knowledge chunks | ## Visualisierungen | Visualisierung | Am besten für | | ------------------- | ------------------------------------------------------------------------------------- | | **Number** | Eine Kennzahl – eine Summe, eine Rate, ein Durchschnitt | | **Line** | Einen Trend über die Zeit | | **Area** | Einen Trend über die Zeit, mit betontem Volumen darunter | | **Bar** | Eine Kennzahl über Kategorien hinweg vergleichen (Assistenten, Kampagnen, Status) | | **Donut** / **Pie** | Einen Anteil an einer Gesamtsumme (Ergebnis-Mix, Sentiment-Verteilung) | | **Funnel** | Fortschritt durch aufeinanderfolgende Phasen (zugewiesen → angerufen → abgeschlossen) | | **Table** | Detail auf Zeilenebene statt eines einzelnen Aggregats | 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 | Aggregation | Was sie berechnet | | ----------- | ----------------------------------------------------------------------------- | | **Count** | Wie viele Datensätze zutreffen | | **Sum** | Summe einer numerischen Kennzahl (zum Beispiel Gesamtdauer oder Gesamtkosten) | | **Average** | Mittelwert einer numerischen Kennzahl | 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](/de/api-reference/introduction).