Introduction

n8n (prononcé « n-huit-n » ou simplement « nodemation ») est un outil open source d'automatisation de workflows qui vous permet de connecter différents services et API grâce à un éditeur visuel basé sur des nœuds. Au lieu d'écrire manuellement du code de liaison, vous glissez-déposez des nœuds sur un canvas, vous les configurez et vous tracez des connexions pour définir comment les données circulent d'une étape à l'autre.

n8n se distingue des outils comme Zapier ou Make sur un point essentiel : il est source-available et auto-hébergeable. Vous pouvez l'exécuter sur votre propre serveur, ce qui signifie que vos données ne quittent jamais votre infrastructure et qu'il n'y a pas de tarification au nombre de tâches. Le compromis est que vous êtes responsable de l'hébergement et de la maintenance, bien que n8n propose également une option cloud hébergée si vous préférez ne pas gérer l'infrastructure.

En interne, chaque workflow n8n n'est fondamentalement qu'un JSON. L'éditeur visuel est une couche conviviale par-dessus ce JSON, ce qui explique pourquoi n8n est très apprécié des développeurs qui souhaitent regarder sous le capot.

Naviguer dans l'éditeur visuel

Lorsque vous ouvrez n8n, les principales zones avec lesquelles vous interagissez sont :

- Le canvas au centre, où vous construisez votre workflow en ajoutant et en connectant des nœuds. - La barre latérale gauche avec la palette de nœuds, organisée en catégories comme les nœuds déclencheurs (trigger), les nœuds d'application/action réguliers et les nœuds utilitaires (tels que Code, IF, Set, Merge). - La barre d'outils en haut avec les options pour enregistrer, exécuter, activer et partager le workflow. - Le panneau de nœud à droite qui s'ouvre lorsque vous cliquez sur un nœud, où vous configurez ses paramètres et ses identifiants.

Un workflow commence toujours par un nœud déclencheur (trigger) — quelque chose qui lance l'exécution lorsqu'un événement se produit (par exemple un webhook recevant une requête HTTP, une planification se déclenchant à une heure cron, ou une nouvelle ligne apparaissant dans une base de données).

# Quick install via npm (requires Node.js 18+)
npx n8n

# Or with Docker
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Après l'une ou l'autre commande, ouvrez http://localhost:5678 dans votre navigateur et vous verrez l'éditeur.

Anatomie d'un nœud

Chaque nœud représente une action unique : récupérer des données, transformer des données, appeler une API, faire une branche conditionnelle, etc. La plupart des nœuds comportent trois onglets :

- Parameters : les entrées que vous configurez (URL, query string, mapping de champs). - Settings : les options propres au nœud comme le comportement de retry, la gestion des erreurs, et la possibilité de continuer en cas d'échec. - Documentation : une courte référence extraite de la documentation du nœud pour ne pas avoir à quitter le canvas.

Les données circulent entre les nœuds via le fil que vous tracez. Par défaut, il s'agit de la sortie principale et la forme des données produite est le même objet JSON que vous obtiendriez en appelant directement l'API sous-jacente. Vous pouvez renommer un nœud, lui ajouter des notes et le désactiver sans le supprimer, ce qui est très utile lors du débogage.

{
  "nodes": [
    {
      "parameters": {
        "httpMethod": "POST",
        "path": "my-webhook"
      },
      "name": "Webhook",
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 1,
      "position": [240, 300]
    }
  ],
  "connections": {}
}

L'extrait ci-dessus est le JSON d'un seul nœud déclencheur Webhook exporté depuis n8n. Remarquez sa lisibilité — la méthode HTTP, le chemin et la position du nœud sur le canvas sont tous de simples propriétés JSON. C'est ce qui permet aux workflows d'être versionnés et générés programmatiquement.

Panneau des exécutions et débogage

Une fois votre workflow enregistré, cliquez sur « Execute workflow » (ou « Execute node » sur un seul nœud) pour l'exécuter. n8n enregistre chaque exécution dans le panneau Executions. Cliquer sur une exécution passée vous permet d'inspecter les données d'entrée et de sortie de chaque nœud étape par étape, ce qui est le moyen le plus rapide de déboguer un workflow défaillant.

Si un nœud échoue, l'exécution est marquée comme « error » et le panneau vous montre quel nœud a échoué, quel était le message d'erreur et quelles données ce nœud a reçues. Une erreur fréquente au début consiste à supposer que des données existent à un nœud alors que ce n'est pas le cas — ouvrez toujours l'exécution et regardez le JSON réel à chaque étape avant de supposer quoi que ce soit.

Deux autres panneaux à connaître : l'onglet Credentials (où vous stockez les clés API une seule fois et les référencez dans de nombreux nœuds) et l'onglet Variables (pour stocker des valeurs réutilisables comme des URL ou des noms d'environnement sans les coder en dur dans chaque nœud).

Résumé

n8n vous offre un éditeur visuel pour construire des flux de données qui connectent des API, des bases de données et de la logique personnalisée, sans renoncer à la possibilité de basculer dans le code, de versionner du JSON ou de vous auto-héberger. Les principales zones à maîtriser sont le canvas, la palette de nœuds, le panneau de configuration par nœud et le panneau Executions utilisé pour le débogage. Chaque workflow commence par un nœud déclencheur, et les données de chaque nœud sont du JSON brut que vous pouvez inspecter à tout moment de l'exécution.