Automatisation des commandes avec n8n : tutoriel d’intégration de l’API Claude

Scénario : répondre manuellement aux messages de commande chaque jour, impossible de suivre

Dans les commerces locaux comme la restauration, le commerce de détail ou les achats groupés de quartier, les messages de commande arrivent presque toujours dans WeChat, via un formulaire ou dans le back-office de la boutique. Le schéma est très fixe : une nouvelle commande arrive, on jette un œil au contenu, on détermine s’il s’agit d’une commande classique ou d’une réclamation, puis on répond par un message de confirmation. Quand le volume est faible, ce n’est pas un problème ; dès que le volume augmente, l’essentiel du temps passe en réponses répétitives.

L’objectif de ce tutoriel est précis : construire avec n8n un pipeline automatisé où, à l’arrivée d’une nouvelle commande, l’IA détermine automatiquement l’intention et génère une réponse ; les commandes standard reçoivent une réponse automatique, les réclamations sont transmises à un humain pour traitement, avec une notification. Aucun code à écrire : pour connecter le modèle, il suffit d’une clé API HiAPI.

Depuis 2026, n8n est régulièrement recommandé aux petites et moyennes entreprises dans plusieurs panoramas d’outils d’automatisation (par exemple les bilans annuels 2026 d’Atlassian et de techaigoz), pour une raison simple : auto-hébergement, open source, écosystème de nœuds LLM mature. En octobre 2026, une publication sur X montrant l’utilisation de n8n pour automatiser la prise de commandes de petits commerces locaux a atteint environ 51 000 vues sur un seul post, ce qui montre que ce besoin est déjà très répandu.

Préparation : une clé HiAPI + une instance n8n

Deux éléments suffisent pour commencer.

Premièrement, la clé API HiAPI. Créez-la dans la console HiAPI et copiez-la ; son format commence par sk-. Cette clé est compatible OpenAI ; tous les modèles utilisés ensuite dans n8n passeront par elle.

Deuxièmement, n8n. Version cloud ou auto-hébergée, peu importe : ce tutoriel ne privilégie aucun mode de déploiement. La seule exigence est de ne pas utiliser une version trop ancienne, pour la raison expliquée plus bas.

L’étape clé : connecter le nœud OpenAI Chat Model à HiAPI

Le point central de tout le pipeline est de connecter n8n au modèle. La méthode est plus simple qu’on ne l’imagine : dans l’écosystème de nœuds IA de n8n, il existe un sous-nœud OpenAI Chat Model dont les Credential comportent un champ Base URL ; il suffit d’y renseigner le point de terminaison compatible OpenAI et la clé API pour l’utiliser (cette possibilité est discutée depuis longtemps dans la communauté n8n, voir le fil Override baseURL for OpenAI Node).

Concrètement, renseignez trois éléments :

1. Base URL : https://api.hiapi.ai
2. API Key : votre clé HiAPI (commençant par sk-)
3. Model : saisissez manuellement deepseek-v4.1-flash

Deux points d’attention. Premièrement, il faut utiliser le sous-nœud OpenAI Chat Model de l’écosystème de nœuds IA, pas l’ancien nœud OpenAI. Deuxièmement, le champ Base URL n’existe que dans les versions récentes de n8n ; certaines anciennes versions ne l’ont pas. Mettez d’abord n8n à niveau vers une version récente avant de configurer.

Une fois renseigné, tous les nœuds IA du workflow partagent ce même Credential. Pour changer ensuite de modèle, il suffit de modifier le champ Model, par exemple remplacer par claude-opus-4-8 pour les réclamations, sans toucher à la clé.

Le modèle est maintenant connecté. Passons au workflow lui-même.

Workflow en quatre étapes

Tout le pipeline s’enchaîne en quatre nœuds : déclenchement Webhook, classification et rédaction de réponse par l’IA, branchement IF, notification.

1. Déclenchement Webhook

Utilisez un nœud Webhook comme point d’entrée : lorsque le système de commandes (formulaire, back-office de la boutique, bot relais) reçoit une nouvelle commande, il envoie le contenu du message en POST à cette adresse. Le texte de commande reçu par le déclencheur est transmis au nœud IA suivant.

