# n8n : concepts fondamentaux, nœuds et automatisation

> Guide pratique complet sur n8n : de l'installation aux concepts de base (déclencheurs, nœuds, variables) jusqu'à la création de workflows IA autonomes sans limites.

n8n est un outil puissant et open source qui permet d’automatiser les tâches récurrentes et d’intégrer des applications sans nécessiter de compétences approfondies en programmation. Imaginez : les données de Google Sheets sont envoyées automatiquement dans Telegram, tandis que les notifications Trello arrivent par email — le tout sans efforts superflus. Il convient aussi bien aux débutants qu’aux professionnels souhaitant optimiser leurs workflows.

Ce guide vous aidera à maîtriser les bases de n8n : de l’installation à la création de vos premiers flux de travail. Nous examinerons les concepts clés et les étapes pour que vous puissiez commencer immédiatement à automatiser votre travail !

## 1. Interface de l’éditeur n8n

### Vue d’ensemble

L’éditeur s’articule autour du canvas (toile) — l’espace de travail principal pour construire des flux d’automatisation. C’est ici que sont accessibles tous les workflows, les identifiants et les ressources documentaires.

![Aperçu de l’interface du canvas Workflow Editor de n8n](/api/guides-media/automation/n8n-basics/images/945a2957d9ceafa9b50e624b97ee0467b809b7cf3af2f31b6e24d2d144721935.webp)

### Panneau gauche

1. Repérez le logo n8n dans le coin supérieur gauche.

2. Cliquez sur l’icône représentant un cercle avec une flèche sous le logo.

3. Un menu comprenant six sections s’ouvre :

● **Admin Panel** : pour les utilisateurs de n8n.cloud, gestion des paramètres de la plateforme.

● **Workflows** : création, sauvegarde et édition des processus.

● **Credentials** : configuration de l’authentification et des clés API pour les services externes.

● **Executions** : journal des exécutions complètes des processus (s’ouvre dans une nouvelle fenêtre ; les exécutions interrompues ne sont pas comptabilisées ici).

● **Help** : accès à la documentation officielle, au forum, à la bibliothèque de templates et aux informations de version.

● **Updates** : détails sur la version actuelle et les releases disponibles.

Dans la section Help, vous trouverez également un lien vers la communauté officielle des développeurs sur Discord — c’est là que vous pouvez obtenir des réponses pratiques à des questions non couvertes par la documentation de base.

### Barre supérieure

1. Dans le coin supérieur gauche, indiquez le nom du workflow actuel :

```
00n8n + Personal My workflow + Add tag
Inactive Share Save
```

2. Ajoutez des tags à côté du nom pour faciliter le tri par thème ou par projet.

3. Dans le coin supérieur droit, cliquez sur **Save** pour enregistrer le workflow.

4. Utilisez le toggle adjacent pour activer/désactiver le processus (disponible uniquement si un nœud trigger est présent).

Notez bien : un workflow non enregistré peut être perdu lors de la fermeture du navigateur — veillez impérativement à sauvegarder manuellement les modifications avant de fermer l’onglet.

### Canvas (Toile)

1. Le canvas est un fond gris avec une grille de coordonnées :

![Barre de navigation et contrôles des éléments du canvas n8n](/api/guides-media/automation/n8n-basics/images/2d1fe67e701cc13b428c977cd6eeace6e5bc264d990d25ce51f010c7986745f6.webp)

2. Repérez les cinq boutons de contrôle principaux :

● **+** et **-** dans la loupe pour ajuster le zoom.

● **←** pour réinitialiser rapidement le zoom à 100 %.

● **Execute Workflow** pour lancer manuellement le processus depuis le Start ou les triggers jusqu’au nœud final ou en cas d’erreur.

● Le **+** orange pour ouvrir la bibliothèque des nœuds disponibles.

3. Au centre se trouve le nœud initial **Start** avec une icône « Play » verte.

### Déplacement du canvas

1. Maintenez `Ctrl` (ou `Cmd` sur Mac) + clic gauche et faites glisser le canvas.

2. Ou utilisez deux doigts sur le trackpad pour un défilement fluide.

3. Le canvas prend entièrement en charge la souris : molette — zoom, clic droit — ouverture rapide du menu contextuel. Cela accélère considérablement la navigation dans les grands schémas.

