Ressources · Intégration n8n

Nœud Email Trigger (IMAP) n8nConfigurer Email Trigger (IMAP) dans n8n.

Une boîte mail qui reçoit, et le workflow part tout seul. Le nœud Email Trigger (IMAP) n8n se connecte à un serveur de messagerie avec une adresse et un mot de passe, surveille le dossier que tu lui indiques, puis transmet chaque message reçu. Quatre paramètres pilotent ce qu'il renvoie.

Tester le nœud Email Trigger (IMAP) sur n8nVoir les 4 paramètres

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud Email Trigger (IMAP) n8n ?

Il transforme une boîte mail en point de départ d'une automatisation. IMAP est le protocole standard pour lire du courrier sur un serveur, et ce nœud le parle directement : un credential, c'est-à-dire un identifiant enregistré une fois dans n8n, un nom de dossier, et chaque message qui arrive devient une exécution. C'est un trigger, autrement dit le nœud qui ouvre le workflow : rien ne démarre avant lui. Il n'a pas d'opérations à choisir, seulement des paramètres.

Premier cas de figure, la boîte qui sert de formulaire. Les demandes arrivent par mail, le nœud les renvoie une par une avec Format sur simple, et les champs partent dans une ligne de Google Sheets. Avec Action sur read, un message déjà traité ne repasse pas au tour suivant.

Deuxième cas, l'adresse partagée que personne ne regarde le week-end. Tu pointes Mailbox Name sur Support, tu restreins la collecte avec Custom Email Rules, et un résumé part dans Slack à la seconde où le mail tombe. L'équipe suit un canal au lieu de quatre boîtes.

Troisième cas, les pièces jointes. Un fournisseur envoie ses factures en PDF, Download Attachments enregistre chaque fichier en donnée binaire sur l'item, et la suite du workflow le renomme et le range. L'option Property Prefix Name fixe le nom de ces propriétés binaires, ce qui compte dès qu'un même mail transporte plusieurs documents.

Quand le fournisseur a son propre nœud, prends-le. Sur une boîte Google, le nœud Gmail s'authentifie en OAuth et manipule les libellés, les fils de discussion et les brouillons, que l'IMAP ne montre jamais. Ce nœud-ci prend tout son sens ailleurs : une boîte livrée avec un hébergement, un vieux domaine, une adresse de service sur un serveur interne.

Deux limites à connaître avant de construire. Le nœud lit le courrier, point : envoyer, déplacer ou supprimer un message se fait avec un autre nœud. Et un mail n'est pas une réponse d'API bien rangée, le corps arrive en texte ou en chaîne encodée en base64url selon Format, et c'est à toi de l'analyser. Pour situer l'outil avant de t'y mettre, l'Avis n8n dit où il est à l'aise et où il l'est moins.

Connexion

Que faut-il pour le connecter ?

  1. 01

    Préparer la boîte côté fournisseur

    Le credential s'authentifie avec un compte utilisateur : il faut donc que la boîte accepte l'IMAP. Sur un compte Google personnel créé avant juin 2024, active d'abord l'IMAP dans les réglages du courrier, puis la validation en deux étapes et un mot de passe d'application. La plupart des fournisseurs publient leurs propres instructions IMAP, et c'est là que se trouvent l'adresse du serveur et le port.

  2. 02

    Remplir le credential IMAP

    Dans n8n, menu Credentials, crée un credential IMAP. User, c'est l'adresse mail dont tu relèves le courrier. Password, c'est soit le mot de passe de la boîte, soit le mot de passe d'application que le fournisseur te demande de générer. Host, c'est l'adresse du serveur IMAP, de la forme imap.fournisseur.com, et imap.gmail.com pour Gmail.

  3. 03

    Régler le port et le chiffrement

    Port vaut 993 par défaut et ne bouge pas, sauf consigne contraire du fournisseur ou de l'administrateur de la messagerie. Active SSL/TLS pour que la connexion soit chiffrée. Allow Self-Signed Certificates ne concerne qu'un serveur interne avec son propre certificat, à valider avec l'administrateur avant de le cocher. Un credential se crée une fois et sert à tous les workflows.

Paramètres

Comment se règle chaque paramètre ?

Le nœud Email Trigger (IMAP) compte 4 paramètres. Pour chacun : le nœud tel que tu le configures dans n8n, ce que le paramètre change, et nos notes de terrain.

01

Mailbox Name

mailbox

Ce que tu vois dans n8n

Notes & cas d'usage

Indique le dossier que le nœud surveille sur le serveur IMAP. En changer suffit pour que le même credential écoute ailleurs, et c'est comme ça qu'une seule adresse alimente plusieurs workflows.

Paramètres clés

  • Mailbox Name : un champ texte qui reçoit le nom du dossier tel que le serveur l'écrit, INBOX par convention chez la plupart des fournisseurs, ou un dossier que tu as créé comme Factures.
Cas d'usage
une règle de tri côté serveur range les messages entrants dans un dossier dédié, et le workflow ne regarde que celui-là. La boîte principale n'est pas touchée.
02

Action

postProcessAction

Ce que tu vois dans n8n

Notes & cas d'usage

Détermine le sort du message une fois que n8n l'a reçu. C'est ce réglage qui évite qu'un même mail relance le workflow en boucle.

