Waimia.
AccueilBlogWorkflow d'erreur n8n pour les appels à Claude, OpenAI et Mistral FR Édition française ◉ Disponible
Un aiguilleur près d'un levier : une voie repart en boucle, une autre monte vers un grand signal bleu
§ Blog · Automatisation

Workflow d'erreur n8n pour les appels à Claude, OpenAI et Mistral

Error Trigger, Retry On Fail et codes d'erreur de Claude, OpenAI et Mistral : quoi réessayer, quoi bloquer, qui prévenir. Tableau et procédure n8n.

Simon Beros··8 min de lecture

En bref

Un workflow d'erreur n8n est un workflow qui commence par le nœud Error Trigger et que n8n lance automatiquement quand une exécution d'un autre workflow échoue. Pour les workflows qui appellent Claude, ChatGPT ou Mistral, il ne suffit pas : il reçoit le message d'erreur, pas le code HTTP ni le type d'erreur de l'éditeur, alors que c'est ce code qui dit s'il faut réessayer, couper ou prévenir la personne qui tient le budget.

Ma règle : trier l'erreur dans le workflow qui appelle le modèle, au plus près de l'appel, puis laisser le workflow d'erreur prévenir la bonne personne avec un message déjà classé. Une limite de débit se réessaie, un plafond de dépense ou une clé révoquée ne se réessaient jamais.

Vérifiez ce que ce sujet change chez vous : 45 minutes, gratuit, sans engagement.

Réserver l'audit gratuit →

Workflow d'erreur, erreur passagère, erreur bloquante

Le workflow d'erreur se règle workflow par workflow : dans le workflow à surveiller, Options, puis Settings, champ Error workflow, selon la documentation de n8n. Un même workflow d'erreur peut servir à tous vos workflows.

Une erreur passagère est un refus qui disparaît seul si l'on attend : limite de débit dépassée, modèle surchargé, panne côté éditeur. Une erreur bloquante est un refus qui reviendra à l'identique tant qu'un humain n'a rien changé : plafond de dépense atteint, crédit épuisé, clé d'API invalide, requête refusée parce que le texte envoyé est trop long ou mal formé.

Réessayer une erreur bloquante ne fait que multiplier les échecs ; alerter quelqu'un pour une erreur passagère que le workflow aurait absorbée seul use l'attention des équipes, et l'alerte qui compte finit ignorée.

Ce que renvoient Claude, OpenAI et Mistral, et quoi en faire

Les trois éditeurs n'utilisent pas les mêmes codes pour le même problème.

SituationAnthropic (Claude)OpenAIMistral AIRéessayer ?Qui prévenir
Limite de débit dépassée429 rate_limit_error429 « Rate limit reached » ou slow_down429, code 1300Oui, avec une attente qui s'allongePersonne, sauf si cela se répète chaque jour
Modèle ou service surchargé529 overloaded_error ; 500 api_error503 server_is_overloaded ; 500429 ou 503, codes 3505, 3801 ; 500, 502, 503OuiLe référent technique si cela dure
Plafond de dépense que vous avez posé400 invalid_request_error429 organization_spend_limit_exceeded ou project_spend_limit_exceeded402, code 2300 (organisation) ou 2301 (espace de travail)NonCelui qui tient le budget de l'API
Plafond mensuel du palier, crédit épuisé429 avec enforced_spend_limit_reached, sans délai de nouvel essai429 credit_balance_exhausted402, codes 2308 (crédit) ou 2303 (budget inclus)NonCelui qui paie le compte
Clé d'API invalide ou révoquée401 authentication_error401401 {"detail": "Invalid API Key"}NonLe référent technique, tout de suite
Requête refusée (texte trop long, paramètre faux)400 invalid_request_error ; 413 request_too_large400400 (code 3059 pour un texte trop long) ; 422Non, corriger la donnéeLe référent technique, avec l'élément en cause

Sources : Anthropic, erreurs de l'API, Anthropic, limites, OpenAI, codes d'erreur, Mistral AI, glossaire des erreurs.

Chez Anthropic, le plafond que vous posez vous-même renvoie une erreur 400, la même que pour une requête mal formée : une surveillance qui ne guette que les 429 ne le voit pas. Chez OpenAI, le même code 429 couvre à la fois une limite de débit, qu'on réessaie, et un plafond de dépense, qu'on ne réessaie pas : OpenAI écrit que réessayer une erreur de facturation, de dépense ou de quota ne rétablit pas l'accès. Le code HTTP seul ne suffit donc pas à décider ; il faut lire le type ou le code d'erreur dans le corps de la réponse.

Le réglage des plafonds eux-mêmes, éditeur par éditeur, est détaillé dans plafonner la dépense d'une API d'IA.