## 2. Architecture et types de nœuds (Nodes)

### Bases des nœuds

1. Les nœuds sont les blocs de construction fondamentaux pour le traitement des données (entrée, transformation, sortie).

2. On distingue deux types principaux :

● **Regular node** : édite, transforme, interroge ou envoie des données.

● **Trigger node** : initie le processus et fournit les données initiales suite à un événement ou selon un planning.

Chaque nœud peut être configuré précisément selon la tâche : définir des paramètres, modifier des champs, connecter des variables d’environnement. En survolant la flèche de sortie, le nombre d’éléments de données transmis en aval dans la chaîne est affiché.

Les nœuds sont connectés en chaînes séquentielles — l’exécution progresse toujours de gauche à droite.

### Nœuds Core (principaux)

1. Utilisez-les pour les opérations de base : planification (**Schedule**, **Interval**) ou écriture de code personnalisé (**Code**, **Function**).

Les nœuds Code et Function permettent d’exécuter du JavaScript ou du Python personnalisé lorsque les nœuds standards prêts à l’emploi sont insuffisants.

Schedule définit un planning (par exemple, chaque jour à 09:00), tandis qu’Interval lance le processus toutes les N minutes. Ces nœuds constituent la fondation des automatisations qui ne dépendent pas de webhooks externes.

### Nœud Start

1. Apparaît automatiquement dans chaque nouveau workflow.

2. Il ne peut ni être supprimé ni dupliqué.

3. S’il n’est pas nécessaire, désactivez-le simplement et déplacez-le sur le côté en supprimant la ligne de connexion.

4. Pour plusieurs points de départ, ajoutez des nœuds trigger supplémentaires ou créez un processus distinct.

Même si Start n’est pas utilisé en mode production, il aide à tester manuellement certaines branches de la chaîne durant la phase de développement.

### Recherche et ajout de nœuds

1. Ouvrez le panneau d’ajout de nœuds de l’une des trois façons suivantes :

● Cliquez sur **+** dans le coin supérieur droit du canvas.

● Cliquez sur **+** à droite de la sortie de n’importe quel nœud.

● Faites glisser la ligne de connexion depuis le point de sortie d’un nœud vers la droite ou appuyez sur la touche `Tab`.

2. Le panneau contient des filtres par catégories : All, Regular, Trigger.

3. Les nœuds sont regroupés par domaines : Analytics, Communication, Development, Marketing, Sales, etc.

4. Saisissez le nom du service requis dans la barre de recherche.

Si vous ne connaissez pas le nom exact du service requis, saisissez des mots-clés généraux : `email`, `webhook`, `sheets`, `telegram` — n8n proposera automatiquement les intégrations pertinentes.

### Ajout de nœuds

1. Cliquez sur le nœud souhaité dans la liste du panneau.

2. Le nœud apparaît instantanément sur le canvas et se connecte au bloc précédemment sélectionné.

### Boutons sur le nœud

1. Survolez le nœud avec la souris :

![Menu contextuel des actions rapides sur un nœud (activation, suppression, test)](/api/guides-media/automation/n8n-basics/images/26e3b4d4948dfbe72a35ac527e7536f998d6b30be54ca0e21821a4fee0db08f7.webp)

2. Utilisez les icônes rapides :

● **Corbeille** : supprimer le nœud.

● **Pause** : désactiver/activer le nœud sans le supprimer.

● **Copier** : créer un duplicata avec tous les paramètres.

● **Play** : exécuter uniquement ce nœud spécifique pour un test rapide.

Après l’exécution du nœud, l’onglet **Output** s’ouvre, affichant visuellement la structure des données retournées.

### Déplacement du workflow

1. Sélectionnez tous les nœuds avec `Ctrl + A` (ou `Cmd + A`).

2. Faites glisser n’importe quel nœud sélectionné vers une nouvelle position sur le canvas.

## 3. Traitement des données : JSON, tableaux et Binary

Dans cette section, nous analyserons comment n8n structure et traite les flux d’informations.

### Types de données

Dans n8n, les données se divisent en deux formats : **JSON** et **Binary**.

1. **JSON** — format texte structuré, similaire à un dictionnaire. Il est utilisé pour transmettre des paramètres entre services (noms, prix, dates, listes de commandes).

