Passer au contenu principal
Les notifications système surveillent le moment où des événements ou actions se produisent en fonction de l’horodatage configuré d’un objet (par exemple, le début d’un contrat) ou du moment où une action s’est produite (par exemple, contrat créé). Elles sont idéales pour les workflows d’automatisation basés sur le temps autour des événements clés du cycle de vie d’un client.

​
Types de notifications système

DIFFÉRENCES DE SCHÉMA DE CHARGE UTILELe schéma des charges utiles pour les notifications système diffère légèrement de celui des notifications de seuil. Plus précisément, la charge utile des notifications système n’inclut pas de champ properties. Assurez-vous que vos webhooks sont correctement configurés pour gérer les deux types de notifications.
TypeNomDétails
Contratcontract.createSe déclenche lorsqu’un nouveau contrat est créé
Contratcontract.startSe déclenche lorsqu’un contrat commence
Contratcontract.editSe déclenche lorsqu’un contrat est modifié
Contratcontract.endSe déclenche lorsqu’un contrat se termine
Contratcontract.archiveSe déclenche lorsqu’un contrat est archivé
Engagement et créditcommit.createSe déclenche lorsqu’un nouvel engagement est créé
Engagement et créditcommit.editSe déclenche lorsqu’un engagement est modifié
Engagement et créditcommit.archiveSe déclenche lorsqu’un engagement est archivé
Engagement et créditcommit.segment.startSe déclenche lorsqu’un segment d’engagement commence

Le numéro de segment qui a déclenché la notification et le nombre total de segments d’engagement se trouvent dans la charge utile
Engagement et créditcommit.segment.endSe déclenche lorsqu’un segment d’engagement se termine

Le numéro de segment qui a déclenché la notification et le nombre total de segments d’engagement se trouvent dans la charge utile
Engagement et créditcredit.createSe déclenche lorsqu’un nouveau crédit est créé
Engagement et créditcredit.editSe déclenche lorsqu’un crédit est modifié
Engagement et créditcredit.archiveSe déclenche lorsqu’un crédit est archivé
Engagement et créditcredit.segment.startSe déclenche lorsqu’un segment de crédit commence

Le numéro de segment qui a déclenché la notification et le nombre total de segments de crédit se trouvent dans la charge utile
Engagement et créditcredit.segment.endSe déclenche lorsqu’un segment de crédit se termine

Le numéro de segment qui a déclenché la notification et le nombre total de segments de crédit se trouvent dans la charge utile

​
Exemples de charges utiles de webhook

{
  "id": "fca7b4ef-6187-51d5-a9d9-b57f40117728",
  "type": "contract.create",
  "timestamp": "2025-09-12T20:20:04Z",
  "environment_type": "PRODUCTION",
  "contract_id": "33d206f6-7455-49f6-857d-2172c37db68d",
  "contract_custom_fields": {
    "org_key": "g_major"
  },
  "customer_id": "1ed86915-97f1-4d92-8fa6-763c0235093a",
  "customer_custom_fields": {
    "bill_customer_id": "0cu21JDIRIUDQKDS6wmx"
  }
}

​
Activer et gérer les notifications système

Les notifications système peuvent être activées et gérées via l’interface utilisateur ou l’API.
Interface de liste des notifications montrant différents types de notifications et leur statut
Dans l’interface utilisateur
  1. Accédez à l’onglet Notifications
  2. Trouvez la notification système que vous souhaitez activer. Toutes les notifications système disponibles apparaîtront dans la vue liste des notifications et seront désactivées par défaut pour tout compte
  3. Cliquez sur la notification
  4. Cliquez sur le bouton à côté de Statut pour activer
  5. Confirmez l’action pour activer
  6. Vous commencerez à recevoir des notifications sur cet événement système pour tous les clients vers tous les webhooks configurés
  7. Assurez-vous que vos webhooks sont configurés pour gérer correctement les charges utiles de ces notifications
Via l’API
  1. Appelez POST /v2/notifications/edit
  2. Passez la politique de la notification système que vous souhaitez activer (par exemple, contract.create) et is_enabled défini sur true
  3. Une réponse réussie retournera un code de réponse 200
LIMITATION DES DONNÉES HISTORIQUESLorsque vous activez une notification système, Metronome commence à générer des événements à partir de ce moment-là. Il ne revient pas en arrière pour créer des événements pour les données passées. De plus, la politique des notifications système ne peut pas être modifiée.