Paramètres clés

  • Action sur read (Mark as Read) : le message est marqué comme lu sur le serveur après le déclenchement.
  • Action sur nothing (Nothing) : le mail reste non lu et intact, donc il sera traité plusieurs fois.
Cas d'usage
garde read dès que le workflow écrit quelque part, et réserve nothing à la phase de test, quand tu veux rejouer le même message sans t'en renvoyer un.
03

Format

format

Ce que tu vois dans n8n

Notes & cas d'usage

Choisit la forme sous laquelle le mail part vers le nœud suivant. À décider tôt.

Paramètres clés

  • Format sur simple : renvoie le mail complet, mais sans récupérer les pièces jointes en ligne.
  • Format sur resolved : renvoie le mail complet, données résolues et pièces jointes enregistrées en binaire.
  • Format sur raw : renvoie le corps dans le champ raw, en chaîne encodée en base64url, le champ payload restant inutilisé.
  • Download Attachments : à activer seulement si tu as besoin des fichiers, le traitement s'alourdit.
  • Property Prefix Name : le préfixe des propriétés binaires, suivi d'un index, donc attachment_ donne attachment_0.
Cas d'usage
pour une facture PDF mensuelle, resolved donne un champ binaire prévisible à archiver.
04

Options

options

Ce que tu vois dans n8n

Notes & cas d'usage

Une collection qu'on ouvre avec Add option. Rien n'y est obligatoire, et une option non ajoutée garde sa valeur par défaut.

Paramètres clés

  • Custom Email Rules : des règles de collecte personnalisées qui décident quels mails le nœud ramasse, selon les critères de recherche de la bibliothèque node-imap.
  • Fetch Only New Emails : ne récupère que les mails arrivés depuis la dernière exécution, au lieu de tous ceux qui correspondent aux règles, lesquelles valent ["UNSEEN"] par défaut.
  • Force Reconnect Every Minutes : un intervalle en minutes qui force la reconnexion au serveur.
Cas d'usage
sur une boîte calme surveillée en continu, cet intervalle évite de laisser la session traîner sans rien faire.
Besoin d'aide

Besoin d'aide pour automatiser Email Trigger (IMAP) avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions qui viennent ensuite

01Le nœud Email Trigger (IMAP) n8n est-il gratuit ?
Oui. C'est un nœud core livré avec n8n : rien à installer, aucun surcoût côté n8n. Il se comporte pareil sur n8n Cloud, l'offre hébergée par n8n, et sur une instance auto-hébergée installée avec Docker ou npm, en Community Edition sous licence Sustainable Use. Un workflow construit d'un côté tourne de l'autre sans retouche. Ce qu'il te faut en revanche, c'est une boîte mail chez un fournisseur qui accepte l'IMAP, et ce que coûte cette boîte se règle avec ton fournisseur de messagerie, pas avec n8n.
02Quels identifiants faut-il pour le faire tourner ?
Un credential IMAP avec un compte utilisateur. Quatre valeurs à saisir : User, l'adresse mail dont tu relèves le courrier, Password, le mot de passe de la boîte ou un mot de passe d'application si le fournisseur l'exige, Host, l'adresse du serveur IMAP de la forme imap.fournisseur.com, et Port, qui vaut 993 par défaut. S'y ajoutent deux choix, utiliser SSL/TLS et autoriser les certificats auto-signés, le second réservé à un serveur interne. Le credential se crée une fois dans le menu Credentials et se réutilise partout.
03Quelles sont les limites du nœud ?
Il reçoit du courrier, et c'est tout. Une seule opération, recevoir un message : ni envoi, ni déplacement, ni suppression depuis ce nœud, donc tout le reste du process passe par d'autres nœuds. Il ne peut pas non plus atteindre une boîte Outlook.com ou Microsoft 365, puisque Microsoft a supprimé l'authentification basique en IMAP sur Exchange Online en 2022, et le mot de passe d'application n'y change rien. Cette page décrit la version 2 du nœud, la plus élevée du catalogue. Un workflow ancien peut afficher une version antérieure, avec moins d'options.
04Quand le préférer au nœud du fournisseur ?
Quand aucun nœud dédié n'existe pour la boîte concernée. Une adresse livrée avec un hébergement, un domaine hérité, un serveur de messagerie interne, une adresse de contact générique : dans ces cas-là, l'IMAP est la seule porte d'entrée. Dès que le fournisseur a son nœud, prends le nœud. Pour une boîte Google, le nœud Gmail passe par OAuth et travaille avec les libellés, les fils et les brouillons, invisibles en IMAP. Côté Microsoft, la question ne se pose même pas : le nœud Microsoft Outlook Trigger et son événement Message Received remplacent l'IMAP.
05n8n ou Make pour surveiller une boîte mail ?
Ça dépend de l'endroit où doivent rester les messages. n8n s'installe sur ton propre serveur avec Docker ou npm, donc les mails et leurs pièces jointes ne sortent pas d'une infrastructure que tu maîtrises, ce qui pèse lourd quand la boîte transporte des contrats ou des données personnelles. Make est uniquement hébergé, sans option d'auto-hébergement, et se facture à l'opération : une boîte active coûte proportionnellement à son volume. Make assemble souvent plus vite un scénario visuel simple. n8n apporte le nœud Code, l'auto-hébergement et un coût stable une fois le serveur en place.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.

Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations