Question
n8n : traiter une erreur avec un workflow dédié
Configurer Error Trigger dans n8n, comprendre les informations reçues et préparer une alerte utile avant de relancer une automatisation en échec.
Mis à jour le
Une automatisation doit prévoir ce qui se passe quand une étape échoue. Dans n8n, un workflow d'erreur permet de définir ce traitement séparément du parcours principal. Il peut notamment préparer une alerte. Le recevoir ne signifie pas que le problème est corrigé : il sert à orienter l'intervention.
Relier le traitement au workflow principal
La documentation n8n lue le 16/11/2026 indique de créer un workflow commençant par le nœud Error Trigger, puis de l'enregistrer. Dans les paramètres du workflow à surveiller, le champ Error workflow permet de sélectionner ce traitement. Un même workflow d'erreur peut servir à plusieurs automatisations.
Avant de configurer votre premier essai, écrivez ce que vous souhaitez obtenir : identifier le traitement en échec, retrouver l'étape et savoir qui doit examiner le dossier. Un message contenant seulement « erreur » ne répond à aucune de ces questions. Le choix de l'action vient après celui de l'information utile.
Prévoir les informations absentes
La documentation montre des données sur le workflow et l'exécution. L'identifiant et l'URL d'exécution supposent que celle-ci soit enregistrée en base ; ils sont absents lorsque l'erreur survient dans le déclencheur du workflow principal. Le champ retryOf n'existe que pour une reprise d'une exécution échouée. Une erreur du déclencheur fournit une structure différente.
Notre conseil : prévoyez un message de remplacement si le lien d'exécution manque. Évitez une alerte dont le titre, le destinataire ou le texte dépend entièrement d'un champ facultatif. Pour un traitement partagé entre plusieurs workflows, faites apparaître un nom compréhensible par la personne qui reçoit l'alerte.
Prévoyez aussi le cas d’une alerte qui ne part pas : le traitement d’erreur dépend de ses propres connexions et de son destinataire. Une vérification périodique de l’historique constitue un contrôle distinct. Pour le suivi partagé, distinguez le symptôme visible de la cause encore à établir ; un champ vide ne suffit pas à prouver une perte de données.
Préparer un essai contrôlé
n8n documente le nœud Stop And Error pour provoquer un échec selon les conditions choisies et déclencher le traitement d'erreur. Utilisez cette possibilité dans un parcours d'essai avec des données fictives et un destinataire de test autorisé. La documentation Error Trigger précise que le workflow d’erreur doit être publié et que ce déclencheur réagit aux erreurs d’exécutions automatiques : un lancement manuel ne valide pas la chaîne d’alerte. Préparez donc un déclenchement automatique dans l’environnement d’essai, sans connecter les sorties métier réelles.
Nous proposons de contrôler séparément la réception, la lisibilité et le diagnostic. La personne désignée retrouve-t-elle le bon workflow ? Comprend-elle l'étape concernée ? Sait-elle quelle action est attendue ? Retirez des messages les données métier inutiles au diagnostic et gardez le détail dans l'espace auquel cette personne a accès.
Pour confronter le traitement d’un incident, apportez une alerte inventée et demandez à une autre personne ce qu’elle ferait ensuite. La personne retrouve-t-elle l’étape et sait-elle qui peut autoriser la reprise ? Une alerte compréhensible doit aussi l’être hors de la présence de son créateur.
Si le workflow appelle un agent qui choisit lui-même ses actions, distinguez ses arrêts du déclenchement Error Trigger : la fiche erreurs et reprise d’un agent IA traite cette couche technique.
Décider avant de relancer
Avant une reprise, examinez ce qui a déjà été exécuté. Dans votre suivi, distinguez une donnée lue d'une action qui a pu écrire dans un autre outil. En cas de doute, vérifiez cet outil avant de recommencer tout le parcours. Cette précaution évite de traiter une alerte comme un bouton de répétition automatique.
Pour définir le périmètre du premier essai, voyez quelle tâche automatiser d'abord. Si le workflow commence par un appel externe, la page sur le webhook explique ce point d'entrée. Le prix de n8n traite du budget séparément du diagnostic.
Faire transmettre la décision de reprise
Préparez une fiche d’incident fictif avec trois cases : dernière action confirmée, effet encore incertain et vérification nécessaire. Le collègue qui la reçoit doit pouvoir choisir entre examiner la destination, reprendre une étape ou garder le traitement arrêté. Ajoutez la date de la décision et la personne habilitée à intervenir. Le retour au cercle pourrait porter sur l’information manquante qui empêchait ce choix, sans partager le journal complet.
Pour aller plus loin, vous pouvez concevoir une reprise contrôlée du scénario. Pour discuter de ce cas entre professionnels, préparez un échange avec Cercle IA.
Sources
Pages consultées pour écrire cet article :