Ce que le workflow d'erreur reçoit vraiment

D'après la documentation de l'Error Trigger, il reçoit le nom et l'identifiant du workflow, le dernier nœud exécuté, le message d'erreur et sa trace, le mode d'exécution, et, si l'exécution est enregistrée en base, son identifiant et son lien. Si c'est le déclencheur du workflow surveillé qui a échoué, le bloc execution est presque vide et les détails arrivent dans un bloc trigger : un message construit sur execution.url part alors avec un lien vide.

Le code HTTP et le type d'erreur de l'éditeur ne font pas partie de ces champs. Ils ne survivent que s'ils figurent dans le texte du message, et ce texte dépend du nœud. Sur le forum de n8n, un utilisateur du nœud OpenAI a montré que la sortie d'erreur ne transmettait que « Bad request - please check your parameters », alors que l'interface affichait le code context_length_exceeded ; un autre constate la même perte avec le nœud HTTP Request. Fixmation, qui a lu le moteur d'exécution de n8n, décrit des versions 2.33 et 2.34 où des erreurs du nœud HTTP Request partaient dans la branche de succès. Avant de construire un tri sur un champ, ouvrez une vraie exécution en échec sur votre version et regardez ce qui arrive.

C'est pourquoi, pour un appel de modèle qui compte, je passe par le nœud HTTP Request plutôt que par le nœud de l'éditeur, avec deux options documentées par n8n : « Include Response Headers and Status », qui renvoie le code et les en-têtes, et « Never Error », qui fait sortir la réponse même quand le code n'est pas 2xx. Le corps complet de l'erreur arrive alors dans le workflow, et un nœud Switch peut décider. Le prix à payer : écrire soi-même l'appel (adresse, en-têtes, corps de la requête), là où le nœud de l'éditeur le faisait.

Retry On Fail : utile, mais pas pour tout

Retry On Fail, dans l'onglet Settings d'un nœud, relance le nœud quand il échoue. Selon la page de n8n sur les limites de débit, il permet cinq essais au plus, espacés de 5 secondes au plus, et le nœud HTTP Request ne respecte pas de lui-même l'en-tête Retry-After que l'éditeur envoie pour dire combien attendre.

Conséquence pratique : Retry On Fail absorbe un modèle surchargé quelques secondes, pas une limite de débit par minute, et encore moins un plafond mensuel. Réglé sur cinq essais, il transforme un plafond de dépense en cinq échecs de plus avant l'alerte. Pour une limite de débit, la documentation de n8n recommande plutôt Loop Over Items avec un nœud Wait, ou l'option Batching du nœud HTTP Request.

La procédure, étape par étape

  1. Créer le workflow d'erreur. Un workflow « Erreurs IA » qui commence par l'Error Trigger. La documentation actuelle de n8n demande de publier le workflow qui contient ce nœud, et précise qu'un workflow contenant un Error Trigger est par défaut son propre workflow d'erreur. Des guides français, comme ceux de Kirako ou d'Infinitelab, écrivent encore qu'il n'a pas besoin de l'être : publiez-le.
  2. Le brancher partout. Dans chaque workflow qui appelle un modèle, Options, Settings, Error workflow : « Erreurs IA ». Tenez la liste des workflows réglés ; c'est le premier oubli.
  3. Appeler le modèle avec le code en main. Nœud HTTP Request vers l'API de l'éditeur, options « Include Response Headers and Status » et « Never Error ». Gardez une clé et un projet ou espace de travail par automatisation, comme expliqué dans sécuriser les clés API dans n8n et Make.
  4. Trier juste après l'appel. Un nœud Switch sur le code et le type d'erreur : 2xx, on continue ; 429 de débit, 500, 503 ou 529, on passe par un nœud Wait puis on relance, avec un compteur qui s'arrête à trois tours (au-delà, l'incident n'est plus passager et mérite une alerte) ; plafond, crédit ou clé, on lance un nœud Stop and Error avec un message qui commence par une étiquette, par exemple [BUDGET] ou [CLE] ; requête refusée, on écarte l'élément dans une table à revoir et on traite les suivants.
  5. Router l'alerte selon l'étiquette. Dans « Erreurs IA », un Switch lit le début de execution.error.message : [BUDGET] part chez la personne qui tient le budget de l'API, [CLE] et tout message sans étiquette chez le référent technique. Le message contient le nom du workflow, le dernier nœud exécuté, le message complet et le lien de l'exécution, avec un test sur execution?.id pour le cas où c'est le déclencheur qui a échoué.
  6. Tester pour de vrai. L'Error Trigger ne part que sur une exécution automatique : un lancement manuel dans l'éditeur ne déclenche rien. Créez un petit workflow planifié qui échoue exprès avec un Stop and Error portant [BUDGET], vérifiez que l'alerte arrive chez la bonne personne, puis désactivez-le.

