Passer au contenu

Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

Alertes Canvas personnalisées

Les alertes Canvas personnalisées vous préviennent lorsqu’un élément d’un Canvas ne se déroule pas comme prévu. Vous pouvez ainsi repérer un parcours bloqué ou une baisse inattendue avant qu’ils n’affectent vos clients.

Définissez un seuil de volume ou de pourcentage pour les entrées d’utilisateurs ou les messages envoyés. Si ce seuil est franchi, Braze vous avertit par e-mail ou par webhook. Vous pouvez créer jusqu’à deux alertes pour un même Canvas, par exemple une alerte pour les entrées d’utilisateurs et une autre pour les messages envoyés.

Pour configurer des alertes par défaut sur tous les Canvas d’un espace de travail, consultez Alertes Canvas de l’espace de travail.

Vous ne savez pas par où commencer ? Operator peut vous guider dans la configuration d’une alerte Canvas personnalisée.

Étape 1 : Créer une alerte

Les alertes se définissent au niveau du Canvas, et vous pouvez les configurer pour les Canvas actifs comme pour les Canvas en brouillon. Pour ouvrir la page Gérer les alertes d’un Canvas, vous pouvez :

Accéder à Envoi de messages > Canvas, puis sélectionner Gérer les alertes dans le menu contextuel d’un Canvas
Pour les Canvas actifs, ouvrir Analyse du Canvas et sélectionner Gérer les alertes.

Depuis la page Gérer les alertes, sélectionnez Configurer l’alerte pour créer une nouvelle alerte.

Étape 2 : Nommer votre alerte et sélectionner un Canvas

Donnez un nom à votre alerte et confirmez le Canvas auquel elle s’applique.

Le panneau Configurer l’alerte affichant les champs du nom de l’alerte et du nom du Canvas, un groupe de règles vide et une barre latérale récapitulative pour les règles d’alerte, la planification et les notifications.

Étape 3 : Définir les règles d’alerte

Les règles d’alerte définissent le seuil qui déclenche une notification. Vous pouvez créer des règles à partir de deux indicateurs :

Entrées d’utilisateurs : nombre d’utilisateurs entrés dans le Canvas
Messages envoyés : nombre de messages envoyés depuis le Canvas

Pour chaque règle, choisissez une comparaison (inférieur à, supérieur à, inférieur ou égal à, supérieur ou égal à, ou égal à), une unité et un seuil.

Volume : compare le nombre absolu dans la fenêtre de vérification en cours. Par exemple, « Entrées d’utilisateurs inférieur à 3 000 » signale un Canvas qui touche habituellement des milliers d’utilisateurs mais qui s’est soudainement bloqué, signe d’un problème d’audience ou d’entrée en amont qui mérite d’être examiné.
Pourcentage : compare le nombre actuel à une référence propre à ce Canvas. Cette référence correspond à la moyenne de la même fenêtre temporelle sur les 7 jours précédents. Par exemple, si l’alerte vérifie toutes les 3 heures, une vérification de 14 h à 17 h est comparée à la moyenne des sept fenêtres précédentes de 14 h à 17 h. Une règle « Messages envoyés inférieur à 50 % » signale une chute sous la moitié de ce volume habituel.

Les seuils sont des nombres entiers. Pour les règles de pourcentage avec inférieur à ou inférieur ou égal à, saisissez une valeur comprise entre 1 et 100. Pour supérieur à, supérieur ou égal à ou égal à, le pourcentage peut être égal ou supérieur à 0, y compris au-delà de 100, ce qui vous permet d’être alerté en cas de pic par rapport à la référence.

Vous pouvez regrouper plusieurs règles, y compris en mélangeant des règles de volume et de pourcentage, et combiner des groupes de règles avec une logique ET ou OU pour créer des conditions d’alerte plus précises.

Étape 4 : Définir la planification de l’alerte

