
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.
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.
| Situation | Anthropic (Claude) | OpenAI | Mistral AI | Réessayer ? | Qui prévenir |
|---|---|---|---|---|---|
| Limite de débit dépassée | 429 rate_limit_error | 429 « Rate limit reached » ou slow_down | 429, code 1300 | Oui, avec une attente qui s'allonge | Personne, sauf si cela se répète chaque jour |
| Modèle ou service surchargé | 529 overloaded_error ; 500 api_error | 503 server_is_overloaded ; 500 | 429 ou 503, codes 3505, 3801 ; 500, 502, 503 | Oui | Le référent technique si cela dure |
| Plafond de dépense que vous avez posé | 400 invalid_request_error | 429 organization_spend_limit_exceeded ou project_spend_limit_exceeded | 402, code 2300 (organisation) ou 2301 (espace de travail) | Non | Celui 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 essai | 429 credit_balance_exhausted | 402, codes 2308 (crédit) ou 2303 (budget inclus) | Non | Celui qui paie le compte |
| Clé d'API invalide ou révoquée | 401 authentication_error | 401 | 401 {"detail": "Invalid API Key"} | Non | Le référent technique, tout de suite |
| Requête refusée (texte trop long, paramètre faux) | 400 invalid_request_error ; 413 request_too_large | 400 | 400 (code 3059 pour un texte trop long) ; 422 | Non, corriger la donnée | Le 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
- 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.
- 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.
- 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.
- 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. - 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 surexecution?.idpour le cas où c'est le déclencheur qui a échoué. - 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.
| Étiquette | Destinataire | Ce qu'il doit faire |
|---|---|---|
[BUDGET] | La personne qui a fixé le plafond, souvent le dirigeant ou le responsable financier | Décider s'il relève la limite ou si le workflow s'arrête jusqu'au mois suivant |
[CLE] et sans étiquette | Le référent technique, interne ou prestataire | Remplacer la clé, corriger le nœud, rejouer l'exécution |
| Éléments écartés | Le 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.