Zum Hauptinhalt springen
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.
  • Minimum oder Maximum – nur für Post-Call-Zahlenfelder.
  • 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.

​
Post-Call-Analysefelder

Jeder Assistent kann nach jedem Anruf eigene Felder auswerten – etwa einen Anrufgrund, einen Rückrufwunsch oder eine Zufriedenheitsnote. Du legst sie im Tab Analysis des Assistenten an. Die Felder aller Assistenten deines Workspaces stehen in der Quelle Calls zur Verfügung und erscheinen im Widget-Editor unter Post-call analysis:
  • Group by nach einem Text-, Auswahl-, Zahlen- oder Ja/Nein-Feld zeigt dessen Werte als Bar-, Donut- oder Pie-Diagramm. Das Diagramm zeigt die 12 häufigsten Werte, dann Other und Not captured für Anrufe, deren Assistent das Feld auswertet, aber keinen Wert erfasst hat.
  • Metric zeigt ein Zahlen- oder Ja/Nein-Feld als Number-Karte. Zahlenfelder unterstützen Average, Sum, Minimum, Maximum und Anrufe mit Wert. Ja/Nein-Felder zeigen den Anteil „Ja“ unter den Anrufen, bei denen das Feld erfasst wurde, oder die Zahl der Anrufe mit „Ja“.
  • Filters grenzen ein Calls-Widget auf einen Wert eines Felds ein, zum Beispiel Anrufgrund is Reklamation. Ja/Nein-Felder bieten Ja und Nein, Auswahlfelder ihre Auswahlwerte, andere Felder übernehmen den eingegebenen Wert. Groß- und Kleinschreibung spielt keine Rolle.
  • Table-Insights der Quelle Calls zeigen bis zu sechs Post-Call-Felder als zusätzliche Spalten neben jedem Anruf – zum Beispiel eine Rückrufliste mit Name, Nummer und Anrufgrund. Du wählst sie im Widget-Editor unter Post-Call-Spalten.
Ein Feld zählt nur Anrufe von Assistenten, die es auswerten – ein Feld, das nur ein Assistent nutzt, wird also nicht durch die Anrufe anderer Assistenten verwässert. Felder mit strukturierten Daten wie Listen oder Objekten lassen sich nicht als Diagramm darstellen. Gleichnamige Felder mehrerer Assistenten werden zusammengefasst.

​
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 gelten für Post-Call-Zahlenfelder)
  • column_name / group_by – welches Feld aggregiert oder gruppiert wird; post_call:<key> für ein Post-Call-Analysefeld
  • conditions – bis zu 20 Filter, jeweils ein Feld, ein Operator (Standard equals) und ein Wert; post_call:<key> filtert nach einem Post-Call-Analysefeld
  • 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
Post-Call-Werte liest du mit GET /api/v1/dashboards/{id}/analytics und post_call_fields (kommagetrennte Keys, bis zu 12), optional mit post_call_filter=key=value (wiederholbar, bis zu 10). Die Antwort listet die Felder deines Workspaces unter context.post_call_fields und ihre Werte unter post_call. CLI: famulor get-dashboard-analytics <id> --post-call-fields anrufgrund,rueckruf. MCP: get_dashboard_analytics. MCP: create_dashboard_widget, update_dashboard_widget, remove_dashboard_widget, list_dashboard_widgets. Das vollständige Widget-Schema findest du in der API-Referenz.