> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tableaux de bord personnalisés

> Créez vos propres tableaux de bord analytiques à partir des données en direct de votre espace de travail

Un tableau de bord personnalisé réunit sur un seul écran les chiffres qui comptent pour vous — volume d’appels, performance des assistants, résultats de campagnes, conversion en réservations, et plus encore —, au lieu de devoir les rassembler en naviguant entre plusieurs pages. Chaque tableau de bord est composé de **widgets**, et vous contrôlez ce que chacun d’eux affiche. La disponibilité dépend de la fonctionnalité **Custom dashboards** de votre forfait.

<Note>
  Vous préférez décrire ce que vous voulez en langage courant ? Sélectionnez **Create with Milian** sur n’importe quel tableau de bord — les [tableaux de bord en langage naturel](/fr/analytics/natural-language-dashboards) transforment une question écrite en un ensemble de widgets prévisualisables que vous pouvez ajouter en une seule fois : la façon la plus rapide d’obtenir un premier tableau de bord. Cette page explique comment créer et modifier des widgets manuellement.
</Note>

## Créer un tableau de bord

Les tableaux de bord personnalisés n’ont pas de page d’index propre — chacun dispose de sa propre icône dans la barre latérale. Sélectionnez le **+** (New dashboard) en bas de cette section, donnez un nom au tableau de bord, et vous y accédez directement.

Un nouveau tableau de bord démarre avec la vue d’ensemble intégrée : filtres du tableau de bord, chiffres clés (conversations, taux d’achèvement, durée moyenne, taux de réussite, dépense de conversation), activité d’appels, répartition des résultats, performance des assistants, intelligence post-appel, entonnoir de campagne, une carte de portée client, les appels récents, et une rangée de cartes de modules renvoyant aux domaines inclus dans votre forfait. Chaque élément est facultatif — voir **Modifier la disposition** ci-dessous pour retirer des sections ou vider entièrement la vue d’ensemble.

## Ajouter un widget

Sélectionnez **Add insight** pour ouvrir l’éditeur de widget. Vous pouvez :

* **Start from a recommended insight** — des widgets prêts à l’emploi couvrant les questions courantes (ci-dessous), déjà préremplis avec une source, une visualisation et un regroupement pertinents. Les modèles nécessitant une fonctionnalité de forfait que vous n’avez pas s’affichent comme **Locked**.
* **Build from scratch** — nommez le widget, puis choisissez une source de données, une visualisation et un mode d’agrégation. Consultez [Widgets de tableau de bord](/fr/analytics/dashboard-widgets) pour la référence complète de ce qui est disponible à chaque étape.

| Modèle                | Affiche                                                                                     | Nécessite          |
| --------------------- | ------------------------------------------------------------------------------------------- | ------------------ |
| Conversation activity | Volume d’appels dans le temps, comparé à la période précédente                              | —                  |
| Assistant performance | Volume de conversations par assistant                                                       | —                  |
| Outcome mix           | Résultats d’appels réussis, échoués et inconnus                                             | Analyse post-appel |
| Campaign funnel       | Progression de campagne, des prospects assignés aux appels passés jusqu’aux appels terminés | Campagnes          |
| Live conversations    | Appels actuellement en cours                                                                | Suivi en direct    |
| Simulation quality    | Tests réussis et échecs d’évaluation récurrents                                             | Simulations        |
| Booking conversion    | Comment les conversations se transforment en réservations confirmées                        | Réservation        |
| Knowledge health      | Sources de connaissances obsolètes, en échec ou saines                                      | Knowledge          |

Vos propres widgets figurent sous **Custom insights**, sous la vue d’ensemble. Un nouveau widget atterrit à la fin de ce groupe ; déplacez-le où vous le souhaitez depuis le mode Customize (voir ci-dessous).

## Modifier la disposition

Sélectionnez **Customize** pour passer en mode édition. Le nom du tableau de bord devient modifiable, et chaque widget dispose de ses propres commandes :

* **Edit** rouvre l’éditeur de widget pour modifier sa source, sa visualisation, ses filtres ou son nom.
* **Width** définit la portion de la rangée occupée par le widget — un quart, un tiers, la moitié, deux tiers ou la pleine largeur.
* **Move left / right** le repositionne parmi vos autres widgets.
* **Remove** le retire du tableau de bord, après confirmation. Le reconstruire plus tard signifie ajouter à nouveau l’insight — notez donc ses réglages au préalable s’il était complexe à paramétrer.

Les sections de la vue d’ensemble intégrée disposent de leur propre commande **Remove** en mode personnalisation. **Restore removed** les restaure, **Start blank** vide entièrement la vue d’ensemble pour ne garder que vos propres widgets, et **Restore overview** la rétablit.

Sélectionnez **Done** pour quitter le mode édition. Les modifications de disposition s’enregistrent automatiquement au fur et à mesure.

<Warning>
  Supprimer un tableau de bord (l’icône de corbeille, en mode Customize) est définitif. Le tableau de bord, sa disposition et les insights que vous y avez organisés disparaissent, sans possibilité d’annulation.
</Warning>

## Filtrer un tableau de bord

La barre de filtres en haut d’un tableau de bord s’applique à tout ce qui se trouve en dessous : une période (7, 14, 30 ou 90 derniers jours, ou une période personnalisée), ainsi que le sens, le statut, le résultat, le sentiment, les assistants et les campagnes. Ces filtres s’ajoutent à la configuration propre de chaque widget, ce qui permet de réutiliser les mêmes widgets entre une vue « 7 derniers jours » et une vue « 90 derniers jours » sans avoir à les reconstruire.

## API et MCP

Les tableaux de bord et leurs widgets se gèrent entièrement via l’API publique : `GET/POST /api/v1/dashboards`, `GET/PATCH/DELETE /api/v1/dashboards/{id}`, `GET/POST /api/v1/dashboards/{id}/widgets`, et `PATCH/DELETE /api/v1/dashboards/{id}/widgets/{widgetId}` (portée `dashboards:write`). L’API expose aussi `GET /api/v1/dashboards/{id}/analytics` pour les données calculées derrière un tableau de bord. MCP : `list_dashboards`, `get_dashboard`, `create_dashboard`, `update_dashboard`, `delete_dashboard`, `get_dashboard_analytics`, `list_dashboard_widgets`, `create_dashboard_widget`, `update_dashboard_widget`, `remove_dashboard_widget`. Consultez [Widgets de tableau de bord](/fr/analytics/dashboard-widgets) pour la référence des champs.