À qui envoyer l'alerte

Je fixe trois destinataires nommés, pas un canal commun où chacun pense qu'un autre a lu. Dans une PME sans informaticien, le référent technique est en général le prestataire qui a construit le workflow : son nom et son délai de réponse doivent figurer dans le contrat.

ÉtiquetteDestinataireCe qu'il doit faire
[BUDGET]La personne qui a fixé le plafond, souvent le dirigeant ou le responsable financierDécider s'il relève la limite ou si le workflow s'arrête jusqu'au mois suivant
[CLE] et sans étiquetteLe référent technique, interne ou prestataireRemplacer la clé, corriger le nœud, rejouer l'exécution
Éléments écartésLe responsable métier du flux (commandes, factures, demandes clients)Traiter à la main les éléments refusés, une fois par jour

Un exemple de message utile : « [BUDGET] Tri des demandes clients · nœud Appel Claude · plafond de l'espace de travail atteint · lien vers l'exécution ». La personne qui le reçoit sait, sans ouvrir n8n, que rien n'est cassé et qu'une décision de budget l'attend.

Le message d'erreur peut contenir des données de vos clients : envoyez les alertes dans un canal privé ou par e-mail nominatif, pas dans un canal ouvert à toute l'entreprise.

Ce que je déconseille

Basculer automatiquement vers un autre éditeur quand le premier refuse. L'idée revient dans les tutoriels sous le nom de « fallback » ; pour une PME, c'est envoyer les mêmes données à un second sous-traitant sans l'avoir décidé, avec d'autres conditions de conservation et d'hébergement. Si un second modèle est prévu, il doit l'être par écrit, comme le premier, et la bascule doit être visible dans l'alerte.

Ne construisez pas tout cela pour un seul workflow qui tourne une fois par semaine et dont l'arrêt ne coûte rien : un workflow d'erreur qui vous envoie le message suffit. La procédure complète se justifie dès qu'un workflow touche un client, une facture ou une commande, ou dès que plusieurs workflows partagent la même clé.

Si vous voulez qu'on regarde ensemble vos workflows qui appellent un modèle et ce qui se passerait le jour où le plafond tombe, c'est l'objet de l'audit IA gratuit. Pour la prise en main de l'outil lui-même, voir n8n, c'est quoi et notre accompagnement n8n.

Classez vos tâches avant de choisir le premier cas

Dix minutes, un classement par priorité en heures par mois : la grille vous le donne tout de suite, sans inscription. Vous pouvez ensuite la recevoir par e-mail pour la garder.

Questions fréquentes

Q.01 Comment créer un workflow d'erreur dans n8n ?

Créez un workflow qui commence par le nœud Error Trigger, enregistrez-le et publiez-le. Puis, dans chaque workflow à surveiller, ouvrez Options, Settings, et choisissez ce workflow dans le champ Error workflow. Un même workflow d'erreur peut servir à tous vos workflows.

Q.02 Pourquoi mon workflow d'erreur n8n ne se déclenche pas ?

Le plus souvent parce que le test est lancé à la main dans l'éditeur : l'Error Trigger ne part que sur une exécution automatique en échec. Vérifiez aussi que le workflow surveillé a bien ce workflow dans son champ Error workflow et que le workflow d'erreur est publié.

Q.03 Faut-il activer Retry On Fail sur un nœud qui appelle Claude ou OpenAI ?

Oui pour absorber une surcharge de quelques secondes, non comme seule protection. Retry On Fail permet cinq essais au plus, espacés de 5 secondes au plus, et ne respecte pas l'en-tête Retry-After. Face à un plafond de dépense ou une clé révoquée, il ne produit que des échecs supplémentaires.

Q.04 Comment savoir si une erreur 429 vient du budget ou de la limite de débit ?

Lisez le corps de la réponse, pas seulement le code. Chez OpenAI, un plafond porte un code comme project_spend_limit_exceeded ; chez Anthropic, le plafond mensuel du palier porte enforced_spend_limit_reached. Chez Mistral, un plafond de dépense renvoie un 402, pas un 429.

Q.05 Quelle erreur renvoie l'API Claude quand mon plafond de dépense est atteint ?

Une erreur 400 invalid_request_error pour un plafond que vous avez posé sur l'organisation ou un espace de travail, selon la documentation d'Anthropic. Le plafond mensuel lié au palier de votre compte renvoie, lui, une erreur 429 sans délai de nouvel essai, jusqu'au 1er du mois suivant.

Quelles tâches automatiser en premier chez vous ? L'audit gratuit de 45 minutes part de vos tâches réelles et dit par où commencer, ou s'il vaut mieux ne rien faire.

Réserver l'audit gratuit →