2. **Binary** — données binaires non textuelles : images, documents PDF, enregistrements audio ou archives.

La grande majorité du temps, vous travaillerez avec JSON dans vos automatisations. Le résultat est toujours visible dans le panneau de résultats à droite de n’importe quel nœud, dans l’onglet « JSON ».

### Qu’est-ce que JSON ?

JSON stocke les informations sous forme de paires `« clé : valeur »` :

● Tous les objets sont entourés d’accolades `{}`.

● La clé et la valeur sont séparées par deux-points `:`, et les paires individuelles par des virgules `,`.

### Exemple simple

```json
{
    "name": "Емма"
}
```

Ici, `"name"` est le nom du champ (clé), et `"Emma"` est sa valeur. Toutes les chaînes de caractères doivent impérativement être entourées de guillemets doubles.

### Ajouter plus de détails

```json
{
  "name": "Емма",
  "age": 27,
  "is_smoking": false,
  "car": {
    "model": "Chevrolet Camaro",
    "color": "бежевий"
  },
  "pets": [
    {
      "type": "собака",
      "name": "Чарлі"
    },
    {
      "type": "хом'як",
      "name": "Ніксон"
    }
  ]
}
```

● `"age": 27` — un nombre, écrit sans guillemets.

● `"is_smoking": false` — une valeur booléenne (true/false), également sans guillemets.

● `"car"` — un objet JSON imbriqué.

● `"pets"` — un tableau (liste), encadré par des crochets `[]`.

### Qu’est-ce qu’un tableau ?

Un tableau est une liste ordonnée d’éléments. Il s’écrit entre crochets `[]` et peut contenir des textes, des nombres ou d’autres objets.

### Transmission des données entre nœuds

n8n transmet toujours les données sous forme de **tableau d’objets**. Par exemple :

```json
[
    {
        "name": "Емма",
        "age": 27
    },
    {
        "name": "Петро",
        "city": "Київ"
    }
]
```

Chaque élément du tableau est traité séquentiellement ou parallèlement par le nœud suivant.

### Qu’est-ce que Binary ?

Les données binaires sont stockées dans un objet de service spécial :

```json
"binaryKeyName": {
  "data": "...",
  "mimeType": "image/png",
  "fileExtension": "png",
  "fileName": "example.png"
}
```

Les octets du fichier eux-mêmes sont encodés au format Base64.

## 4. Connexion et interaction des nœuds

### Que peut faire un nœud ?

Un nœud est un bloc fonctionnel qui effectue une opération spécifique :

● Récupérer des données via l’API d’un service tiers.

● Envoyer une notification dans un chat Telegram, Discord ou par email.

● Télécharger, éditer ou sauvegarder un fichier.

Voici à quoi ressemble l’interface d’un nœud ouvert :

![Fenêtre des paramètres détaillés et de configuration d’un nœud individuel](/api/guides-media/automation/n8n-basics/images/2b2be28c4a62a182c63844ae7fed81d3bc2a99e65d25ac54aed907c8ec9da527.webp)

À l’intérieur se trouvent les onglets : **Parameters** (configuration de la logique), **Output** (données de sortie), **Settings** (timeouts, retries en cas d’erreurs).

### Connexion des nœuds

Les nœuds sont reliés par des flèches. Ce sont les routes par lesquelles circulent les informations :

● Une flèche peut se diviser depuis un nœud vers plusieurs autres (envoi parallèle).

● Plusieurs branches peuvent converger vers un nœud de fusion (**Merge**).

Schéma d’interaction de plusieurs nœuds :

![Schéma d’interaction des nœuds dans une chaîne d’automatisation n8n](/api/guides-media/automation/n8n-basics/images/a4a27cc18966b75486e57469136f1d4ffdb47e77b246a6a26bdf1995ad1f344b.webp)

## 5. Triggers : Webhook, Schedule et événements

### Qu’est-ce qu’un trigger ?

Un Trigger est un nœud de démarrage qui « éveille » le workflow lorsqu’un événement externe spécifique se produit.

### Principaux types de triggers

1. **Webhook** : déclenché lorsqu’une requête HTTP (GET, POST, etc.) arrive depuis un site ou une application externe.

