Installer n8n ne consiste pas seulement à ouvrir une page et à cliquer sur « démarrer ». Il faut d’abord choisir où le logiciel va fonctionner, comprendre comment il conserve vos workflows et vos connexions, puis tester une première automatisation sans mettre en danger vos emails ou vos données clients.

Ce guide s’adresse à une personne qui part de zéro. Vous allez d’abord comprendre les mots utilisés, choisir entre n8n Cloud, un test sur votre ordinateur ou une installation sur serveur, puis connecter Gmail avec la bonne méthode. La dernière partie vous montre un workflow très simple : repérer une demande de tarif et préparer un brouillon, sans envoi automatique.

n8n, workflow, nœud et connexion : les mots expliqués

n8n est un outil qui relie des applications et exécute des actions selon des règles. Un workflow, ou flux de travail, est la recette complète. Un nœud est une étape de cette recette. Le premier nœud peut surveiller un événement ; les suivants peuvent lire, transformer, classer ou envoyer une information.

Le mot déclencheur désigne l’événement qui démarre le workflow. Une exécution est un passage du workflow : chaque email traité produit une exécution. Une connexion ou un identifiant est l’autorisation qui permet à n8n d’utiliser Gmail, Google Sheets ou une autre application. Cette autorisation ne doit pas être confondue avec le mot de passe que vous utilisez pour vous connecter à Google.

Si vous pouvez expliquer votre workflow avec ces quatre phrases, vous avez déjà la base : « qu’est-ce qui démarre ? », « quelle règle s’applique ? », « quelle action est faite ? », « où est-ce que je vérifie le résultat ? ».

Choisir le bon mode d’installation

Vous avez trois situations possibles. Le choix ne dépend pas de la puissance affichée par l’outil, mais de ce que vous acceptez de gérer.

Option 1 : n8n Cloud pour commencer sans serveur

n8n Cloud est la version hébergée. n8n s’occupe de la machine, de l’accès à l’interface et d’une partie de la maintenance. Vous créez un compte, vous ouvrez votre espace et vous construisez vos workflows dans le navigateur. Vous n’installez ni Docker, ni serveur, ni certificat HTTPS.

C’est généralement le meilleur point de départ pour découvrir n8n ou pour une petite entreprise qui veut se concentrer sur le processus métier. Il faut toutefois vérifier l’offre, les limites d’exécution et le prix en vigueur avant de choisir un abonnement : ces conditions peuvent évoluer. La documentation n8n sur l’essai Cloud détaille les conditions actuelles.

Option 2 : un test local sur votre ordinateur

Une installation locale permet d’ouvrir n8n sur votre propre ordinateur, généralement à l’adresse http://localhost:5678. C’est utile pour apprendre et tester. En revanche, si l’ordinateur est éteint, endormi ou si le service est arrêté, le workflow ne traite plus les nouveaux événements. Une adresse locale n’est pas une solution publique pour recevoir des notifications depuis internet.

Option 3 : un serveur que vous administrez

L’auto-hébergement sur un serveur peut donner davantage de contrôle, mais vous devenez responsable de l’accès, des sauvegardes, des mises à jour, de la sécurité, du nom de domaine et de la disponibilité. Il faut aussi prévoir la conservation des données et des identifiants.

Installer n8n Cloud et préparer la première connexion

Cette voie évite la partie serveur. Elle ne supprime pas la nécessité de comprendre les autorisations : dès que n8n doit lire Gmail ou écrire dans Google Sheets, Google vous demandera d’autoriser l’accès.

Étape 1 : créer l’espace n8n

Ouvrez la page d’essai n8n Cloud et créez votre compte avec une adresse que vous pourrez conserver. Validez l’email si n8n vous le demande. Après la connexion, repérez le nom de votre espace et l’adresse depuis laquelle vous ouvrirez n8n.

