# Workflow d'erreur n8n : erreurs des API d'IA

> 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.

Source : https://waimia.com/blog/workflow-erreur-n8n-ia

---

[Accueil](/)[Blog](/blog)Workflow 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·20 novembre 2026·8 min de lecture           [Simon Beros](/equipe/simon-beros)20 novembre 2026 · 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 →](/contact?offer=audit-ia-pme&intent=audit)

## 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](https://docs.n8n.io/flow-logic/error-handling/). 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](https://platform.claude.com/docs/en/api/errors), [Anthropic, limites](https://platform.claude.com/docs/en/api/rate-limits), [OpenAI, codes d'erreur](https://developers.openai.com/api/docs/guides/error-codes), [Mistral AI, glossaire des erreurs](https://docs.mistral.ai/resources/error-glossary).

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](/blog/plafond-depense-api-ia).

## Ce que le workflow d'erreur reçoit vraiment

D'après [la documentation de l'Error Trigger](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.errortrigger/), 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](https://community.n8n.io/t/why-does-continue-using-error-output-on-openai-v2-not-pass-the-full-error-body-to-the-next-node/222579), 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](https://fixmation.dev/blog/n8n-error-output-failed-item-in-success), 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](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/) : « 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](https://docs.n8n.io/integrations/builtin/handle-rate-limits/), 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](https://kirako.ai/blog/n8n-production-erreurs-alertes-surveillance) ou d'[Infinitelab](https://www.infinitelab.fr/blog/n8n-gestion-erreurs-workflow-error-trigger), é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](/blog/cles-api-automatisation-securite-pme).

- **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 sur `execution?.id` pour 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](/audit-ia-pme). Pour la prise en main de l'outil lui-même, voir [n8n, c'est quoi](/blog/n8n-c-est-quoi) et notre [accompagnement n8n](/services/automatisation-n8n).

    Partager [X](https://x.com/intent/tweet?url=https%3A%2F%2Fwaimia.com%2Fblog%2Fworkflow-erreur-n8n-ia&text=Workflow%20d'erreur%20n8n%20pour%20les%20appels%20%C3%A0%20Claude%2C%20OpenAI%20et%20Mistral%20%C2%B7%20Waimia) [LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fwaimia.com%2Fblog%2Fworkflow-erreur-n8n-ia)        § Sources

- [n8n, Handle errors gracefully, lu le 20 novembre 2026](https://docs.n8n.io/flow-logic/error-handling/) enterprise
- [n8n, Error Trigger, lu le 20 novembre 2026](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.errortrigger/) enterprise
- [n8n, Handle rate limits, lu le 20 novembre 2026](https://docs.n8n.io/integrations/builtin/handle-rate-limits/) enterprise
- [n8n, Work with nodes (réglages des nœuds), lu le 20 novembre 2026](https://docs.n8n.io/workflows/components/nodes/) enterprise
- [n8n, HTTP Request, lu le 20 novembre 2026](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/) enterprise
- [n8n, Stop And Error, lu le 20 novembre 2026](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.stopanderror/) enterprise
- [Anthropic, Claude API errors, lu le 20 novembre 2026](https://platform.claude.com/docs/en/api/errors) enterprise
- [Anthropic, Rate limits, lu le 20 novembre 2026](https://platform.claude.com/docs/en/api/rate-limits) enterprise
- [OpenAI, Error codes, lu le 20 novembre 2026](https://developers.openai.com/api/docs/guides/error-codes) enterprise
- [Mistral AI, Error glossary, lu le 20 novembre 2026](https://docs.mistral.ai/resources/error-glossary) enterprise
- [Forum n8n, sortie d'erreur du nœud OpenAI v2 (17 novembre 2025), lu le 20 novembre 2026](https://community.n8n.io/t/why-does-continue-using-error-output-on-openai-v2-not-pass-the-full-error-body-to-the-next-node/222579) journal
- [Fixmation, n8n's error output routes by the shape of the item (octobre 2026), lu le 20 novembre 2026](https://fixmation.dev/blog/n8n-error-output-failed-item-in-success) journal
- [Kirako, Gestion des erreurs n8n : alertes et reprise (6 novembre 2026), lu le 20 novembre 2026](https://kirako.ai/blog/n8n-production-erreurs-alertes-surveillance) journal
- [Infinitelab, Gérer les erreurs dans n8n : Error Trigger et alertes (13 octobre 2026), lu le 20 novembre 2026](https://www.infinitelab.fr/blog/n8n-gestion-erreurs-workflow-error-trigger) journal


## 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.

[Classer mes tâches](/ressources/outils/grille-taches-a-automatiser)       À lire ensuite    [§ Blog · Automatisation

### Plafonner la dépense d'une API d'IA : OpenAI, Claude et Mistral



Où régler un plafond qui coupe vraiment chez OpenAI, Anthropic et Mistral, l'erreur que reçoit n8n ou Make, quel montant fixer : tableau et procédure.

 →](/blog/plafond-depense-api-ia)[§ Blog · Automatisation

### Clés API dans vos automatisations : sécuriser n8n, Make, Claude et OpenAI



Où ranger une clé API dans n8n ou Make, qui la voit, comment limiter ses droits et sa dépense, la faire tourner et la révoquer : procédure pour une PME.

 →](/blog/cles-api-automatisation-securite-pme)[§ Blog · Automatisation

### n8n c'est quoi ? Définition, usages et limites pour une PME



n8n c'est quoi : une plateforme d'automatisation de workflows, installable chez vous ou hébergée. Fonctionnement, exemple de PME, limites et coût.

 →](/blog/n8n-c-est-quoi)     § Auteur  [Simon BerosFondateur de Waimia · ingénieur IA et automatisation](/equipe/simon-beros)    § Audit IA

Ce que vous emportez : une cartographie écrite de vos tâches, avec les chantiers à lancer en premier.

 [Réserver l'audit gratuit →](/contact?offer=audit-ia-pme&intent=audit)

## 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 →](/contact?offer=audit-ia-pme&intent=audit)      Explorer aussi

## Sur le même sujet

     Services

- [Automatisation des processus](/services/automatisations)
   Guides et comparatifs

- [Guide : quelles tâches automatiser d'abord](/ressources/guides/taches-a-automatiser-pme)
- [Agent IA : définition et limites](/ressources/guides/agent-ia-definition)
- [LLM et RAG : définitions pour dirigeants](/ressources/guides/llm-rag-dirigeant)
   Cas concrets

- [Automatiser l'administratif](/cas-usages/standardiser-processus)
   À lire

- [Plafonner la dépense d'une API d'IA](/blog/plafond-depense-api-ia)
- [Clés API dans n8n et Make : les sécuriser](/blog/cles-api-automatisation-securite-pme)
- [Agent IA ou automatisation : choisir étape par étape](/blog/agent-ia-vs-automatisation-classique-2026)
