Skip to content

Alertes de seuil Canvas

Les alertes de seuil Canvas vous informent lorsque quelque chose dans un Canvas ne se passe pas comme prévu, afin que vous puissiez détecter un parcours bloqué ou une baisse inattendue avant que cela n’affecte vos clients.

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

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

Étape 1 : Créer une alerte

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

  • Aller dans Messaging > Canvas, et sélectionner Gérer les alertes dans le menu contextuel d’un Canvas individuel
  • Pour les Canvas actifs, ouvrir Canvas Analytics 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 de nom de l'alerte et de nom du Canvas, un groupe de règles vide et une barre latérale de résumé 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 ayant accédé au 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 à) et un seuil de volume. Par exemple, une règle « Entrées d’utilisateurs inférieur à 3 000 » signale un Canvas qui atteint normalement des milliers d’utilisateurs mais qui s’est soudainement arrêté — signe d’un problème en amont lié à l’audience ou aux conditions d’entrée qui mérite d’être examiné.

Vous pouvez regrouper plusieurs règles et combiner des groupes de règles avec une logique ET ou OU pour créer des conditions d’alerte plus spécifiques.

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

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

Étape 5 : Configurer les notifications

Choisissez qui doit être notifié lorsqu’une règle d’alerte est déclenchée, et comment :

  • E-mail : Ajoutez une ou plusieurs adresses e-mail de destinataires
  • Webhook : Saisissez l’URL du webhook à notifier, et ajoutez éventuellement des en-têtes de requête personnalisés requis par votre destination webhook

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

La section Notifications du panneau de configuration des alertes, affichant les bascules E-mail et Webhook, un champ pour les destinataires e-mail, un champ pour l'URL du webhook, une note sur le contenu du payload, et des champs optionnels pour les en-têtes de requête.

Les alertes webhook sont utiles pour acheminer les notifications vers des plateformes externes, comme un canal Slack. Pour en savoir plus, consultez la documentation de Slack sur l’envoi de messages à l’aide de webhooks entrants. 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.

Exemple de payload webhook

Voici un exemple de payload JSON envoyé dans une requête POST à votre endpoint webhook lorsqu’une alerte est déclenchée :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
  "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
    },
    {
      "subject": "messages_sent",
      "operator": "lt",
      "threshold_value": 500,
      "metric_value": 0.0,
      "group_index": 0
    }
  ]
}

Étape 6 : Enregistrer votre alerte

Vérifiez les règles de votre alerte, la planification et les paramètres de notification dans le panneau de résumé, puis sélectionnez Save alert.

É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 Statut pour votre alerte. Une alerte reste active jusqu’à ce que vous la désactiviez ou jusqu’à ce que le Canvas associé ne soit plus actif. La colonne Alertes configurées sur la page Canvas affiche une icône de cloche pour tout Canvas ayant au moins une alerte enregistrée.

Considérations

  • Canvas en brouillon : Vous pouvez configurer une alerte de seuil pour un Canvas encore en brouillon, mais l’alerte ne commencera à vérifier vos règles qu’une fois le Canvas lancé.
New Stuff!