Un espace regroupe vos workflows, vos connexions et vos réglages. Ne confondez pas l’espace n8n avec votre compte Gmail : vous pouvez utiliser un compte Google pour vous connecter à n8n et un autre compte Google pour la boîte qui sera automatisée. Cette différence doit être décidée avant la connexion.

Étape 2 : créer un workflow vide

Dans l’interface n8n, créez un nouveau workflow. Vous arrivez sur un canevas vide. Pour le moment, ne cherchez pas Gmail. Ajoutez d’abord un déclencheur manuel, souvent nommé Manual Trigger. Ce bouton vous permet de lancer un test à la demande, sans attendre un email réel.

Ajoutez ensuite un nœud de modification de données, appelé selon les versions Edit Fields ou Set. Ajoutez un champ nommé test et donnez-lui la valeur « première exécution réussie ». Lancez le workflow avec le bouton d’exécution. Cliquez sur le nœud et vérifiez que cette valeur apparaît en sortie.

Ce petit test répond à une question essentielle : n8n fonctionne-t-il dans votre espace ? Si oui, vous pouvez passer aux connexions. Si non, il est inutile d’ajouter Gmail ou Google Sheets : il faut d’abord résoudre le problème de compte ou d’installation.

Étape 3 : créer une connexion Gmail dans n8n Cloud

Ajoutez le nœud Gmail Trigger, qui déclenche le workflow lorsqu’un message Gmail arrive. Dans le champ consacré aux identifiants ou aux credentials, choisissez la création d’une nouvelle connexion Google.

Avec n8n Cloud, l’option Sign in with Google ou Managed OAuth2 peut être proposée pour Gmail. Cliquez dessus, sélectionnez l’adresse Gmail qui reçoit réellement les demandes, lisez les autorisations affichées, puis acceptez si elles correspondent à ce que vous voulez faire.

Vous ne devez pas copier votre mot de passe dans un champ n8n. Google ouvre sa propre fenêtre d’autorisation. Lorsque vous revenez dans n8n, vérifiez que la bonne adresse est affichée dans le champ de connexion. Si plusieurs comptes sont ouverts dans le navigateur, déconnectez les comptes inutiles ou ouvrez une fenêtre privée pour éviter de sélectionner le mauvais.

La documentation officielle des connexions Google n8n précise quels nœuds Cloud peuvent utiliser cette connexion gérée. Si l’option n’existe pas dans votre écran, n’inventez pas un identifiant : vous êtes peut-être dans le cas d’une connexion OAuth personnalisée.

Installer n8n sur son ordinateur pour apprendre

La méthode locale est utile pour comprendre, mais elle demande déjà un outil supplémentaire : Docker. Docker fait fonctionner n8n dans un environnement séparé. Vous n’avez pas besoin de comprendre toute la technologie pour suivre le test, mais vous devez savoir ce qui se passe : vous installez Docker, puis vous lancez n8n dans un conteneur.

Étape 1 : vérifier votre système

Sur macOS ou Linux, installez Docker Desktop ou Docker Engine avec le module Docker Compose v2. Sur Windows, la méthode la plus stable pour un débutant passe généralement par Docker Desktop avec WSL2 activé. WSL2 est un environnement Linux intégré à Windows ; ce n’est pas une deuxième entreprise ni un deuxième compte n8n.

Ouvrez un terminal et vérifiez que Docker répond :

docker --version
docker compose version

Si une commande n’est pas reconnue ou si Docker indique que le service n’est pas démarré, arrêtez-vous. Installez Docker depuis sa source officielle, démarrez l’application, puis relancez les deux commandes. Ne poursuivez pas avec des commandes trouvées au hasard sur un forum.

Étape 2 : lancer l’installation officielle

Placez-vous dans un dossier où vous acceptez que n8n crée un sous-dossier nommé n8n. La méthode actuelle proposée par la documentation n8n utilise une commande d’installation unique :

curl -fsSL https://get.n8n.io | sh

Cette commande télécharge le script officiel, vérifie Docker, crée les fichiers de configuration nécessaires, télécharge n8n et démarre le service. Si vous ne souhaitez pas exécuter directement un script téléchargé, vous pouvez d’abord l’enregistrer, le lire, puis le lancer :

curl -fsSL https://get.n8n.io -o get-n8n.sh
less get-n8n.sh
sh get-n8n.sh

La documentation n8n sur l’installation en une commande indique aussi les cas Windows et les commandes quotidiennes. Les versions, les messages et les options peuvent changer : lisez le résultat affiché par votre terminal au lieu de supposer que votre écran est identique.

Étape 3 : ouvrir n8n et créer l’accès

Lorsque le démarrage est terminé, ouvrez http://localhost:5678 dans votre navigateur. Créez le compte propriétaire demandé par n8n. Conservez cet accès dans un gestionnaire de mots de passe. Cet écran n’est pas une page publique : il fonctionne sur l’ordinateur où n8n est lancé.

Fermer l’onglet du navigateur ne ferme pas forcément n8n. En revanche, arrêter Docker, arrêter les conteneurs ou éteindre l’ordinateur empêche les workflows de fonctionner. Pour arrêter et redémarrer l’installation créée par la commande officielle, utilisez les commandes indiquées par n8n dans le dossier n8n, notamment :

docker compose -f ./n8n/compose.yml down
docker compose -f ./n8n/compose.yml up -d

Ne supprimez pas le dossier n8n pour « repartir de zéro » sans sauvegarde. Il contient les fichiers et les données nécessaires à votre instance. Une suppression peut rendre vos workflows et vos connexions irrécupérables.

Pourquoi un serveur n’est pas une simple installation

Pour utiliser n8n en continu, vous pouvez installer n8n sur un serveur accessible en permanence. Le serveur peut être fourni par un hébergeur, mais il ne devient pas automatiquement sécurisé parce que n8n s’ouvre dans un navigateur.

Les éléments à prévoir

• Un nom de domaine : une adresse stable pour accéder à n8n.
• HTTPS : une connexion chiffrée, indispensable pour un service accessible sur internet.
• Un accès limité : pare-feu, comptes individuels et mots de passe solides.
• Un stockage persistant : les workflows, connexions et historiques doivent survivre au redémarrage.
• Des sauvegardes : testez aussi la restauration, pas seulement la création d’une copie.
• Des mises à jour : prévoyez un moment pour vérifier les changements et les erreurs après mise à jour.
• Une surveillance : vous devez savoir si n8n est arrêté ou si un workflow échoue.

La configuration Docker Compose complète dépend de votre usage. La documentation officielle du déploiement Docker Compose explique les services, les volumes et les contrôles à prévoir. Pour un débutant, copier une configuration serveur sans comprendre le domaine, le HTTPS et les sauvegardes crée un faux sentiment de sécurité.

Construire le premier workflow Gmail sans envoyer de message

Une fois n8n installé, ne commencez pas par une automatisation qui envoie directement un email. Construisez une version qui crée un brouillon. Vous pourrez observer le résultat et corriger la règle sans risquer d’envoyer une réponse au mauvais destinataire.

Étape 1 : ajouter Gmail Trigger

Créez un nouveau workflow et ajoutez Gmail Trigger. Choisissez l’événement Message Received. Dans Poll Times, définissez la fréquence à laquelle n8n vérifie les nouveaux messages. Pour un test, une fréquence simple suffit.

Dans les filtres du nœud, utilisez un libellé Gmail créé à l’avance, par exemple FAQ-TARIF. Vous pouvez aussi utiliser le champ de recherche avec une requête Gmail comme subject:DEMANDE-TARIF. Le libellé est souvent plus prudent lorsque les clients écrivent librement : vous pouvez l’appliquer manuellement pendant les premiers essais.

Réglez Max Emails per Poll sur une petite valeur pour le test. Laissez la version simplifiée des données activée si elle est proposée : vous aurez notamment l’expéditeur, l’objet et les libellés. La documentation du nœud Gmail Trigger détaille les filtres et les modes de vérification.

Étape 2 : connecter Gmail avec OAuth

Dans n8n Cloud, utilisez Sign in with Google si cette option apparaît. En auto-hébergement, la connexion gérée n’est pas disponible de la même manière : il faut généralement créer une connexion OAuth personnalisée.

OAuth est le mécanisme d’autorisation qui permet à Google de confirmer votre identité sans que vous transmettiez votre mot de passe à n8n. Pour une connexion personnalisée, la méthode comprend cinq parties : créer un projet dans Google Cloud, activer l’API Gmail, configurer l’écran de consentement, créer un identifiant OAuth pour une application web, puis reporter les informations dans n8n.

Étape 3 : créer la connexion OAuth personnalisée si nécessaire

Dans n8n, ouvrez la création de l’identifiant Google et copiez l’OAuth Redirect URL affichée. Dans Google Cloud Console, créez ou sélectionnez un projet. Dans APIs & Services > Library, recherchez l’API Gmail et activez-la.

Ouvrez ensuite l’écran de consentement OAuth. Indiquez le nom de l’application et l’adresse de support. Choisissez Internal si seuls les utilisateurs de votre organisation Google Workspace doivent l’utiliser ; choisissez External si l’accès doit concerner des comptes Google hors organisation. En mode test externe, ajoutez votre adresse comme utilisateur de test.

Dans Credentials, créez un identifiant OAuth de type application web. Collez exactement l’URL de redirection fournie par n8n dans les Authorized redirect URIs. Pour un test local, l’adresse peut ressembler à http://localhost:5678/rest/oauth2-credential/callback ; utilisez toujours celle affichée dans votre écran n8n, avec le bon protocole et le bon port.

Copiez le Client ID et le Client Secret dans la connexion n8n, enlevez les espaces éventuels, enregistrez, puis cliquez sur Sign in with Google. Si Google affiche « redirect_uri_mismatch », l’URL enregistrée n’est pas exactement la même. Si Google affiche « app not verified » ou « access denied », vérifiez le type d’utilisateur et les utilisateurs de test. Ne cliquez pas sur une option de contournement que vous ne comprenez pas.

Pour Gmail, privilégiez OAuth2. La documentation n8n indique que l’utilisation d’un compte de service demande une configuration Google avancée, notamment une délégation au niveau du domaine, et recommande OAuth2 pour le nœud Gmail.

Étape 4 : écouter un message de test

Enregistrez le nœud, puis utilisez le bouton d’écoute ou d’exécution de test proposé par n8n. Depuis votre deuxième adresse, envoyez un message portant exactement l’objet prévu et appliquez le libellé FAQ-TARIF si votre règle le demande.

Regardez les données reçues par le nœud. Vérifiez l’adresse de l’expéditeur, l’objet et le libellé. Si n8n ne reçoit rien, contrôlez le compte Gmail, le statut lu ou non lu, le libellé et la fréquence de vérification. Ne passez pas au nœud de réponse tant que le déclencheur ne reçoit pas le bon email.

Étape 5 : ajouter une condition

Ajoutez un nœud IF, c’est-à-dire une condition. Configurez-le pour continuer uniquement si le message possède le libellé FAQ-TARIF ou si son objet contient votre repère exact. La sortie vraie poursuit vers la préparation du brouillon. La sortie fausse reste sans envoi et peut être traitée manuellement.

Une condition n’apprend pas à comprendre les intentions. Elle compare une donnée à une règle. Si vous voulez reconnaître « combien coûte votre prestation », « quel est le prix » et d’autres formulations différentes, vous aurez besoin d’une logique plus souple, éventuellement aidée par une IA, mais cette étape doit rester contrôlée et renvoyer les cas incertains vers une validation humaine.

Étape 6 : créer un brouillon Gmail

