Pour être prévenu quand un workflow n8n échoue, crée un workflow d'erreur : un workflow à part qui démarre avec un nœud Error Trigger et t'envoie un message. Tu le relies ensuite à tes workflows dans leurs réglages. Quand l'un d'eux échoue en production, n8n lance automatiquement le workflow d'erreur.
Pourquoi une alerte est indispensable ?
Parce que le pire point de rupture d'une automatisation est le silence : le système s'arrête et personne ne le sait. Une demande de devis perdue est peut-être un client perdu, et tu ne le découvres que trois semaines plus tard. Un système fiable n'est pas un système qui ne casse jamais. C'est un système qui vérifie avant d'agir et qui te prévient quand il casse.
Comment créer un workflow d'erreur dans n8n ?
La documentation n8n sur la gestion des erreurs décrit le principe : un workflow dont le premier nœud est Error Trigger, puis un réglage dans le workflow à surveiller. Voici la procédure complète avec une alerte Telegram.
- Crée un nouveau workflow et nomme-le, par exemple Alerte en cas d'erreur.
- Ajoute le nœud Error Trigger comme premier nœud.
- Ajoute un nœud Telegram (action d'envoi de message) et renseigne ton identifiant Telegram et ton Chat ID.
- Si tu veux un message propre, ajoute entre les deux un petit nœud Code qui prépare le texte (voir plus bas).
- Enregistre, puis clique sur Publish en haut à droite. Dans les versions récentes de n8n (2.x), un workflow d'erreur non publié peut ne pas apparaître dans la liste de choix : publie-le, et republie-le si tu le modifies plus tard.
- Ouvre le workflow à surveiller, puis le menu du workflow (⋯) et Settings. Dans Error workflow, choisis ton workflow d'erreur, puis enregistre.
Un seul workflow d'erreur peut surveiller autant de workflows que tu veux.
Quelles informations reçoit le workflow d'erreur ?
Le nœud Error Trigger fournit un JSON avec deux parties principales, d'après la documentation :
| Partie | Contenu utile |
|---|---|
execution | L'identifiant et le lien (url) de l'exécution, le message d'erreur (error.message), le dernier nœud exécuté (lastNodeExecuted) |
workflow | L'identifiant et le nom du workflow (name) |
Si l'erreur survient dans le déclencheur lui-même, le workflow n'a jamais démarré : il n'y a ni execution.id ni lien, mais un objet trigger avec les détails de l'erreur. Ton message d'alerte doit gérer ce cas, par exemple en écrivant « Aucune exécution enregistrée » quand le lien manque. Pour lire ces champs avec des expressions, regarde comment lire un JSON dans n8n.
Pourquoi préparer le message avant de l'envoyer ?
Parce que le texte d'une erreur peut contenir des caractères qui font échouer Telegram. Si tu envoies en HTML (pour un titre en gras), un <, un > ou un & dans le message d'erreur casse l'envoi. Sans réglage, le nœud Telegram de n8n envoie en Markdown, où un simple _ peut tout bloquer. La solution : choisir le mode HTML et échapper les caractères spéciaux dans un nœud Code. Coupe le texte trop long avant de l'échapper, sinon tu peux laisser un code à moitié coupé que Telegram refuse.
Un message utile contient au minimum : le nom du workflow, le nœud en échec, le message d'erreur et le lien vers l'exécution.
Que faire quand l'alerte arrive ?
- Clique sur le lien de l'exécution : tu arrives sur l'exécution ratée, avec le nœud fautif en rouge.
- Lis le message d'erreur complet. Un 4xx indique un problème de ta demande, un 5xx un problème chez le fournisseur. Pour interpréter ces codes, lis l'article sur les erreurs 401 et 429.
- Corrige si le problème est de ton côté : identifiant expiré, colonne renommée, crédit épuisé.
- Avant de relancer, vérifie ce qui a déjà été fait. Si l'échec est arrivé après une écriture dans Google Sheets, la ligne existe peut-être déjà.
- Relance avec le bouton Retry : n8n rejoue l'exécution avec les mêmes données d'entrée, donc la demande du client n'est pas perdue.
Toutes les exécutions sont listées dans l'onglet Executions du workflow. Jette-y un œil une fois par semaine, même sans alerte.
Quelles autres défenses ajouter à l'alerte ?
L'alerte est la dernière ligne. Il en faut deux autres avant elle.
| Ligne | Ce qu'elle fait | Dans n8n |
|---|---|---|
| 1. Filtrer et vérifier | Refuser les entrées vides ou énormes, contrôler la réponse de l'IA | Un nœud If à l'entrée, un nœud de contrôle après l'IA |
| 2. Réessayer | Relancer une étape qui échoue sur une panne passagère (429, 500) | Réglage Retry On Fail |
| 3. Alerter | Te prévenir quand tout le reste a échoué | Un workflow d'erreur |
Pour Retry On Fail, ouvre les Settings du nœud et règle par exemple Max. Tries sur 3 et Wait Between Tries sur 5000 ms. Active-le seulement avant toute écriture ou notification, comme le nœud qui appelle l'IA. Sur un nœud qui écrit dans Google Sheets, une reprise peut créer un doublon si l'écriture avait en fait réussi.
Comment provoquer une panne pour tester l'alerte ?
Une alerte non testée est une alerte dont tu ne sais pas si elle marche. Sur une copie de ton workflow, ajoute un nœud Stop and Error juste après le déclencheur, publie la copie et envoie une demande. La documentation précise que ce nœud ne notifie rien lui-même : il force l'exécution à échouer, ce qui déclenche le workflow d'erreur. Tu dois voir une exécution rouge dans Executions et recevoir le message Telegram. Fais un second test en cassant volontairement une écriture (un nom d'onglet inexistant dans le nœud Google Sheets), pour vérifier qu'un échec d'action remonte bien jusqu'à toi.
Qu'est-ce que l'alerte ne voit pas ?
Elle ne voit que les exécutions qui échouent. Si n8n est arrêté ou si le formulaire ne déclenche plus rien, il n'y a pas d'exécution, donc pas d'alerte. Une habitude simple suffit au début : envoie chaque lundi une demande fictive « TEST contrôle » et vérifie qu'elle arrive.
Autre angle mort : un agent IA dont un outil échoue peut recevoir l'erreur comme une simple réponse et annoncer « c'est fait » alors qu'aucune ligne n'existe. L'exécution reste alors verte et aucune alerte ne part. C'est une des raisons pour lesquelles le projet final du niveau 1 classe d'abord avec l'IA, vérifie la réponse, puis fait agir un nœud ordinaire : s'il échoue, le workflow s'arrête en rouge. Voir aussi quand ne pas utiliser un agent IA.
Questions fréquentes
Faut-il un workflow d'erreur par workflow ?
Non. Un seul suffit : tu le sélectionnes dans le réglage Error workflow de chaque workflow à surveiller.
Pourquoi mon workflow d'erreur n'apparaît-il pas dans la liste ?
Souvent parce qu'il n'est pas publié. Ouvre-le, clique sur Publish, puis reviens dans les réglages du workflow à surveiller.
Une exécution lancée à la main déclenche-t-elle l'alerte ?
En général non : le workflow d'erreur est conçu pour les échecs de workflows en production. Pour tester, publie le workflow et déclenche-le par son déclencheur réel.
Puis-je recevoir l'alerte par e-mail plutôt que sur Telegram ?
Oui. La documentation de n8n cite l'envoi d'e-mails ou d'alertes Slack. Remplace simplement le nœud Telegram par le nœud de ton choix.
L'alerte remplace-t-elle les reprises automatiques ?
Non. Les reprises gèrent les pannes passagères, l'alerte te prévient de ce qui reste. Utilise les deux, chacune au bon endroit.