Si vous n’avez pas encore d’intégration système, vous pouvez d’abord simuler manuellement une nouvelle commande avec le nœud de déclenchement par formulaire de n8n, valider le fonctionnement du flux, puis passer à une vraie source de données.

2. Nœud IA : classification + rédaction de réponse

Ajoutez un nœud AI Agent (ou un nœud Chain simplifié), associez-y le Credential OpenAI Chat Model configuré précédemment et renseignez le modèle deepseek-v4.1-flash. Le prompt système se charge de deux choses : déterminer si le message est une commande classique ou une réclamation, puis rédiger une réponse dans le ton du commerçant selon le cas.

Voici un prompt système directement utilisable ; remplacez simplement le nom de votre boutique et votre catégorie pour qu’il fonctionne :

Tu es l’assistant de prise de commandes d’un restaurant local. Traite chaque message utilisateur selon les règles suivantes :

1. Détermine d’abord le type de message :
   - Commande classique : l’utilisateur passe explicitement une commande, avec produit, quantité, adresse ou mode de retrait
   - Réclamation : l’utilisateur exprime son mécontentement vis-à-vis d’un produit ou d’un service, demande un remboursement ou dépose une plainte
   - Autre : demande d’horaires, de menu ou tout autre contenu ne nécessitant pas de réponse immédiate

2. Génère ensuite une réponse selon le type :
   - Commande classique : confirme le contenu de la commande dans le ton du commerçant, reprends les produits et quantités, indique le délai de préparation ou de livraison prévu, avec un ton chaleureux et naturel
   - Réclamation : exprime d’abord des excuses et l’importance accordée au problème, indique qu’un traitement humain sera effectué dès que possible, sans promettre de solution d’indemnisation précise
   - Autre : réponds normalement à la question de l’utilisateur

3. Le format de sortie doit être strictement du JSON, avec deux champs :
   - category : order / complaint / other
   - reply : le texte de réponse rédigé

Ne produis que du JSON, sans aucune explication.

L’exigence d’une sortie JSON structurée par l’IA est essentielle pour que le branchement IF suivant puisse décider de manière fiable. Si la sortie n’est parfois pas standard, ajoutez après le nœud IA une simple étape de nettoyage des données comme filet de sécurité.

3. Branchement IF : réponse automatique aux commandes standard, escalade humaine pour les réclamations

Utilisez un nœud IF pour lire le champ category :

• order ou other : passer en réponse automatique, envoyer le texte reply au client via votre canal de notification (bot WeChat, e-mail ou SMS, selon ce que vous avez connecté)
• complaint : ne pas répondre automatiquement, envoyer au propriétaire ou à la personne de permanence le texte de commande original et le résultat de classification, avec un script de traitement suggéré, en attendant qu’un humain prenne le relais

Ce routage constitue la valeur de tout le pipeline. L’IA absorbe la majorité des messages de confirmation répétitifs ; l’humain ne traite que les réclamations, qui demandent discernement et empathie.

4. Nœud de notification

Enfin, ajoutez un nœud de notification pour envoyer le résultat du traitement à votre outil de collaboration (Feishu, WeChat ou e-mail, au choix). Pour une commande standard, notifier qu’une réponse automatique a été envoyée ; pour une réclamation, notifier les informations complètes de la commande et marquer « en attente de traitement humain ». Ainsi, même sans surveiller l’historique d’exécution du pipeline, vous savez en temps réel ce qui se passe dans la boutique.

Maîtrise des coûts : flash pour le courant, opus pour le complexe

Choisir le modèle selon la tâche est la clé pour maîtriser les coûts de ce flux ; il n’est pas nécessaire d’utiliser le plus cher pour toutes les requêtes.

• Classification et réponses courantes : utiliser deepseek-v4.1-flash, entrée 0,44 $ / million de tokens, sortie 1,32 $ / million de tokens (tarif de la plateforme HiAPI, au 2026-10). Les messages de commande font généralement quelques centaines de tokens ; le coût de modèle par commande est très faible, estimé à moins de 1 centime
• Analyse de réclamations, résumés de longs contextes et autres scénarios complexes : passer à claude-opus-4-8, entrée 2,29 $ / million de tokens, sortie 11,47 $ / million de tokens (au 2026-10). La part des réclamations étant faible, l’impact sur le coût total reste limité

Nous nous arrêtons là sur les prix ; pour le détail tarifaire, consultez la page du modèle. Pour comprendre plus en profondeur pourquoi le choix du modèle selon la tâche permet d’économiser, vous pouvez lire notre article précédent Pratique de routage automatique des modèles dans Notion AI, qui présente une démarche complète de distribution des requêtes vers différents modèles selon la tâche, avec la même logique que le scénario de prise de commandes de cet article.

FAQ

La clé API est-elle sécurisée dans n8n ?

La clé doit être renseignée dans les Credential (identifiants) de n8n, pas directement dans les paramètres ou le code des nœuds. Les Credential sont stockés de manière chiffrée par n8n, et l’export/partage d’un workflow n’inclut pas la clé. Il est également recommandé de définir une limite d’usage pour cette clé dans la console HiAPI : même en cas de fuite, les pertes restent maîtrisées.

Que faire en cas de 429 (trop de requêtes) ?

Le code 429 indique un déclenchement du limiteur de débit. Vérifiez d’abord si un grand lot de commandes a été injecté en peu de temps ; vous pouvez espacer le déclenchement ou ajouter une file d’attente au nœud IA. Si le problème persiste, consultez dans la console HiAPI les réglages de concurrence et de quota de la clé actuelle, et ajustez l’offre si nécessaire. Dans le workflow, vous pouvez aussi configurer une stratégie de retry pour le nœud IA : en cas de 429, attendre puis réessayer automatiquement.

Peut-on changer de modèle ?

Oui. Remplacez le champ Model par le nom de n’importe quel modèle disponible sur HiAPI, par exemple deepseek-v4.1-flash pour les commandes standard et claude-opus-4-8 pour les réclamations ; la clé et la Base URL n’ont pas besoin d’être modifiées. Une seule clé fonctionne pour tous les modèles : c’est précisément l’avantage de HiAPI par rapport à la demande séparée de clés officielles chez chaque fournisseur.

Quelle différence avec une demande directe de clé API officielle ?

Deux points principaux. Premièrement, une clé HiAPI couvre plusieurs modèles : pas besoin de s’inscrire, recharger et gérer séparément les quotas sur chaque plateforme officielle. Deuxièmement, la facturation à l’usage est unifiée, ce qui est plus avantageux lorsque les appels sont répartis sur plusieurs modèles. Pour les petites et moyennes entreprises, le coût de gestion compte davantage que la différence de prix unitaire.

L’absence de streaming est-elle un problème ?

Non. Ce pipeline traite les commandes de manière asynchrone : la réponse générée par l’IA peut être renvoyée en une seule fois, sans besoin d’affichage caractère par caractère comme dans une interface de chat. Le streaming ou non n’affecte pas le résultat.

Que faire si le champ Base URL n’existe pas dans n8n ?

Cela signifie que votre version de n8n est trop ancienne. Base URL est un paramètre du sous-nœud OpenAI Chat Model de l’écosystème de nœuds IA, disponible seulement dans les versions récentes. Mettez d’abord n8n à niveau vers une version récente, puis suivez les étapes de configuration des Credential ci-dessus.

Points clés à retenir

• L’intégration se résume à modifier un seul Credential : Base URL = https://api.hiapi.ai, API Key = clé HiAPI, nom du modèle saisi manuellement deepseek-v4.1-flash, sans écrire de code.
• La classification et la rédaction de la réponse sont réalisées dans un seul appel IA, avec un format de sortie JSON strict, afin que le branchement IF suivant puisse décider de manière fiable.
• Les commandes standard reçoivent une réponse automatique ; chaque réclamation est escaladée à un humain : cette limite est appliquée par le branchement IF.
• Dépensez selon la difficulté : flash pour les commandes courantes, claude-opus-4-8 pour les messages difficiles, avec une même clé et un simple changement de nom de modèle.
• La clé est gérée de manière centralisée dans les Credential n8n ; en cas de 429, faire des retries différés ; changer de modèle ne nécessite qu’une modification.