Ajoutez le nœud Gmail et sélectionnez l’opération Draft > Create. Réutilisez la même connexion Gmail. Dans le destinataire, choisissez la donnée qui contient l’adresse de l’expéditeur du déclencheur. Dans l’objet, écrivez « Re: » suivi de l’objet reçu, ou utilisez un objet fixe.

Dans le corps, copiez votre réponse validée. Pour insérer une donnée issue du message, utilisez le sélecteur n8n qui affiche les valeurs du nœud précédent. Cette insertion est parfois appelée une expression : elle récupère une valeur existante, elle ne l’invente pas. Choisissez Draft > Create, jamais Message > Send pour le premier test.

La documentation officielle du nœud Gmail n8n liste les opérations de brouillon, de message et de fil de discussion. Gardez la fonction d’envoi manuel tant que vous n’avez pas vérifié plusieurs cas.

Étape 7 : activer seulement après les contrôles

Testez quatre situations : la demande exacte, une demande incomplète, une autre question contenant le même mot et un email sans le libellé. Le premier doit créer un brouillon correct. Les autres doivent rester manuels ou être signalés comme incertains.

Après le test, enregistrez le workflow et activez-le avec le bouton prévu par n8n. Un workflow avec un déclencheur Gmail doit être actif et l’instance n8n doit fonctionner pour traiter les nouveaux messages. Sur un ordinateur local, l’ordinateur et Docker doivent rester disponibles ; sur un serveur, le service doit être surveillé.

Les erreurs qui bloquent le plus souvent

Sécuriser l’installation et les données

Les identifiants enregistrés dans n8n donnent accès à des applications. Ne les écrivez pas dans un champ de texte visible, un document partagé ou un message envoyé à un prestataire. Utilisez le système de credentials de n8n et donnez uniquement les autorisations nécessaires.

Anonymisez les données dans les tests. Évitez les contrats, coordonnées bancaires, données médicales, mots de passe et dossiers clients. Pour vérifier le flux, une adresse fictive et un texte de démonstration suffisent.

Sur un serveur, protégez le domaine, le compte propriétaire, les sauvegardes et la clé de chiffrement de n8n. Vérifiez que les sauvegardes peuvent être restaurées. Si vous ne savez pas où sont les données, qui peut accéder à l’interface ou comment remettre le service en route, l’installation n’est pas encore prête pour une activité professionnelle.

Ce que vous pouvez faire seul et ce que nous pouvons faire

Vous pouvez essayer n8n Cloud ou un test local avec le workflow manuel, puis connecter une boîte Gmail de test. Cette démarche vous permet de comprendre ce que fait l’outil avant de lui confier une tâche réelle.

Un accompagnement devient pertinent lorsque vous ne savez pas choisir entre Cloud et serveur, lorsque vous devez configurer OAuth Google, lorsque n8n doit rester disponible en permanence ou lorsque plusieurs boîtes et règles métier sont concernées.

Lors d’un premier échange gratuit, IACONCRETE part de votre problème et de votre organisation. Selon le besoin, nous pouvons proposer un workflow existant, une adaptation, l’installation complète, une formation pour vous rendre autonome ou un suivi optionnel. Si Make suffit pour votre cas, nous vous le dirons : n8n n’est pas une obligation. Vous pouvez aussi consulter notre guide détaillé pour installer Make.

Nous pouvons aussi commencer par une petite automatisation de découverte. Vous voyez le résultat, vous mesurez le temps récupéré et vous décidez ensuite s’il est utile d’ajouter Google Sheets, une classification, une notification ou d’autres étapes.

Comparer l’installation au temps réellement gagné

Une installation n8n peut représenter plus qu’un simple clic, surtout si vous choisissez l’auto-hébergement. Il faut donc comparer l’investissement total avec la tâche réduite : workflow, configuration, formation, hébergement, maintenance et suivi éventuel.

L’objectif n’est pas de supprimer tout le travail. Il est de réduire une tâche répétitive et de rendre du temps utile à votre activité. Commencez petit, mesurez, puis faites évoluer le workflow.