Skip to main content
Cette page est la référence de champs pour créer un widget à la main dans les tableaux de bord personnalisés — les données que vous pouvez utiliser, comment les visualiser, et comment les filtrer.

​
Sources de données

​
Visualisations

Toutes les visualisations ne s’appliquent pas à toutes les sources — l’éditeur de widget ne propose que les combinaisons pertinentes pour la source choisie. Par exemple, Calls prend en charge Number, Line, Area, Bar, Donut, Pie et Table ; Campaigns prend en charge Number, Bar et Funnel ; Usage and cost ne prend en charge que les vues basées sur le temps (Number, Line, Area).

​
Agrégations

L’éditeur ne propose que les agrégations pertinentes pour votre sélection :
  • Les visualisations par catégorie (Bar, Donut, Pie, Funnel, Table) comptent toujours des enregistrements.
  • Sum ou Average — Duration et Cost des appels, Conversation cost, Conversation minutes.
  • Sum uniquement — Calls made, Completed leads, Knowledge chunks.
  • Average uniquement — Successful calls (un taux de réussite) et Evaluation score.
  • Tout le reste compte des enregistrements.

​
Regroupement et filtrage

  • Group by répartit un agrégat en une tendance ou en un ensemble de catégories. Calls peut être regroupé par Date, Assistant, Campaign, Status, Direction, Sentiment, Success ou Post-call outcome ; Campaigns, Bookings, Knowledge sources et Simulations se regroupent par statut (Bookings peut aussi se regrouper par source) ; Usage and cost ne propose aucun regroupement.
  • Filters restreignent un seul widget sans toucher au reste du tableau de bord. Ils sont disponibles pour la source Calls, sur les champs à valeurs fixes — Status, Direction, Sentiment et Success —, et le seul opérateur disponible aujourd’hui est is (une correspondance exacte) : un widget de conversations en direct filtre ainsi Status is In progress.
  • Date range définit la fenêtre temporelle : 7, 14, 30 ou 90 derniers jours, avec une comparaison facultative à la période immédiatement précédente de même durée.
  • Assistant scope et Campaign scope limitent un widget à un seul assistant ou à une seule campagne. Assistant scope s’applique aux sources Calls et Usage ; Campaign scope s’applique aussi à Campaigns.

​
API et MCP

Les widgets sont entièrement scriptables via l’API publique — utile pour créer ou migrer des tableaux de bord de façon programmatique. Le schéma accepte quelques valeurs de plus que ce que propose aujourd’hui l’éditeur intégré au produit ; un widget construit sur une combinaison que le tableau de bord ne peut pas afficher montre à sa place une courte note invitant à le modifier et à choisir une combinaison prise en charge — tenez-vous-en donc aux combinaisons ci-dessus. Un widget (POST/PATCH /api/v1/dashboards/{id}/widgets[/{widgetId}], portée dashboards:write) comporte :
  • widget_type — statistic, chart ou table (la forme générale ; visualization précise le style de graphique exact au sein de cette forme)
  • visualization — auto, number, line, area, bar, stacked_bar, donut, pie, funnel, heatmap, table ou leaderboard
  • data_table — la source de données (calls, campaigns, assistants, leads, bookings, knowledge_bases, simulations, tools, phone_numbers, conversions)
  • aggregation — count, sum, avg, max ou min (max et min sont aujourd’hui réservés à l’API)
  • column_name / group_by — le champ à agréger ou à regrouper
  • conditions — jusqu’à 20 filtres, chacun composé d’un champ, d’un opérateur (par défaut equals) et d’une valeur
  • compare_previous_period, rate_range (7d/14d/30d/90d), show_legend, show_values
  • grid_w (3–12) / grid_h (1–4) — la taille de mise en page au sein du tableau de bord
MCP : create_dashboard_widget, update_dashboard_widget, remove_dashboard_widget, list_dashboard_widgets. Consultez la référence de l’API pour le schéma complet des widgets.