Introduction

Dans n8n, chaque automatisation commence par un nœud déclencheur — quelque chose qui lance le workflow — et est suivie d'un ou plusieurs nœuds d'action qui effectuent le travail réel. Dans cette leçon, vous allez construire un workflow petit mais réel : à chaque fois qu'une nouvelle ligne est ajoutée à une feuille de calcul Google Sheets, le workflow extrait l'email et le nom, envoie un email de bienvenue personnalisé via Gmail, puis enregistre que l'email a été envoyé en écrivant un statut dans la feuille. Ce pattern — déclencheur, transformation, action, enregistrement — est l'épine dorsale de presque toutes les automatisations que vous construirez.

Comprendre les déclencheurs et les actions

Un nœud déclencheur écoute un événement et démarre le workflow. n8n distingue les déclencheurs de type Polling (qui vérifient les nouvelles données selon un calendrier) et les déclencheurs de type Webhook (qui reçoivent les données instantanément via un appel HTTP). Dans cette leçon, nous utilisons un déclencheur Polling de Google Sheets car il est le plus facile à configurer sans exposer d'URL publique.

Un nœud d'action fait quelque chose avec ces données — envoyer un email, écrire dans une base de données, appeler une API. Les nœuds d'action ne s'exécutent qu'après qu'un déclencheur se soit activé et ait produit au moins un élément de données. Chaque élément circule de nœud en nœud, et chaque nœud peut le lire et le transformer.

Construire le workflow étape par étape

Ouvrez n8n et créez un nouveau workflow. Ajoutez le premier nœud, recherchez « Google Sheets » et sélectionnez le nœud « Google Sheets Trigger ». Configurez-le pour surveiller une feuille de calcul spécifique et une feuille spécifique (par exemple, « Signups »), et réglez le déclencheur pour qu'il se déclenche « On Row Added ». Cela signifie que n8n interroge la feuille chaque minute et détecte toute nouvelle ligne insérée.

Le déclencheur produit un élément par nouvelle ligne, contenant les valeurs des colonnes. Ajoutez maintenant un nœud « Set » juste après le déclencheur. Le nœud Set vous permet de mapper explicitement les champs que vous souhaitez conserver et de les renommer, ce qui facilite la référencement des données plus tard. Mappez la colonne email vers un champ appelé `email` et la colonne nom vers un champ appelé `firstName`.

Ensuite, ajoutez un nœud « Gmail » et choisissez l'opération « Send Message ». Dans le corps du message, référencez les champs que vous venez de définir pour que chaque email soit personnalisé. n8n utilise des expressions entre doubles accolades pour injecter les données des nœuds précédents.

To: {{ $json.email }}
Subject: Welcome, {{ $json.firstName }}!
Body: Hi {{ $json.firstName }}, thanks for signing up. We're glad to have you.

Enfin, ajoutez un autre nœud Google Sheets, mais cette fois choisissez l'opération « Update Row ». Mappez la ligne à mettre à jour en utilisant le même numéro de ligne venant du déclencheur, et définissez une colonne appelée « Status » avec la valeur « Email Sent ». Cela vous donne une piste d'audit claire dans la feuille de calcul elle-même.

Tester et activer

Avant d'activer le workflow, exécutez-le manuellement à l'aide du bouton « Execute Workflow ». Ajoutez une ligne de test à votre feuille avec un email et un nom. Vous devriez voir le déclencheur s'activer, le nœud Set transmettre les valeurs mappées, le nœud Gmail envoyer le message, et le nœud de mise à jour écrire « Email Sent » dans cette ligne. Si une étape échoue, cliquez sur le nœud pour inspecter son entrée et sa sortie — c'est le moyen le plus rapide de déboguer.

Une fois le test réussi, basculez le workflow de « Inactive » à « Active ». Dès maintenant, chaque nouvelle ligne d'inscription générera automatiquement un email de bienvenue et sera marquée comme traitée.

Erreurs courantes à éviter

Une erreur fréquente est d'oublier que les déclencheurs de type polling ont un délai — n8n vérifie la feuille selon un intervalle, donc une ligne ajoutée à la seconde 0 peut ne pas être traitée avant la seconde 59. Si vous avez besoin d'un traitement instantané, utilisez plutôt un Webhook Trigger. Une autre erreur courante est d'utiliser `$node["Node Name"].json` avec un mauvais nom de nœud après avoir renommé un nœud — les expressions sont sensibles à la casse et référencent le label actuel du nœud. Enfin, assurez-vous que vos credentials Google Sheets et Gmail ont les scopes requis pour la lecture et l'écriture ; les scopes manquants ressemblent souvent à des erreurs d'authentification mais sont en fait des erreurs de permissions.

Résumé

Vous avez construit un workflow complet à quatre nœuds : un Google Sheets Trigger qui détecte les nouvelles inscriptions, un nœud Set qui met en forme les données, un nœud Gmail qui envoie un message de bienvenue personnalisé, et un nœud Google Sheets de mise à jour qui enregistre le résultat. Ce pattern déclencheur → transformation → action → enregistrement est réutilisable dans presque tous les processus métier — remplacer le nœud Gmail par Slack, une écriture en base de données, ou un appel HTTP vous permet d'adapter le même squelette à d'innombrables scénarios.