n8n est un outil d'automatisation open-source puissant et gratuit. À la fin de ce tutoriel, vous saurez créer un workflow qui reçoit des données via webhook et envoie un email automatiquement.
Installer n8n
n8n peut être installé de plusieurs façons. Pour ce tutoriel, nous utilisons la version cloud gratuite.
Option 1 : n8n Cloud (recommandé pour débuter)
- Rendez-vous sur n8n.io
- Cliquez sur "Get started free"
- Créez un compte avec votre email
- Vous êtes prêt !
Option 2 : Installation locale (Docker)
docker run -it --rm --name n8n -p 5678:5678 n8nio/n8nPuis accédez à http://localhost:5678
Astuce
La version cloud offre 2500 exécutions gratuites par mois. Largement suffisant pour apprendre !
Découvrir l'interface
L'interface n8n est composée de plusieurs zones :
- Canvas central : C'est ici que vous construisez vos workflows en glissant-déposant des nodes
- Panneau de nodes (gauche) : Bibliothèque de tous les nodes disponibles (apps, actions, triggers)
- Panneau de configuration (droite) : Paramètres du node sélectionné
- Barre d'outils (haut) : Exécuter, sauvegarder, activer le workflow
Astuce
Utilisez Ctrl+K (ou Cmd+K sur Mac) pour rechercher rapidement un node par son nom.
Créer votre premier workflow
Nous allons créer un workflow simple : recevoir un webhook et envoyer un email.
- Cliquez sur "New Workflow" en haut à droite
- Donnez un nom : "Mon premier workflow"
- Vous voyez un canvas vide avec un bouton "+" au centre
Astuce
Prenez l'habitude de nommer vos workflows de manière descriptive. Vous vous remercierez plus tard !
Ajouter un Trigger (déclencheur)
Chaque workflow commence par un Trigger : l'événement qui déclenche l'automatisation.
- Cliquez sur le bouton "+" au centre du canvas
- Dans la recherche, tapez "Webhook"
- Sélectionnez "Webhook"
- Dans le panneau de droite, laissez les options par défaut
- Cliquez sur "Listen for Test Event"
- Copiez l'URL du webhook (elle ressemble à : https://xxx.app.n8n.cloud/webhook-test/...)
Astuce
Le webhook est parfait pour les tests. En production, vous utiliserez des triggers comme 'Schedule' (cron) ou des apps spécifiques (Gmail, Slack, etc.).
Tester le Trigger
Testons que notre webhook fonctionne :
- Ouvrez un nouvel onglet de navigateur
- Collez l'URL du webhook et ajoutez des paramètres :
?nom=Jean&email=jean@test.com - Appuyez sur Entrée
- Retournez dans n8n : vous devriez voir les données reçues dans le panneau de droite
Vous venez de recevoir votre première donnée dans n8n !
Astuce
Vous pouvez aussi utiliser des outils comme Postman ou curl pour envoyer des requêtes plus complexes.
Ajouter une action (Send Email)
Maintenant, ajoutons une action qui s'exécute quand le webhook est appelé :
- Cliquez sur le "+" à droite du node Webhook
- Recherchez "Send Email"
- Sélectionnez le node "Send Email"
- Configurez les paramètres :
- To : votre@email.com
- Subject : "Nouveau lead : {{ $json.nom }}"
- Body : "Email reçu : {{ $json.email }}"
Les expressions {{ $json.nom }} récupèrent les données du webhook !
Astuce
n8n utilise des expressions JavaScript. $json contient les données du node précédent. Vous pouvez faire $json.propriete pour accéder à n'importe quelle donnée.
Configurer les credentials
Pour envoyer un email, n8n a besoin de vos identifiants SMTP :
- Dans le node "Send Email", cliquez sur "Credential to connect with"
- Cliquez sur "Create New Credential"
- Choisissez votre fournisseur (Gmail, SMTP générique, etc.)
- Pour Gmail :
- Utilisez un "App Password" (pas votre mot de passe normal)
- Créez-le dans les paramètres de sécurité Google
- Testez la connexion
Astuce
Pour Gmail, activez la vérification en 2 étapes puis créez un 'Mot de passe d'application' dans les paramètres de sécurité Google.
Exécuter et tester
Votre workflow est prêt ! Testons-le :
- Cliquez sur "Execute Workflow" (bouton play en haut)
- Ouvrez l'URL du webhook dans un navigateur avec les paramètres de test
- Vérifiez votre boîte mail : vous devriez avoir reçu l'email !
Si tout fonctionne, vous verrez des coches vertes sur chaque node.
Astuce
En cas d'erreur, cliquez sur le node en rouge pour voir le message d'erreur détaillé.
Activer le workflow
Pour que votre workflow s'exécute automatiquement (pas seulement en test) :
- Cliquez sur le toggle "Active" en haut à droite
- Le workflow est maintenant actif 24/7
- L'URL du webhook change légèrement (sans "-test" dedans)
- Utilisez cette nouvelle URL en production
Félicitations ! Vous avez créé votre premier workflow n8n fonctionnel.
Astuce
Vous pouvez désactiver un workflow à tout moment sans le supprimer. Pratique pour la maintenance.
Bravo ! Vous avez terminé ce tutoriel
Vous savez maintenant créer un workflow n8n de base. Ce même principe s'applique à des centaines d'intégrations : remplacez le webhook par un trigger Gmail, Slack ou Notion, et l'email par n'importe quelle action.