n8n pour débutants : créez votre premier workflow d’automatisation

Pour apprendre n8n, créez un petit workflow de bout en bout : un déclencheur qui reçoit des données, un nœud qui en fait quelque chose, un test, et l’étape Publish qui le fait tourner sans vous. Tout ce qui est plus grand dans n8n suit le même schéma avec davantage de nœuds. Ce tutoriel présente ce premier workflow, le piège de l’URL de test dans lequel tombent beaucoup de débutants, la gestion des erreurs, et un second workflow qui envoie les demandes du site web vers un CRM.

Les six termes à connaître

La documentation de n8n utilise un petit vocabulaire. Une fois ces termes compris, l’éditeur le devient aussi.

La dernière ligne compte pour le coût. La page de tarifs de n8n définit une exécution comme « une seule exécution de l’ensemble de votre workflow », quel que soit le nombre d’étapes qu’il contient ou la quantité de données qu’il traite. Un workflow de dix nœuds exécuté une fois compte pour une exécution.

Cloud ou auto-hébergé : où exécuter n8n

Vous avez deux options. n8n Cloud ne demande qu’un compte. L’édition Community est gratuite et tourne sur votre propre machine ou serveur, que vous devez alors maintenir.

Prix vérifiés le 8 octobre 2026 sur la page de tarifs de n8n. La facturation mensuelle existe aussi et coûte plus cher ; la page présente l’option annuelle comme une économie de 17 %. L’essai de Cloud donne les fonctions Pro avec un plafond de 1 000 exécutions et ne demande aucune carte bancaire.

Deux différences changent ce qu’un débutant peut faire :

• Nœuds communautaires. n8n Cloud n’installe que des nœuds communautaires vérifiés. Les nœuds non vérifiés exigent une instance auto-hébergée, d’après la documentation de n8n sur les nœuds communautaires.
• Licence. L’édition Community est publiée sous la Sustainable Use License, qui autorise l’usage « pour vos propres besoins professionnels internes ou à des fins non commerciales ou personnelles ». L’automatisation de votre propre entreprise est couverte. La revente de n8n comme service hébergé ne l’est pas.

Choisissez Cloud si vous voulez démarrer aujourd’hui et que personne dans l’équipe ne veut exploiter un serveur. Auto-hébergez si vous avez besoin de nœuds communautaires non vérifiés, si vous voulez les données sur votre propre infrastructure ou si vous prévoyez assez d’exécutions pour que les plafonds coûtent plus cher qu’un petit serveur.

Pour essayer l’édition Community en local, Docker est la voie la plus courte. Voici une version minimale de la commande du guide Docker de n8n :

docker volume create n8n_data
docker run -it --rm --name n8n -p 5678:5678 \
  -v n8n_data:/home/node/.n8n n8nio/n8n

Ouvrez ensuite http://localhost:5678. Le guide ajoute des réglages de fuseau horaire et, pour un serveur qui tourne en permanence, n8n renvoie vers sa configuration Docker Compose avec HTTPS. Une instance locale suffit pour apprendre. Elle n’est pas joignable depuis internet, ce qui compte dès qu’un service cloud doit appeler votre webhook.

Créez votre premier workflow : une demande qui vous envoie un e-mail

Le workflow reçoit une charge JSON, comme l’enverrait un formulaire de site web, vérifie qu’elle contient une adresse e-mail et vous envoie les détails par e-mail. Il comporte trois nœuds et enseigne tous les concepts de base.

1. Créez le workflow et ajoutez un déclencheur Webhook

   Créez un nouveau workflow et ajoutez le nœud Webhook comme déclencheur. Réglez la méthode HTTP sur POST et donnez au chemin un nom lisible comme inquiry. Le nœud affiche deux URL, une URL de test et une URL de production. Copiez l’URL de test.

2. Envoyez-lui des données de test

   Cliquez sur Listen for test event. n8n attend désormais un appel. Depuis un terminal, envoyez une demande d’exemple à l’URL de test :

   curl -X POST "<your test URL>" \
     -H "Content-Type: application/json" \
     -d '{"firstName":"Lisa","lastName":"Meyer","email":"lisa@example.com","message":"Can we talk about a retainer?"}'

   Le panneau de sortie du nœud affiche maintenant les quatre champs. Épinglez cette sortie pour que les tests suivants la réutilisent sans nouvel appel curl.

