Tutoriel n8n (2026) : créez votre premier workflow pas à pas
komasu Tools est soutenu par ses lecteurs. Nous pouvons percevoir une commission d'affiliation lorsque vous achetez via nos liens, ce qui nous permet de proposer nos recherches gratuitement. Comment nous gagnons de l'argent
Un workflow n8n Cloud publié, qui s'exécute selon une planification, récupère des données depuis une API, ne garde que les éléments qui vous intéressent et les publie dans un canal Slack.
Essayer n8n gratuitementCe que vous allez construire
Dans ce tutoriel, vous construisez sur n8n Cloud une petite automatisation réaliste. Chaque matin, elle récupère une liste d'enregistrements depuis une API, ne garde que ceux qui répondent à une condition et publie chaque correspondance dans un canal Slack. Pensez à de nouvelles commandes au-dessus d'une certaine valeur, à des tickets de support ouverts ou à des tâches à rendre aujourd'hui.
Le workflow utilise quatre nodes, tous issus de la documentation officielle de n8n :
- Schedule Trigger lance le workflow à une heure fixée.
- HTTP Request appelle l'API et renvoie ses données.
- Filter ne garde que les items qui remplissent votre condition.
- Slack envoie un message pour chaque item restant.
En chemin, vous apprendrez les notions centrales de n8n : un workflow est l'automatisation entière, un node est une étape, et les données circulent entre les nodes sous forme de liste d'items. Une exécution est un passage du workflow entier, ce qui est aussi la façon dont n8n Cloud compte l'usage.
Avant de commencer
Il vous faut trois choses :
- Un compte n8n Cloud. Selon n8n, l'essai de 14 jours ne demande pas de carte bancaire et inclut les fonctions Pro avec 1 000 exécutions. C'est bien plus que ce que consomme ce tutoriel. Démarrer un essai gratuit de n8n Cloud.
- Une API qui renvoie du JSON. Ce peut être votre boutique, votre outil de support ou de gestion de projet, ou n'importe quelle API publique. Il vous faut son URL et, si elle en exige une, une clé d'API. Regardez une fois la réponse dans votre navigateur ou dans la documentation de l'API pour connaître les noms des champs.
- Un espace de travail Slack où vous avez le droit d'ajouter des applications, et un canal pour les messages de test.
Si vous préférez l'e-mail, vous pouvez remplacer Slack par le node Gmail à l'étape 5. Le reste ne change pas.
Si vous hésitez encore sur le fait que n8n soit le bon outil, lisez d'abord notre test de n8n.
Étape 1 : créer un nouveau workflow
Connectez-vous à n8n Cloud. Dans le menu de gauche, sélectionnez Personal, puis Create workflow. Vous voyez maintenant un canevas vide, la zone où vous placez et reliez les nodes.
Donnez au workflow un nom clair, comme « Daily filtered report to Slack ». Les noms comptent dès que vous avez des dizaines de workflows, et ils apparaissent dans les alertes d'erreur.
n8n propose aussi un Assistant intégré qui peut construire un workflow à partir d'une consigne dans un chat. Il est utile plus tard, mais construire à la main la première fois vous apprend comment les pièces s'articulent.
Étape 2 : ajouter un Schedule Trigger
Tout workflow commence par un node déclencheur. Sélectionnez Add first step, puis choisissez On a schedule. Cela ajoute le node Schedule Trigger.
Dans les réglages du node, gardez l'intervalle en jours et réglez Trigger at Hour sur l'heure voulue, par exemple 8 h. La planification utilise le fuseau horaire de votre instance n8n : vérifiez qu'il correspond au vôtre.
Renommez le node avec un nom descriptif, comme « Every day at 8 AM ». Fermez le panneau pour revenir au canevas.
Étape 3 : récupérer des données avec le node HTTP Request
Sélectionnez le bouton + sur le côté droit du node déclencheur. Dans Search nodes, saisissez « http » et choisissez HTTP Request.
Réglez la méthode sur GET et collez l'adresse de votre API dans le champ URL. Si l'API demande une authentification, choisissez-la dans les réglages d'authentification et enregistrez la clé comme credential (identifiant). Les identifiants sont enregistrés séparément du workflow : la clé n'apparaît donc pas dans le node lui-même et peut être réutilisée.
Sélectionnez maintenant Execute step. n8n appelle l'API une fois et affiche le résultat dans le panneau de sortie. Si la réponse est une liste, vous devriez voir plusieurs items. Si votre liste est imbriquée dans un champ d'un objet unique (par exemple data ou results), ajoutez un node Split Out après celui-ci et pointez-le vers ce champ pour que chaque enregistrement devienne son propre item.
Renommez le node, par exemple « Get records ». Exécuter une étape et regarder sa sortie réelle avant de continuer est l'habitude la plus utile de n8n.
Étape 4 : ne garder que l'essentiel avec le node Filter
Ajoutez un node après HTTP Request et cherchez Filter. D'après la documentation de n8n, le node Filter transmet les items qui remplissent une condition et écarte les autres.
Configurez la condition :
- Dans le premier champ de valeur, référencez un champ de l'entrée. Ouvrez le panneau d'entrée à gauche et faites glisser le champ (par exemple
statusouamount) dans la zone de valeur. n8n écrit une expression comme{{ $json.status }}, qu'il remplace par la vraie valeur de chaque item au moment de l'exécution. - Utilisez la liste déroulante du type de données pour choisir le type et la comparaison, comme String avec « is equal to », ou Number avec « is greater than ».
- Saisissez la valeur de comparaison, comme
openou100.
Pour ajouter d'autres règles, sélectionnez Add condition et choisissez AND (toutes les conditions doivent correspondre) ou OR (une seule condition peut correspondre). Vous ne pouvez pas mélanger AND et OR dans un même node Filter. Dans les options, Ignore Case rend les comparaisons de texte insensibles à la casse, et Less Strict Type Validation aide si vous voyez une erreur de type incorrect (« wrong type »).
Sélectionnez à nouveau Execute step. La sortie ne devrait plus contenir que les items correspondants. Si elle est vide, vérifiez votre condition par rapport aux données d'entrée avant de continuer.
Étape 5 : publier chaque correspondance sur Slack
Ajoutez un node après Filter et cherchez Slack. Pour l'action, choisissez la ressource Message avec l'opération Send, qui publie un message dans un canal.
Connectez ensuite votre compte Slack. Le node Slack prend en charge l'authentification OAuth2 et par jeton d'accès. Créez un nouvel identifiant depuis le node et suivez les étapes de la page des identifiants Slack de n8n. Si vous configurez votre propre application Slack, assurez-vous qu'elle a les permissions (scopes) que la documentation indique pour envoyer des messages.
Choisissez ensuite le canal et rédigez le texte du message. Mélangez du texte fixe et des expressions de l'entrée, par exemple :
New item: {{ $json.name }} (status: {{ $json.status }})
Utilisez les noms de champs de vos propres données. n8n exécute le node Slack une fois par item entrant : trois items filtrés produisent donc trois messages.
Sélectionnez Execute step et vérifiez le canal Slack. Quand les messages de test vous conviennent, renommez le node en « Post to Slack ».
Étape 6 : tester tout le workflow et le publier
Jusqu'ici, vous avez testé un node à la fois. Sélectionnez maintenant Execute sous le canevas pour exécuter tout le workflow à partir du déclencheur. Chaque node devrait afficher une coche verte en cas de succès.
Un workflow testé ne s'exécute pas encore tout seul. Pour activer la planification, sélectionnez Publish dans l'en-tête du canevas. À partir de là, n8n lance le workflow automatiquement à l'heure définie à l'étape 2, et chaque passage compte pour une exécution.
Si vous modifiez le workflow plus tard, pensez à le publier à nouveau pour que la version en service prenne en compte vos modifications.
Étape 7 : consulter les exécutions et ajouter une alerte d'erreur
Ouvrez l'onglet des exécutions du workflow pour voir les passages précédents, si chacun a réussi, et les données qui ont traversé chaque node. C'est là qu'il faut regarder en premier quand quelque chose ne va pas.
Pour un filet de sécurité, créez un second workflow qui commence par le node Error Trigger et envoie un message Slack ou un e-mail avec les détails de l'erreur. Ouvrez ensuite votre workflow principal, allez dans Options > Settings, et choisissez ce workflow sous Error workflow. D'après la documentation de n8n, le workflow d'erreur reçoit l'identifiant de l'exécution échouée, le message d'erreur et le dernier node exécuté, et un même workflow d'erreur peut servir à de nombreux workflows.
Étape 8 (facultative) : exécuter n8n vous-même avec Docker
n8n Cloud est le moyen le plus simple de démarrer, mais vous pouvez aussi auto-héberger la Community Edition gratuite. Sa licence est la Sustainable Use License, qui autorise l'usage interne à l'entreprise, personnel et non commercial. La documentation de n8n avertit que l'auto-hébergement exige des connaissances techniques, et que des erreurs peuvent entraîner des pertes de données, des problèmes de sécurité et des interruptions de service.
Pour un test en local, la documentation décrit cette configuration avec Docker Desktop installé :
- Créez un volume pour que vos données survivent aux redémarrages :
docker volume create n8n_data - Démarrez n8n avec l'image officielle, en mappant le port 5678 et en montant le volume :
docker run -it --rm --name n8n -p 5678:5678 -e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" -e TZ="<YOUR_TIMEZONE>" -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true -v n8n_data:/home/node/.n8n n8nio/n8n - Ouvrez
http://localhost:5678dans votre navigateur.
Remplacez <YOUR_TIMEZONE> par un nom de fuseau horaire comme America/New_York. Pour tout ce qui dépasse un test en local, la documentation de n8n recommande plutôt l'installation avec Docker Compose, et vous êtes responsable des mises à jour, des sauvegardes et du HTTPS. Certaines fonctions d'équipe, comme les projets et le SSO, ne font pas partie de la Community Edition.
Erreurs courantes
- Tester sans jamais publier. Execute n'exécute le workflow qu'une seule fois. Tant que vous ne sélectionnez pas Publish, le Schedule Trigger ne se déclenchera pas.
- Ignorer les items. n8n traite chaque item qui atteint un node. Si l'API renvoie 50 enregistrements et que votre filtre est faux, Slack reçoit 50 messages.
- Référencer des champs qui n'existent pas. Une expression comme
{{ $json.amount }}ne renvoie rien si le champ s'appelletotal. Faites toujours glisser les champs depuis le panneau d'entrée au lieu de les saisir. - Les listes imbriquées. Si tous les enregistrements arrivent comme un seul item, la liste est imbriquée dans un champ. Ajoutez un node Split Out avant le Filter.
- Mauvais fuseau horaire. Une planification qui se déclenche à la « mauvaise » heure signifie généralement que le fuseau horaire de l'instance diffère du vôtre.
- Écrire les clés d'API en dur. Enregistrez les clés comme identifiants, pas dans des URL ni dans le texte des messages.
Prochaines étapes
Vous avez maintenant un workflow publié qui s'exécute chaque matin et ne rapporte que l'essentiel. À partir de là, essayez d'ajouter un node If pour envoyer des messages différents selon les cas, ou remplacez Slack par Gmail pour un récapitulatif par e-mail. La bibliothèque de modèles de n8n est aussi un bon endroit pour voir comment d'autres structurent des flux similaires.
Si vous voulez comparer n8n à d'autres outils avant de construire davantage, lisez Make contre n8n et Zapier contre n8n, ou suivez notre tutoriel Make pour y construire le même genre de workflow.
Continuer à construire avec n8n
Questions fréquentes
Dois-je savoir coder pour suivre ce tutoriel ?
Non. Chaque étape utilise les nodes visuels et les champs de formulaire de n8n. Vous saisirez quelques expressions courtes, mais aucun code.
L'essai de n8n Cloud coûte-t-il quelque chose ?
Selon n8n, l'essai Cloud de 14 jours ne demande pas de carte bancaire et inclut les fonctions Pro avec 1 000 exécutions. Si vous ne passez pas à une formule payante, l'essai se termine automatiquement.
Combien d'exécutions ce workflow consomme-t-il ?
Une par passage. n8n compte une exécution comme un seul passage du workflow entier, quel que soit son nombre de nodes : une planification quotidienne consomme donc environ 30 exécutions par mois.
Quelle est la différence entre Execute et Publish ?
Execute exécute le workflow une fois pour que vous puissiez le tester. Publish le met en service : le Schedule Trigger le lance alors automatiquement aux heures que vous avez définies.
Puis-je envoyer un e-mail au lieu d'un message Slack ?
Oui. Remplacez le node Slack par le node Gmail ou un autre node d'e-mail et mappez les mêmes champs dans le message.
Puis-je exécuter ce workflow sur mon propre serveur ?
Oui. Vous pouvez auto-héberger la Community Edition de n8n avec Docker, comme décrit à la dernière étape, et y importer ou y reconstruire le workflow.
Voir l'historique des mises à jour de cet article
- Première publication.