Qu'est-ce qu'un déclencheur ?

Chaque workflow dans n8n doit commencer quelque part. Ce point de départ est appelé nœud déclencheur — le premier nœud de tout workflow, et le seul nœud qui décide quand le workflow s'exécute. Sans déclencheur, un workflow reste simplement inactif.

Il existe deux grandes catégories : les déclencheurs manuels (vous le lancez vous-même) et les déclencheurs automatiques (quelque chose d'externe ou une planification le démarre). Comprendre quel déclencheur utiliser est l'une des décisions les plus importantes que vous prenez lors de la conception d'un workflow.

Les trois déclencheurs les plus courants

N8n est livré avec plusieurs nœuds déclencheurs. Vous allez rencontrer ces trois-là en permanence.

Le Manual Trigger est le plus simple. Vous cliquez sur "Test workflow" dans l'éditeur et le workflow s'exécute une fois. Il ne produit aucune donnée propre — il se contente de signaler "go". Utilisez-le pendant le développement ou pour les workflows que vous ne lancez qu'à la demande.

Le Schedule Trigger exécute votre workflow automatiquement à un intervalle fixe — toutes les heures, chaque lundi à 9 h, ou selon toute expression cron que vous définissez. Il ne produit pas non plus de données en entrée ; la planification n'est qu'un signal d'horloge.

{
  "rule": {
    "interval": [
      {
        "field": "hours",
        "hoursInterval": 1
      }
    ]
  }
}

Le Webhook Trigger est le plus puissant. N8n expose une URL unique, et dès qu'une requête HTTP atteint cette URL, le workflow s'exécute immédiatement. Le corps de la requête entrante, les en-têtes et les paramètres de requête deviennent tous la première donnée qui circule dans le workflow. C'est ainsi que vous connectez n8n à des services externes comme GitHub, Stripe ou tout système prenant en charge les webhooks.

Lorsque vous ajoutez un nœud Webhook, n8n vous donne deux URL : une URL de test (active uniquement lorsque l'éditeur est ouvert et que vous cliquez sur "Listen for Test Event") et une URL de production (active uniquement lorsque le workflow est enregistré et activé).

# Example: trigger a workflow by sending a POST request
curl -X POST https://your-n8n-instance.com/webhook/your-unique-path \
  -H "Content-Type: application/json" \
  -d '{"event": "user.signup", "email": "alex@example.com"}'

Comment n8n traite les données : le modèle d'exécution

Une fois qu'un déclencheur se déclenche, n8n crée une exécution — un passage unique de votre workflow. Chaque nœud s'exécute en séquence, de gauche à droite, transmettant les données au nœud suivant.

Le modèle de données utilisé par n8n est un tableau d'items. Chaque nœud reçoit un tableau d'items et produit un tableau d'items. Chaque item est un objet JSON enveloppé dans une structure comme celle-ci :

[
  {
    "json": {
      "email": "alex@example.com",
      "plan": "pro"
    }
  },
  {
    "json": {
      "email": "sam@example.com",
      "plan": "free"
    }
  }
]

Lorsqu'un nœud reçoit deux items, il traite généralement chaque item individuellement et produit deux items. Cela signifie que si votre webhook envoie un utilisateur, le nœud suivant traite un enregistrement. Si un nœud en amont divise ou multiplie les données, les nœuds en aval voient davantage d'items.

Ce modèle mental d'un item par ligne est la clé pour comprendre pourquoi les choses se comportent comme elles le font. Un nœud comme HTTP Request s'exécute une fois par item par défaut. Un nœud comme Merge peut combiner les items de deux branches en un seul tableau. Garder une trace du nombre d'items que vous avez à chaque étape évite la plupart des confusions des débutants.

Vous pouvez inspecter ce qui s'est passé à n'importe quelle étape en cliquant sur un nœud après une exécution de test — n8n affiche les données exactes en entrée et en sortie pour cette exécution.

Workflows actifs vs inactifs

Un workflow avec un déclencheur Webhook ou Schedule ne répond aux événements réels que lorsqu'il est actif. Activer un workflow l'enregistre et inscrit le déclencheur dans le planificateur interne ou le registre de webhooks de n8n. Le désactiver désinscrit le déclencheur — plus aucune exécution automatique.

Pendant le développement, vous travaillez presque toujours avec le workflow inactif, en utilisant le Manual Trigger ou l'URL de webhook de test pour envoyer des données d'exemple. Le passage en mode actif est l'étape de déploiement.

Un effet secondaire important : vous ne pouvez pas avoir deux workflows actifs partageant le même chemin de webhook. N8n vous avertira et refusera d'activer le second.

Résumé

Chaque workflow commence par un nœud déclencheur. Les déclencheurs manuels sont destinés au développement et à un usage à la demande ; les déclencheurs Schedule s'exécutent selon une horloge ; les déclencheurs Webhook répondent en temps réel aux appels HTTP externes. Une fois qu'un déclencheur se déclenche, n8n crée une exécution et déplace les données sous forme de tableau d'items d'un nœud à l'autre, de gauche à droite. Les workflows avec des déclencheurs automatiques ne s'exécutent que lorsqu'ils sont activés. Se familiariser avec ces fondamentaux rend chaque workflow que vous construirez à partir d'ici beaucoup plus facile à raisonner.