3. Ajoutez un nœud If

   Connectez un nœud If et ajoutez une condition : {{ $json.body.email }} n’est pas vide. Les données du webhook arrivent sous body, le détail qui piège beaucoup de monde en écrivant sa première expression. Les éléments qui passent sortent par la branche true.

4. Ajoutez un nœud e-mail sur la branche true

   Ajoutez un nœud Gmail (ou Send Email avec des identifiants SMTP). Créez le credential quand le nœud le demande. Dans l’objet, écrivez New inquiry from {{ $json.body.firstName }} {{ $json.body.lastName }}, et placez le message et l’adresse e-mail dans le corps.

5. Exécutez tout le workflow

   Cliquez sur Execute workflow et renvoyez l’appel curl. Chaque nœud exécuté affiche son nombre d’éléments, et un clic sur un nœud montre exactement ce qui est entré et ce qui est sorti. Si l’e-mail arrive, la logique fonctionne.

6. Publiez-le et passez à l’URL de production

   Cliquez sur Publish. Désormais, le workflow écoute sur l’URL de production, et c’est l’adresse que votre formulaire doit appeler. Les exécutions en production n’apparaissent pas sur le canevas ; vous les trouvez dans l’onglet Executions.

URL de test ou URL de production ?

Confondre les deux URL est une cause fréquente des questions « mon webhook ne fonctionne pas ». La documentation du nœud Webhook de n8n distingue les deux :

Si un appel à l’URL de production renvoie une erreur, vérifiez d’abord que le workflow est publié, puis que l’appelant utilise la bonne méthode (POST ici).

Ajoutez la gestion des erreurs avant de vous y fier

Un workflow publié ne prévient personne en cas d’échec tant que vous n’indiquez pas à n8n où signaler les échecs. Deux réglages couvrent la plupart des cas.

1. Un workflow d’erreur. Créez un workflow distinct qui commence par le nœud Error Trigger et vous envoie un e-mail avec le nom du workflow en échec et le message d’erreur. Ouvrez ensuite le workflow d’origine, allez dans Options > Settings et choisissez-le sous Error workflow. La documentation sur la gestion des erreurs liste les données que reçoit l’Error Trigger.
2. Paramètres des nœuds. Chaque nœud a un onglet de paramètres. Pour les appels à des API externes, activez Retry On Fail. Pour les étapes qui peuvent échouer sans conséquence, comme une étape de journalisation, réglez On Error sur Continue pour que le reste de l’exécution aille à son terme.

Nommez les choses au passage. « Demande : formulaire du site vers le CRM » dans un e-mail d’erreur vous dit où regarder. « My workflow 3 » non.

Second workflow : une demande du site web vers un CRM

La version utile du premier workflow enregistre la demande là où votre équipe travaille avec. Le schéma est le même pour tout CRM doté d’une API REST : s’authentifier avec une clé API, associer les champs du formulaire aux noms de champs du CRM, envoyer une requête HTTP. L’exemple ci-dessous utilise Customermates, le CRM qui publie ce guide, car les détails de son API sont publics.

1. Créez une clé API

   Dans Customermates, ouvrez Paramètres → Clés API, cliquez sur Ajouter et choisissez Clé API standard. La clé agit avec les autorisations de l’utilisateur qui l’a créée : créez-la donc avec un utilisateur autorisé à créer des contacts. Les détails sont dans Clés API.

2. Enregistrez-la comme credential n8n

   Dans n8n, créez un credential Header Auth avec le nom d’en-tête x-api-key et la clé comme valeur. Tous les nœuds qui parlent au CRM le réutilisent, si bien qu’une clé renouvelée se change à un seul endroit.

