> ## 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.

# Widgets de tableau de bord

> Référence des sources de données, visualisations, agrégations et filtres pour les widgets

Cette page est la référence de champs pour créer un widget à la main dans les [tableaux de bord personnalisés](/fr/analytics/custom-dashboards) — les données que vous pouvez utiliser, comment les visualiser, et comment les filtrer.

## Sources de données

| Source                | Couvre                                                                                                  | Mesures agrégeables                     |
| --------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| **Calls**             | Appels téléphoniques, sessions vocales et avatar sur le web, chat en direct du widget, et voix WhatsApp | Calls, Duration, Cost, Successful calls |
| **Assistants**        | Nombre de conversations par assistant                                                                   | Assistants                              |
| **Campaigns**         | Données de diffusion et d’entonnoir de campagne                                                         | Campaigns, Calls made, Completed leads  |
| **Usage and cost**    | Consommation de crédits dans le temps                                                                   | Conversation cost, Conversation minutes |
| **Simulations**       | Exécutions de tests d’assistant et leurs résultats                                                      | Simulation runs, Evaluation score       |
| **Bookings**          | Réservations de calendrier créées par vos assistants                                                    | Bookings                                |
| **Knowledge sources** | Santé des documents et des sources d’exploration de la base de connaissances                            | Documents, Knowledge chunks             |

## Visualisations

| Visualisation       | Idéal pour                                                                      |
| ------------------- | ------------------------------------------------------------------------------- |
| **Number**          | Un seul chiffre clé — un total, un taux, une moyenne                            |
| **Line**            | Une tendance dans le temps                                                      |
| **Area**            | Une tendance dans le temps, avec le volume sous-jacent mis en valeur            |
| **Bar**             | Comparer une mesure entre plusieurs catégories (assistants, campagnes, statuts) |
| **Donut** / **Pie** | Une part d’un total (répartition des résultats, répartition du sentiment)       |
| **Funnel**          | La progression à travers des étapes ordonnées (assigné → appelé → terminé)      |
| **Table**           | Le détail ligne par ligne plutôt qu’un agrégat unique                           |

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

| Agrégation  | Ce qu’elle calcule                                                             |
| ----------- | ------------------------------------------------------------------------------ |
| **Count**   | Le nombre d’enregistrements correspondants                                     |
| **Sum**     | Le total d’une mesure numérique (par exemple la durée totale ou le coût total) |
| **Average** | La moyenne d’une mesure numérique                                              |

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](/fr/api-reference/introduction) pour le schéma complet des widgets.