Définissez la fréquence de vérification de vos règles d’alerte. Vous pouvez choisir une fréquence comprise entre 3 et 12 heures (par incréments d’une heure), ou toutes les 24 heures. Une fois activée, l’alerte continue d’effectuer ses vérifications selon cette planification tant que l’alerte et le Canvas associé sont actifs.

Étape 5 : Configurer les notifications

Choisissez qui doit être averti lorsqu’une règle d’alerte est remplie, et de quelle manière :

E-mail : ajoutez une ou plusieurs adresses e-mail de destinataires
Webhook : saisissez l’URL du webhook à notifier et ajoutez, si besoin, les en-têtes de requête personnalisés exigés par votre destination webhook

Vous pouvez activer l’une des méthodes de notification ou les deux pour une même alerte.

Les alertes par webhook sont pratiques pour acheminer les notifications vers des plateformes externes. Chaque notification webhook envoie un payload JSON contenant le nom de l’alerte, la fenêtre d’évaluation et les conditions qui ont déclenché l’alerte. Chaque condition comprend un threshold_unit de valeur volume ou percentage. Les conditions de pourcentage comprennent également percentage_metric_value (le nombre observé exprimé en pourcentage entier de la référence). metric_value correspond toujours au nombre absolu.

Remarque

Les webhooks entrants Slack ne sont pas encore pris en charge pour les alertes Canvas personnalisées.

Exemple de payload webhook

Voici un exemple de payload JSON envoyé dans une requête POST vers votre endpoint webhook lorsqu’une alerte est déclenchée. La première condition est une règle de volume. La seconde est une règle de pourcentage : 51 235 messages envoyés, soit 57 % de la référence calculée sur la même fenêtre des 7 derniers jours, pour un seuil défini à supérieur à 55 %.

{
  "alert": {
    "name": "Canvas Alert - August 6, 2026",
    "target_type": "CANVAS"
  },
  "evaluation_window_start": "2026-08-06T10:28:01Z",
  "evaluation_window_end": "2026-08-06T13:28:01Z",
  "conditions": [
    {
      "subject": "user_entries",
      "operator": "lt",
      "threshold_value": 500,
      "metric_value": 0.0,
      "group_index": 0,
      "threshold_unit": "volume"
    },
    {
      "subject": "messages_sent",
      "operator": "gt",
      "threshold_value": 55,
      "metric_value": 51235.0,
      "group_index": 0,
      "threshold_unit": "percentage",
      "percentage_metric_value": 57
    }
  ]
}

Étape 6 : Enregistrer votre alerte

Vérifiez vos règles d’alerte, votre planification et vos paramètres de notification dans le panneau récapitulatif, puis sélectionnez Enregistrer l’alerte.

Étape 7 : Activer l’alerte

Enregistrer une alerte ne l’active pas. Pour l’activer, accédez à la page Gérer les alertes et utilisez le bouton bascule Statut de votre alerte. Une alerte reste active jusqu’à ce que vous la désactiviez ou que le Canvas associé ne soit plus actif. Dans la page Canvas, la colonne Alertes configurées affiche une icône en forme de cloche pour chaque Canvas disposant d’au moins une alerte enregistrée.

Points à prendre en compte

Limite d’alertes : vous pouvez créer jusqu’à deux alertes personnalisées par Canvas.
Canvas en brouillon : vous pouvez configurer une alerte personnalisée pour un Canvas encore en brouillon, mais l’alerte ne commencera à vérifier vos règles qu’au lancement du Canvas.
Référence de pourcentage : les règles de pourcentage nécessitent sept jours complets antérieurs sur la même fenêtre après le lancement du Canvas. Tant que ces fenêtres n’existent pas, ou lorsque la moyenne de référence est nulle (aucune activité dans ces fenêtres précédentes), les règles de pourcentage ne déclenchent pas de notification.

Foire aux questions

Les alertes personnalisées sont-elles comptabilisées dans l’utilisation des webhooks ?

Non. Les alertes Canvas personnalisées ne sont comptabilisées ni dans les limites de débit des webhooks ni dans les indicateurs d’utilisation.

New Stuff!