Un workflow n8n qui marche avec 20 lignes de test peut casser net le jour où on lui envoie tout un fichier clients. La cause est presque toujours la même : n8n envoie les requêtes aussi vite qu'il peut, l'API en face (CRM, WhatsApp, LLM, Google Sheets…) applique une limite de débit, et répond 429 Too Many Requests. Résultat : une partie des lignes passe, une autre non, et on ne sait plus lesquelles.
Ce tutoriel montre comment traiter de gros volumes proprement : découper en lots, ralentir volontairement, réessayer intelligemment et garder une trace de ce qui a été traité. Les noms exacts des options peuvent varier légèrement selon votre version de n8n ; la logique reste la même.
Comprendre le problème
Par défaut, un nœud reçoit tous les items et les traite les uns après les autres, sans pause. Avec 3 000 contacts, cela fait 3 000 appels en rafale. Chaque API a ses propres règles (par seconde, par minute, par jour, par jeton consommé pour les LLM) : lisez toujours la documentation du service pour connaître la vôtre, au lieu de deviner.
Trois outils de n8n suffisent pour la plupart des cas :
- les options de batching du nœud HTTP Request ;
- le nœud Loop Over Items (anciennement Split in Batches) combiné à un nœud Wait ;
- les réglages Retry On Fail et la gestion d'erreur du nœud.
Option 1 — Le batching intégré du nœud HTTP Request
Si vous appelez l'API via un nœud HTTP Request, ouvrez Options → Batching :
- Items per Batch : combien de requêtes envoyer d'un coup (par exemple 10) ;
- Batch Interval (ms) : la pause entre deux lots (par exemple 1000 ms).
C'est la solution la plus simple : aucun nœud supplémentaire, et le débit devient prévisible. Calculez votre réglage à partir de la limite documentée de l'API, en gardant une marge.
Option 2 — Loop Over Items + Wait
Quand l'appel passe par un nœud d'intégration (CRM, Google Sheets, nœud OpenAI…) qui n'a pas d'option de batching, ou quand chaque lot contient plusieurs étapes, utilisez une boucle explicite :
[Source des données]
↓
[Loop Over Items] (Batch Size : 20)
├─ loop → [Traitement du lot] → [Wait 2 s] → retour vers Loop Over Items
└─ done → [Récapitulatif]
- Loop Over Items sort un lot à la fois sur la branche loop.
- Le nœud Wait (mode « After Time Interval ») impose la pause entre deux lots.
- La sortie de Wait revient sur l'entrée de Loop Over Items, qui envoie le lot suivant.
- Quand tout est traité, la branche done reçoit l'ensemble des résultats : c'est l'endroit idéal pour un résumé (nombre de succès, nombre d'échecs).
Astuce : pour un agent IA ou un appel LLM qui résume ou classe des textes, un lot plus petit (5 à 10) est souvent plus sûr, car les limites portent aussi sur le nombre de jetons.
Option 3 — Réessayer sans tout casser
Dans les Settings du nœud qui appelle l'API :
- activez Retry On Fail ;
- réglez Max Tries (par exemple 3) et Wait Between Tries (ms) (par exemple 5000) pour laisser à l'API le temps de « refroidir » ;
- choisissez On Error → Continue (using error output) : les items en échec partent sur une sortie séparée au lieu d'arrêter tout le workflow.
Sur cette sortie d'erreur, ajoutez un nœud qui écrit l'item et le message d'erreur dans une table ou une feuille « à reprendre ». Vous savez exactement quelles lignes relancer, sans retraiter celles qui ont déjà réussi.
Certaines API renvoient un en-tête Retry-After avec un 429. Si vous voulez le respecter précisément, activez l'option de réponse complète (headers inclus) du nœud HTTP Request, lisez cette valeur et alimentez dynamiquement la durée d'un nœud Wait.
Option 4 — Rendre le traitement reprenable
Sur de gros volumes, une interruption finira par arriver (redémarrage du serveur, jeton expiré). Pour ne pas tout recommencer :
- ajoutez une colonne statut (
à traiter,ok,erreur) à votre source ; - le workflow ne lit que les lignes
à traiter; - chaque lot réussi met à jour son statut à
ok.
Le workflow devient idempotent : le relancer ne crée pas de doublons, il reprend simplement là où il s'était arrêté. C'est aussi ce qui permet de le planifier avec un Schedule Trigger qui traite, par exemple, quelques centaines de lignes à chaque passage.
Et avec un agent IA ?
Si un agent IA déclenche lui-même des actions en boucle (envoyer des messages, créer des fiches), ne lui laissez pas gérer le débit. Donnez-lui plutôt un outil (un sous-workflow) qui met les demandes en file dans une table, et laissez un workflow séparé, avec Loop Over Items et Wait, vider cette file à un rythme maîtrisé. L'agent décide quoi faire ; le workflow contrôle à quelle vitesse.
Récapitulatif
- Lisez la limite documentée de l'API avant de régler quoi que ce soit.
- HTTP Request : utilisez les options Batching (items par lot + intervalle).
- Autres nœuds : Loop Over Items + Wait, avec un résumé sur la branche done.
- Retry On Fail + sortie d'erreur pour isoler les échecs au lieu de tout arrêter.
- Une colonne de statut rend le traitement reprenable et sans doublons.
Chez Flux Intelligent, nous appliquons ces garde-fous dans les automatisations et agents IA que nous mettons en place pour des PME au Maroc. Si vous avez un cas de limite d'API qui résiste, décrivez-le en commentaire.
Top comments (0)