Tutoriel n8n débutant : créer sa première automatisation

Que prépare-t-on pour ce tutoriel n8n débutant ?

Préparez un espace n8n dans lequel vous pouvez créer et exécuter un workflow, c’est-à-dire un scénario reliant plusieurs étapes. Chaque étape est un nœud. Nous allons classer des demandes d’atelier pour une équipe : la priorité dépendra du budget disponible par participant et du fait que le dossier soit complet.

La règle de cet exercice fictif est volontairement simple :

• Budget par participant supérieur ou égal à 300 euros et dossier complet : statut « À contacter ».
• Dans tous les autres cas : statut « À examiner », pour une vérification humaine.

Le scénario comptera six nœuds : Manual Trigger, deux Edit Fields, If, puis un Edit Fields sur chacune des deux sorties. La documentation n8n sur les données de test confirme qu’Edit Fields convient à la création de petits jeux fictifs. Pour replacer l’outil dans votre projet, consultez notre comparatif des plateformes d’automatisation.

Comment créer le scénario et saisir une demande ?

Créez un workflow vide, ajoutez Manual Trigger, puis connectez un nœud Edit Fields (Set) pour saisir la première demande. Ce déclencheur démarre le scénario lorsque vous cliquez sur Execute Workflow. Il convient à cet apprentissage, car chaque essai reste sous votre contrôle et les résultats se consultent dans l’éditeur.

Créer le point de départ

1. Dans n8n, choisissez Create Workflow, ou Start from Scratch si l’écran d’accueil le propose.
2. Nommez le scénario « Qualification de demandes — exercice ».
3. Avec Add first step, recherchez et ajoutez Manual Trigger.
4. Depuis son connecteur de sortie, ajoutez Edit Fields (Set) et renommez-le « Demande fictive ».

Ces commandes suivent les principes du guide officiel de création d’un premier workflow. Le déclencheur Manual Trigger n’a pas de lancement automatique.

Renseigner les champs avec leur type

Dans « Demande fictive », choisissez Mode : Manual Mapping. Sous Fields to Set, ajoutez les champs suivants. Gardez les noms et les valeurs en mode Fixed, qui signifie « valeur saisie telle quelle ».

String désigne du texte, Number un nombre et Boolean une valeur vrai ou faux. Pour le dernier champ, sélectionnez la valeur vraie proposée. Saisissez les nombres sans symbole euro ni séparateur de milliers.

Revenez au scénario et cliquez sur Execute Workflow. Ouvrez « Demande fictive », puis OUTPUT, la sortie du nœud. Vous devez retrouver ces données dans la vue JSON, un format structuré par noms et valeurs :

{
  "id_demande": "DEMO-001",
  "budget_total": 2400,
  "participants": 6,
  "dossier_complet": true
}

Ce bloc représente le contenu d’un élément, appelé item dans n8n. La structure des données n8n permet de transmettre plusieurs éléments entre les nœuds ; ici, nous en traitons un par lancement. Les guillemets entourent le texte, pas les nombres ni le booléen.

Comment calculer le budget par participant ?

Ajoutez un deuxième Edit Fields après « Demande fictive » pour calculer le budget unitaire à partir des données reçues. Une expression est une formule évaluée pendant l’exécution. Elle permet de recalculer le résultat lorsque les valeurs changent, sans saisir manuellement un nouveau montant à chaque essai.

1. Renommez ce nœud « Calcul budget » et conservez Manual Mapping.
2. Ajoutez budget_par_personne, de type Number.
3. Passez sa valeur en mode Expression, puis collez la formule ci-dessous.
4. Activez Include Other Input Fields et choisissez All pour conserver les champs entrants.

{{ $json.participants > 0
  ? $json.budget_total / $json.participants
  : 0 }}

$json désigne les données entrantes de l’élément courant. La formule signifie : si le nombre de participants est positif, diviser le budget total par ce nombre ; sinon, renvoyer zéro. Ce zéro est une convention de l’exercice pour orienter le dossier vers un examen humain, pas un budget réel calculé.

Relancez Execute Workflow. La sortie de « Calcul budget » doit conserver les quatre champs initiaux et ajouter budget_par_personne: 400, car 2 400 ÷ 6 = 400. La documentation explique comment construire une expression à partir des données entrantes.

Sur certaines versions du nœud, la conservation des champs s’appelle Include in Output → All Input Fields. Ce réglage est décrit dans la documentation d’Edit Fields (Set).

Comment configurer la décision avec If ?

Le nœud If sépare les données entre une sortie vraie et une sortie fausse selon vos conditions. Ici, une demande doit satisfaire les deux critères pour être « À contacter ». Le budget seul ne suffit donc pas : un dossier incomplet reste à examiner, même avec un montant élevé.

Connectez If à « Calcul budget » et renommez-le « Demande prioritaire ? ». Dans Conditions, configurez :

1. Première valeur en mode Expression : {{ $json.budget_par_personne }}. Choisissez Number → is greater than or equal to, puis saisissez 300 comme seconde valeur fixe.
2. Avec Add condition, ajoutez {{ $json.dossier_complet }} en mode Expression. Choisissez Boolean → is true.
3. Entre les conditions, sélectionnez AND, qui signifie « toutes les conditions doivent être vraies ».

La référence officielle du nœud If détaille ces comparaisons. Avec OR, un seul critère suffirait, ce qui changerait la règle métier. Gardez également le seuil inclusif : « supérieur ou égal » accepte exactement 300 euros.

Relancez le workflow et ouvrez OUTPUT dans If. Pour DEMO-001, l’élément doit apparaître dans la sortie true, avec zéro élément dans false. Cette deuxième sortie vide est normale pour cet essai.

