- 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
- Notifications de seuil 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 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 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 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. 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 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 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 à
OKdepuisIN_ALARM, une notification supplémentaire*_resolvedpeut être envoyée (si activée).
ÉTAT PAR DÉFAUT POUR LES NOTIFICATIONS DE SEUILL’é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é.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.ended7 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.