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 brouillons. Pour ouvrir la page Gérer les alertes d’un Canvas, vous pouvez :
- Aller dans 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 une 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.

É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, la règle « Entrées d’utilisateurs inférieures à 3 000 » signale un Canvas qui touche habituellement des milliers d’utilisateurs mais qui s’est soudainement arrêté. C’est le 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 base de référence propre à ce Canvas. La base de 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 effectue une vérification 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érieurs à 50 % » signale une baisse en dessous de la moitié de ce volume habituel.
Les seuils sont des nombres entiers. Pour les règles en 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. Vous pouvez ainsi être alerté en cas de pic par rapport à la base de référence.
Vous pouvez regrouper plusieurs règles, y compris en combinant des règles de volume et de pourcentage, et associer des groupes de règles avec une logique AND ou OR pour créer des conditions d’alerte plus précises.
Étape 4 : Définir la planification des alertes
Définissez la fréquence à laquelle vos règles d’alerte sont vérifiées. Vous pouvez choisir une fréquence de vérification comprise entre 3 et 12 heures (par paliers d’une heure), ou toutes les 24 heures. Une fois activée, une alerte continue d’effectuer ses vérifications selon cette planification tant que l’alerte et le Canvas qui lui est associé restent 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, si nécessaire, ajoutez les en-têtes de requête personnalisés exigés par la destination de votre webhook.
- Slack : Saisissez l’URL de votre webhook entrant Slack pour publier les notifications dans un canal Slack. Pour en savoir plus sur l’intégration des alertes Canvas avec Slack, consultez la documentation de Slack sur l’envoi de messages à l’aide de webhooks entrants.
Vous pouvez activer une, deux ou les trois méthodes de notification pour une même alerte.
Les alertes par webhook sont utiles 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 en pourcentage incluent également percentage_metric_value (le nombre observé, exprimé en pourcentage entier de la référence). metric_value correspond toujours au nombre absolu.
Exemple de payload webhook
Voici un exemple du payload JSON envoyé dans une requête POST à votre endpoint de 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 au cours des 7 derniers jours, pour un seuil fixé à plus de 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 les règles, la planification et les paramètres de notification de votre alerte dans le panneau récapitulatif, puis sélectionnez Enregistrer l’alerte.
Étape 7 : Activer l’alerte
L’enregistrement d’une alerte ne suffit pas à l’activer. Pour l’activer, rendez-vous sur la page Gérer les alertes et utilisez le bouton Statut de votre alerte. Une alerte reste active jusqu’à ce que vous la désactiviez ou que le Canvas associé ne soit plus actif. Sur la page Canvas, la colonne Alertes configurées affiche une icône en forme de cloche pour chaque Canvas comportant 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 à l’état de brouillon : vous pouvez configurer une alerte personnalisée pour un Canvas encore à l’état de brouillon, mais l’alerte ne commencera à vérifier vos règles qu’au lancement du Canvas.
- Base de référence en pourcentage : les règles en pourcentage nécessitent sept jours complets antérieurs, sur la même fenêtre horaire, 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 antérieures), les règles en pourcentage ne déclenchent aucune 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 pas comptabilisées dans les limites de débit des webhooks ni dans les indicateurs d’utilisation.