Comment afficher un résultat compréhensible ?

Ajoutez un Edit Fields sur chaque sortie de If pour attribuer un statut lisible à la demande. Ces nœuds produisent une donnée visible dans l’éditeur. Le libellé « À contacter » décrit une action à envisager : il ne provoque aucun envoi de message et ne confirme aucune réservation.

• Sur le connecteur true, ajoutez un Edit Fields nommé « À contacter ».
• Sur le connecteur false, ajoutez un autre Edit Fields nommé « À examiner ».
• Dans chacun, utilisez Manual Mapping et ajoutez statut en String, valeur Fixed : respectivement « À contacter » et « À examiner ».
• Dans les deux nœuds, conservez tous les champs entrants avec le même réglage que dans « Calcul budget ».

Après un nouveau lancement, ouvrez la sortie de « À contacter ». Voici le contenu attendu pour la première demande :

{
  "id_demande": "DEMO-001",
  "budget_total": 2400,
  "participants": 6,
  "dossier_complet": true,
  "budget_par_personne": 400,
  "statut": "À contacter"
}

Les données conservées permettent d’expliquer le classement.

Comment rejouer l’exercice et tester les deux branches ?

Changez les valeurs dans « Demande fictive », puis relancez le workflow entier pour tester chaque cas. Vérifiez la sortie de If et celle du nœud terminal emprunté pendant ce lancement. Un scénario réussi techniquement ne prouve pas que sa décision est correcte : comparez toujours le résultat à celui attendu.

Pour le deuxième essai, saisissez DEMO-002 et remplacez le budget total par 1200. Conservez six participants et un dossier complet. Cliquez sur Execute Workflow : 1 200 ÷ 6 = 200, donc false doit recevoir un élément. Dans « À examiner », vérifiez statut: "À examiner" et budget_par_personne: 200.

DEMO-003 contrôle le « et », DEMO-004 vérifie la limite incluse et DEMO-006 la valeur juste en dessous. Rejouez enfin DEMO-001 : vous devez retrouver « À contacter ».

Que vérifier si le résultat ne correspond pas ?

Recherchez le premier nœud dont les données divergent du résultat attendu. Comparez son entrée INPUT à sa sortie OUTPUT, en vérifiant les noms de champs et leurs types. Cette lecture progressive permet de distinguer une valeur mal saisie, un champ perdu et une condition incorrecte.

• Expression sans valeur : exécutez les étapes précédentes et contrôlez l’orthographe de budget_total et participants.
• Champs disparus : réactivez la conservation des données entrantes dans le nœud qui les a supprimées.
• Comparaison incorrecte : vérifiez Number, Boolean, AND et le seuil inclusif.
• Ancienne valeur réutilisée : si une sortie affiche des données épinglées, choisissez Unpin, puis relancez le scénario complet.

Les données épinglées dans n8n remplacent la sortie habituelle du nœud pendant les tests. Pour cet exercice, laissez-les désactivées afin que vos modifications soient prises en compte. Une branche vide, à elle seule, n’indique pas une erreur.

Quelle différence entre tester et lancer automatiquement ?

Tester lance le scénario depuis l’éditeur ; le fonctionnement automatique nécessite un déclencheur adapté et une version publiée. Manual Trigger reste manuel. Pour lancer un traitement à une heure définie, utilisez Schedule Trigger et contrôlez le fuseau horaire. La documentation actuelle emploie le bouton Publish pour la mise en production.

• Execute Workflow : lance le scénario entier depuis l’éditeur.
• Execute step : exécute une étape et les étapes précédentes nécessaires à ses données.
• Publish : met une version en production pour ses déclencheurs automatiques.

Consultez les types d’exécution n8n et le fonctionnement de Schedule Trigger. Planifier notre exercice ferait simplement rejouer la même demande fictive.

La sauvegarde du brouillon et sa publication sont distinctes : les modifications des nœuds restent en brouillon jusqu’à publication. Pensez à cette différence lorsque vous modifierez une règle déjà utilisée.

Comment adapter ce scénario à de vraies demandes ?

La prochaine étape consiste à remplacer la saisie fictive par une entrée réelle, puis à enregistrer le résultat. Conservez la règle et vos cas de test comme référence. Avant de connecter un outil, définissez quels champs sont obligatoires, qui examine les exceptions et comment reconnaître une demande déjà traitée.

• Recevoir un formulaire : le n8n Form Trigger crée une page et déclenche le scénario à l’envoi. Ses adresses de test et de production sont distinctes.
• Enregistrer dans un tableur : le nœud Google Sheets permet notamment d’ajouter ou de mettre à jour une ligne. Cette extension demande une connexion Google autorisée.
• Éviter les doublons : utilisez un identifiant stable. Remove Duplicates distingue les doublons du lot courant de ceux rencontrés lors d’exécutions précédentes. Testez aussi les reprises après erreur.
• Suivre les incidents : consultez les exécutions enregistrées dans Executions. Les réglages du workflow déterminent notamment la sauvegarde des succès, des échecs et des essais manuels.

Lors de l’ajout d’un formulaire, remplacez les valeurs fixes de « Demande fictive » par les champs reçus, puis vérifiez leurs types : sinon, chaque réponse serait écrasée par les données d’exercice. Gardez seulement les données utiles dans les journaux ; aucune clé de connexion ne doit figurer dans les champs ou les captures.

Votre prochain objectif : expliquer chaque sortie et refaire tous les essais sans hésiter. Vous pourrez ensuite consulter la formation Product Builder No Code & IA de DataSuits pour envisager un parcours accompagné.