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

# Gérez votre cycle de vie client avec les notifications Metronome

Metronome vous permet de capter en temps réel l'activité des clients et les signaux contractuels grâce à un riche ensemble de notifications envoyées à vos webhooks configurés. Ces notifications peuvent vous aider à :

* **Offrir des expériences in-product opportunes** comme des messages d'intégration, des rappels d'expiration d'essai, ou la gestion de l'accès des clients après que des seuils d'utilisation sont atteints
* **Alimenter des workflows internes** comme notifier les ventes lorsqu'un contrat expire ou que l'engagement d'un client est épuisé, le plaçant en dépassement
* **Réduire les frictions client** en notifiant les clients avant des événements clés comme une expiration de crédit ou une date de renouvellement de contrat

Il existe trois types différents de notifications que vous pouvez recevoir de Metronome :

* **[Notifications de seuil](/fr/guides/customers-billing/set-up-notifications/threshold-notifications)** qui se déclenchent lorsque des conditions spécifiques sont atteintes, comme des dépenses dépassant un montant en dollars ou un montant de crédit disponible descendant en dessous d'un certain pourcentage
* **[Notifications système](/fr/guides/customers-billing/set-up-notifications/system-notifications)** qui se déclenchent lorsqu'un objet est créé ou mis à jour ou à des moments programmés, comme lorsqu'un contrat commence ou se termine
* **[Notifications décalées](/fr/guides/customers-billing/set-up-notifications/offset-notifications)** qui se déclenchent à des moments programmés tels que définis par une politique fixée par l'utilisateur, comme 7 jours avant l'expiration d'un engagement ou 3 jours après le début d'un contrat

## Comment fonctionnent les notifications

Les notifications Metronome sont livrées sous forme de [notifications webhook](/fr/guides/platform-configuration/setup-webhooks) au format JSON vers un point de terminaison que vous configurez. Ces notifications sont envoyées de manière asynchrone et sont conçues pour alimenter des workflows automatisés, la communication client et les opérations internes.

### Mécanique de livraison

* **Livraison par webhook** : tous les types de notifications sont envoyés sous forme de requêtes HTTPS POST.
* **Format standard** : toutes les charges utiles suivent un schéma JSON cohérent et incluent des données contextuelles comme `customer_id`, `timestamp`, et les champs d'objet pertinents.
* **Réessais fiables** : si le point de terminaison n'est pas disponible, Metronome réessaiera automatiquement la livraison en utilisant un backoff exponentiel avec jitter. Les réessais continuent jusqu'à 48 heures (ou jusqu'au succès).
* **Livraison au moins une fois** : vous pouvez recevoir des notifications en double ; les points de terminaison webhook doivent être idempotents.
* **Sécurité** : les charges utiles webhook incluent un en-tête de signature afin que vous puissiez vérifier l'origine

### Évaluation et planification

| **Notification** | **Délai**                                                                                                                                                                                                                                                                                                                          |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Seuil**        | *Émise lorsqu'une nouvelle utilisation ou donnée déclenche une condition de seuil.*<br />Le seuil est évalué au moins une fois toutes les trois minutes. Les notifications se déclenchent dans les 5 minutes suivant l'ingestion de l'utilisation qui déclenche le franchissement du seuil.                                        |
| **Système**      | *Émise au moment où l'événement se produit*<br />Les notifications sont générées en fonction de l'horodatage configuré de l'objet (par exemple, le début d'un contrat) ou de l'action (par exemple, contrat modifié) et sont livrées en temps quasi réel.                                                                          |
| **Décalée**      | *Émise au moment défini par la politique pour l'événement*<br />Les notifications sont générées en fonction de la politique définie par l'utilisateur associée à un événement particulier (par exemple, 3 jours après le début d'un segment d'engagement ou 4 jours avant la fin d'un contrat) et sont livrées en temps quasi réel |

### États des notifications

Les types de notifications dans Metronome se répartissent en deux modèles comportementaux : **sans état** et **avec état**.

**Les notifications système et décalées** sont sans état ; elles se déclenchent une fois à un moment planifié, comme lorsqu'un contrat se termine, et elles ne suivent pas les conditions ou transitions en cours.

**Les notifications de seuil** sont avec état ; elles sont continuellement évaluées et passent entre deux états : `OK` et `IN_ALARM`. Par exemple, une notification de solde d'engagement peut entrer dans l'état `IN_ALARM` lorsque le solde restant d'un client tombe sous 10 %, et revenir à `OK` une fois que de nouveaux crédits prépayés sont émis.

* Les états des notifications de seuil sont définis comme suit :
  * **EVALUATING :** le seuil n'a pas encore été évalué, généralement parce qu'un client vient d'être créé
  * **OK** : la condition n'a pas été atteinte
  * **IN\_ALARM** : la condition est activement atteinte
* Lorsqu'une notification de seuil revient à `OK` depuis `IN_ALARM`, une notification supplémentaire `*_resolved` peut être envoyée (si activée).

<Note>
  **ÉTAT PAR DÉFAUT POUR LES NOTIFICATIONS DE SEUIL**

  L'état par défaut des notifications de seuil dépend de la présence de données sous-jacentes. Par exemple, un client sans engagement actif serait dans un état `OK` pour les notifications de solde d'engagement jusqu'à ce qu'un engagement soit créé et consommé.
</Note>

## Bonnes pratiques

Pour tirer le meilleur parti des notifications Metronome, nous recommandons ce qui suit :

* **Utilisez les notifications système pour l'automatisation basée sur le temps.** Elles offrent un contrôle précis du cycle de vie client, vous notifiant lorsque des événements comme la création de contrats ou la fin d'engagements se produisent.
* **Exploitez les notifications de seuil pour une surveillance continue.** Définissez des seuils de dépense, d'utilisation et de crédit pour avertir ou rappeler aux clients avant qu'ils n'atteignent une limite. Donnez aux clients la possibilité d'activer leurs propres notifications (par exemple, lorsque leur solde est bas ou lorsque les dépenses franchissent un certain seuil) à des fins budgétaires.
* **Utilisez les notifications décalées pour des workflows proactifs.** Par exemple, déclenchez une notification `credit.segment.ended` 7 jours avant l'expiration des crédits pour encourager une utilisation supplémentaire.
* **Utilisez les champs personnalisés pour cibler des groupes clés de clients.** Créez des notifications uniquement pour vos clients entreprise ou ceux d'un niveau spécifique.
* **Rendez les points de terminaison idempotents.** Les webhooks sont réessayés en cas d'échec de livraison, donc vos systèmes doivent gérer les doublons en toute sécurité.
* **Enregistrez les livraisons de notifications.** Conserver un registre des livraisons aide à l'audit et au débogage des processus en aval.

## Notes supplémentaires

* Metronome prend actuellement uniquement en charge la livraison par webhook et toutes les notifications sont envoyées à tous les webhooks que vous avez configurés.
* Nous élargissons continuellement les types de notifications système et de seuil disponibles, afin que vous puissiez couvrir davantage de jalons de facturation et construire des workflows encore plus riches au fil du temps.