Terminez d'abord "Leçon 3 : Déclencheurs et modèle d'exécution" pour débloquer cette leçon.Aller à la leçon précédente

Introduction

Les nœuds sont les blocs de construction de chaque workflow n8n. Chaque nœud représente une action unique : récupérer des données depuis une API, envoyer un e-mail, transformer une valeur ou déclencher un flux selon un planning. Lorsque vous connectez des nœuds entre eux, vous obtenez un pipeline automatisé qui remplace le travail manuel.

Cette leçon vous guide à travers la bibliothèque de nœuds, vous montre comment configurer de vraies intégrations et explique comment n8n gère les identifiants afin que vos clés API et mots de passe restent sécurisés.

La bibliothèque de nœuds

n8n est livré avec plus de 400 nœuds prêts à l'emploi couvrant des services courants comme Slack, Google Sheets, GitHub, PostgreSQL, les API HTTP, et bien plus encore. Vous y accédez en cliquant sur le bouton + à l'intérieur du canevas, ce qui ouvre un panneau de recherche.

Les nœuds se divisent en deux grandes catégories. Les nœuds déclencheurs démarrent un workflow — ils écoutent un événement (un appel webhook, un planning cron, une nouvelle ligne dans une base de données). Les nœuds d'action effectuent le travail dans le workflow — ils lisent, écrivent, transforment ou envoient des données.

Quelques nœuds que vous utiliserez constamment :

Le nœud HTTP Request appelle n'importe quelle API REST qui n'a pas de nœud dédié. Il gère les requêtes GET, POST, PUT, DELETE et vous permet de définir des en-têtes, des paramètres de requête et un corps de requête.

Le nœud Code exécute du JavaScript ou du Python en ligne, utile lorsque les transformations intégrées ne suffisent pas.

Le nœud Set remodèle l'objet de données qui traverse le workflow — ajouter un champ, renommer une clé, supprimer le bruit dont vous n'avez pas besoin en aval.

diagramme montrant les catégories de nœuds : les nœuds déclencheurs à gauche alimentant les nœuds d'action (HTTP Request, Code, Set, nœuds de service) à droite, connectés par des flèches de gauche à droite

Configurer une vraie intégration

Connectons un exemple concret : à chaque soumission de formulaire, postez un message dans un canal Slack avec le nom et l'e-mail du soumetteur.

D'abord, ajoutez un nœud déclencheur Webhook. Définissez la méthode HTTP sur POST et copiez l'URL générée — c'est le point de terminaison que votre formulaire appellera. Activez le workflow pour qu'n8n commence à écouter.

Ensuite, ajoutez un nœud Slack après le webhook. Choisissez l'action « Send a Message ». À ce stade, n8n vous demandera de sélectionner ou de créer un identifiant Slack — nous couvrirons cela dans la section suivante.

Une fois l'identifiant configuré, configurez le nœud comme ceci :

json
{
"channel": "#new-leads",
"text": "New submission from {{ $json.name }} — {{ $json.email }}"
}

La syntaxe à double accolades est le langage d'expression de n8n. Elle lit les données du corps JSON entrant à l'exécution. Si votre webhook reçoit un payload avec un champ name et un champ email, ces valeurs sont substituées automatiquement.

Envoyez une requête POST de test pour vérifier le flux complet :

bash
curl -X POST https://your-n8n-instance.com/webhook/your-path \
-H "Content-Type: application/json" \
-d '{"name": "Linh", "email": "linh@example.com"}'

Si tout est correctement connecté, le canal Slack reçoit le message en quelques secondes.

Gestion des identifiants

n8n stocke les identifiants séparément des workflows. Cette conception signifie que vous créez un identifiant une seule fois, le réutilisez dans de nombreux workflows et n'intégrez jamais de clé API brute dans la configuration d'un nœud.

Pour ajouter un identifiant, allez dans Settings > Credentials > Add Credential, ou laissez n8n vous le demander lorsque vous configurez un nœud nécessitant une authentification. Vous sélectionnez le service, remplissez les champs requis (clé API, jetons OAuth, nom d'utilisateur/mot de passe) et enregistrez. n8n chiffre les valeurs stockées à l'aide de la clé de chiffrement définie dans la configuration de votre instance.

Pour les services OAuth2 comme Google ou Slack, n8n gère le flux d'autorisation pour vous. Vous cliquez sur « Connect », vous vous authentifiez dans la fenêtre popup du navigateur, et n8n stocke automatiquement les jetons d'accès et de rafraîchissement résultants.

Une pratique importante : utilisez des identifiants séparés par environnement. Votre workflow de staging doit utiliser un espace de travail Slack de test ou une clé API sandbox, pas celle de production. Vous pouvez dupliquer un identifiant et modifier uniquement la valeur secrète, en laissant un nom clairement étiqueté (« Slack - Production » vs « Slack - Staging »).

Les identifiants sont également limités par propriétaire dans les configurations multi-utilisateurs — un identifiant créé sous un compte utilisateur n'est pas visible par les autres sauf s'il est explicitement partagé. Cela empêche l'exposition accidentelle entre les équipes.

organigramme montrant le flux de création d'identifiants : Ajouter un identifiant → Sélectionner le service → Saisir la clé API ou OAuth → Stockage chiffré → Référencé par le nœud dans le workflow

Erreurs courantes

Les erreurs de syntaxe d'expression sont le problème le plus fréquent. Si une référence de champ comme {{ $json.email }} renvoie undefined, vérifiez que le nœud précédent émet bien cette clé. Utilisez le panneau « Input » sur le côté droit du canevas pour inspecter exactement quelles données circulent dans chaque nœud.

Une autre erreur courante est d'oublier d'activer le workflow après l'avoir enregistré. Un nœud déclencheur Webhook n'écoute pas tant que le workflow est inactif — le bouton bascule en haut du canevas doit être activé.

Pour les nœuds HTTP Request appelant des API externes, surveillez les incompatibilités d'authentification. Certaines API attendent la clé dans un en-tête (Authorization: Bearer ...), d'autres dans un paramètre de requête. Lisez la documentation de l'API et respectez le format à la lettre, puis utilisez le système d'identifiants pour injecter la valeur plutôt que de la coder en dur dans l'URL.

Résumé

La bibliothèque de nœuds vous offre une boîte à outils prête à l'emploi pour connecter des services sans écrire de code d'intégration boilerplate. Les nœuds déclencheurs démarrent les workflows, les nœuds d'action font le travail et les expressions relient dynamiquement les données entre eux. Les identifiants sont gérés de manière centralisée, chiffrés au repos et réutilisables entre les workflows — gardez-les spécifiques à l'environnement et laissez n8n gérer la danse OAuth pour vous. Avec ces fondamentaux en place, vous pouvez construire des pipelines fiables et lisibles qui connectent de vraies applications.

Entraînement

Point de contrôle de la leçon

Révisez la leçon et recevez des conseils sur votre travail.

0/1
Répondu · 0/1
Leçon 4 : Travailler avec les nœuds et connecter des services externes