2. **Schedule Trigger** : lancement périodique selon un planning ou une expression CRON :

![Configuration du nœud trigger Schedule Trigger pour un lancement périodique planifié](/api/guides-media/automation/n8n-basics/images/f498e65a269b87f0ac7c2dd49d2649d44c85a92f806fb9e58b4454d2e6858833.webp)

3. **App Triggers** : surveillance d’événements dans des services spécifiques (nouvelle ligne dans Google Sheets, nouveau lead dans un CRM ou réaction à un message dans Telegram).

## 6. Modes de fonctionnement : Test vs Production

n8n propose deux modes fondamentalement différents :

1. **Mode Test** — débogage interactif avec visualisation de chaque étape.

2. **Mode Production** — fonctionnement autonome en arrière-plan 24h/24.

## 7. Configuration et test pas à pas du Webhook

1. Ajoutez le nœud **Webhook** sur le canvas.

![Aperçu de l’interface du canvas Workflow Editor de n8n](/api/guides-media/automation/n8n-basics/images/945a2957d9ceafa9b50e624b97ee0467b809b7cf3af2f31b6e24d2d144721935.webp)

2. Ajoutez le nœud **Edit Fields (Set)** pour modifier les données :

![Sélection et ajout du nœud Edit Fields (Set) pour la transformation des données](/api/guides-media/automation/n8n-basics/images/2bda08fce1411acf15aae4e73e3afef4a3826381e86feb6d80206ba0267b6bc9.webp)

3. Configurez le champ `success` avec la valeur `true` :

![Configuration des champs de saisie et assignation des valeurs dans le nœud Set](/api/guides-media/automation/n8n-basics/images/861631d521613a4684ff9841ae60e409b4ba6ec6f686763abfeff957b95097e4.webp)

4. Cliquez sur **Test step / Listen for test event** :

![Lancement du test du nœud Webhook et génération de l’URL pour recevoir les données entrantes](/api/guides-media/automation/n8n-basics/images/96467279ae2b961ef1398cf07def9245f5fad26722d6fc8f51354c6c2d08deef.webp)

5. Copiez l’**Test URL** généré :

![Copie de l’URL de test du webhook pour envoyer une requête via le navigateur ou curl](/api/guides-media/automation/n8n-basics/images/46a18e8ca341a5ba5f5d09bfdabdd828291abb120f2986a78ec379e4efde26ad.webp)

6. Envoyez une requête via le navigateur, Postman ou cURL. En réponse, n8n renverra le JSON généré :

![Affichage de la réponse JSON réussie de n8n dans la fenêtre du navigateur](/api/guides-media/automation/n8n-basics/images/8cdcd70d7e337cfa1e48698c298e7807d3022e6777d7a3d6aeb698ef66e898de.webp)

7. Modifiez les paramètres et relancez le test pour vérifier la correction de la transformation :

![Nouveau test avec valeurs de paramètres modifiées et validation des données mises à jour](/api/guides-media/automation/n8n-basics/images/4c2be16352c2179afa475af6ee5b08420c03ca0755bc7c4ade41b6d5858d8962.webp)

## 8. Passage en mode Production

Une fois le workflow testé :

1. Ouvrez le nœud Webhook et copiez l’**Production URL** :

![Obtention de l’URL de production fonctionnelle pour le lancement réel du webhook dans n8n](/api/guides-media/automation/n8n-basics/images/4b429613856c10cd6548da729388b9715e6393c267f22db2055da47ee148bc21.webp)

2. Activez le toggle dans la barre supérieure en position **Active** :

![Activation du workflow via le switch dans la barre de contrôle supérieure de n8n](/api/guides-media/automation/n8n-basics/images/197596a4c909ccae9482a36bfa6e9ac719bae2099230ee7545e27e0d347167da.webp)

3. Désormais, n8n traitera tous les appels entrants réels en arrière-plan, et l’historique des exécutions peut être consulté dans la section **Executions**.

## 9. Conclusion et conseils pratiques

Vous avez maîtrisé les concepts fondamentaux de n8n : l’architecture du canvas, les types de nœuds, la transmission des structures JSON, les triggers et la bascule entre environnements de test et de production. C’est une base solide pour construire des agents IA autonomes complexes et automatiser n’importe quel processus métier !