3. Remplacez le nœud e-mail par un nœud HTTP Request

   Cherchez d’abord les ID une fois : POST <your Customermates address>/api/v1/model/discover avec {} renvoie l’ID du type Contacts, et POST /api/v1/model/read avec cet ID dans typeIds renvoie les ID des champs et la révision actuelle du schéma. Ajoutez ensuite, sur la branche true du nœud If, un nœud HTTP Request : méthode POST, URL <your Customermates address>/api/v1/records/mutate, authentification par le credential Header Auth, et un corps JSON :

   {
     "expectedRevision": 12,
     "idempotencyKey": "inquiry-{{ $execution.id }}",
     "mutation": {
       "action": "create",
       "typeId": "<Contacts type ID>",
       "fields": [
         { "fieldId": "<First name field ID>", "value": { "kind": "text", "value": "{{ $json.body.firstName }}" } },
         { "fieldId": "<Last name field ID>", "value": { "kind": "text", "value": "{{ $json.body.lastName }}" } }
       ],
       "identities": [{ "provider": "mail", "value": "{{ $json.body.email }}" }]
     }
   }

   Remplacez 12 et les ID entre chevrons par les valeurs de model/read. L’adresse e-mail va dans identities avec le fournisseur mail, c’est ainsi que Customermates relie un contact à ses conversations par e-mail. La clé d’idempotence fait qu’une exécution relancée renvoie le premier résultat au lieu de créer un second contact. Pour conserver le message, ajoutez-le ensuite aux notes du contact avec une mutation update.

4. Gardez la notification

   Après le nœud HTTP Request, gardez le nœud e-mail pour que quelqu’un voie le nouveau contact. Testez ensuite avec les données épinglées, vérifiez le contact dans le CRM et publiez.

Le sens inverse fonctionne aussi. Sous Paramètres → Webhooks → Ajouter, Customermates envoie un POST à un nœud Webhook de n8n quand un évènement auquel vous êtes abonné se produit, par exemple record.created pour la liste Contacts ou record.updated pour la liste Affaires. Définissez un secret pour que n8n puisse vérifier la signature. La référence des webhooks montre la charge utile. Un écueil pratique : Customermates Cloud ne peut pas joindre une instance n8n sur localhost, ce sens exige donc n8n Cloud ou un n8n auto-hébergé avec une adresse HTTPS publique.

Quelques détails de la documentation d’intégration n8n font gagner du temps de débogage :

• Les liens ne changent que par les mutations link et unlink. Les anciens tableaux de relations comme organizationIds ne sont pas acceptés.
• updateMany et deleteMany prennent au plus 100 enregistrements par requête, découpez donc les lots plus grands.
• Les livraisons de webhooks ne sont pas strictement ordonnées. Utilisez le timestamp de la charge utile pour les ordonner et l’ID de l’évènement pour écarter les doublons.

Il existe aussi un nœud communautaire Customermates, @customermates/n8n-nodes-crm, avec un nœud d’action pour les enregistrements du CRM et un nœud déclencheur pour les évènements de webhook. Il suit son propre calendrier de versions : vérifiez donc qu’il prend en charge l’API d’enregistrements actuelle avant d’utiliser ses actions CRM. Comme n8n Cloud n’installe que des nœuds communautaires vérifiés, prévoyez la voie HTTP Request sur Cloud et utilisez le nœud communautaire sur un n8n auto-hébergé.

La place de Customermates, et ses limites

n8n est un produit distinct. Il n’est inclus dans aucune formule Customermates ; vous l’exploitez vous-même ou vous vous abonnez à n8n Cloud. REST, les webhooks et MCP fonctionnent sur toutes les formules Customermates Cloud, à partir de 12 € par utilisateur et par mois (voir les tarifs), et dans l’édition open source auto-hébergée.

Toutes les automatisations CRM n’ont pas besoin de n8n. Si la tâche est « chaque lundi, passer en revue les affaires qui n’ont pas avancé et rédiger une note pour chacune », il faut plus de jugement que de câblage. Dans Customermates Cloud, une routine lance Mate, l’assistant intégré, selon un planning ou un évènement d’enregistrement avec une consigne enregistrée, et utilise des crédits IA hébergés. Si vous préférez que votre propre client IA travaille dans le CRM, connectez-le via MCP. Utilisez n8n quand le travail est déterministe et traverse plusieurs systèmes : formulaire, CRM, tableur, messagerie d’équipe.

Si vous n’avez besoin que de contacts dans un tableur et d’un e-mail par demande, vous n’avez pas du tout besoin d’un CRM pour ce tutoriel. Un nœud Google Sheets sur la branche true fait l’affaire.

Questions fréquentes