Intégration Gmail n8nAutomatiser Gmail avec n8n.

Pose un ou plusieurs libellés existants sur un message précis. C'est le classement qu'une personne aurait fait à la main.

• Message ID : l'identifiant Gmail du message, du type 172ce2c4a72cc243, récupéré du nœud précédent avec une expression, la syntaxe {{ $json.id }} qui va chercher un champ de l'item entrant.
• Label Names or IDs : choisis les libellés dans la liste déroulante, alimentée par le credential, ou passe leurs identifiants avec une expression.

Supprime un message immédiatement et définitivement. Gmail ne le met pas à la corbeille, il l'efface, et aucune opération ne le ramène.

• Message ID : l'identifiant du message à effacer. Lance un Get dessus avant, en cas de doute sur son existence, sinon l'exécution s'arrête sur Bad request - please check your parameters.

Relit un message et le ramène dans le workflow, avec ses en-têtes et, sur demande, ses pièces jointes.

• Message ID : le message à récupérer.
• Simplify : activé, le nœud renvoie les identifiants, les libellés et les en-têtes From, To, CC, BCC et Subject ; désactivé, la réponse brute complète.
• Download Attachments : les fichiers reviennent en propriétés binaires nommées à partir d'Attachment Prefix suivi d'un index qui commence à 0, donc attachment_ donne attachment_0.

Liste des messages et les filtre avant qu'ils entrent dans le workflow. C'est l'opération de reporting du nœud.

• Return All : activé, n8n enchaîne toutes les pages de l'API ; désactivé, Limit fixe le nombre de messages ramenés.
• Search : la syntaxe de la barre de recherche Gmail, has:attachment par exemple.
• Received After et Received Before : un sélecteur de date, ou une expression avec une chaîne au format ISO ou un timestamp en millisecondes.
• Read Status, Sender, Label Names or IDs : les mêmes filtres que le trigger, appliqués à la demande.

Bascule un message en lu sans que personne n'ouvre Gmail. Sa place est en fin de branche, comme signal que le workflow a fait sa part.

• Message ID : le message que le workflow vient de traiter.

Remet un message dans les non lus, là où une personne le verra. L'exact inverse de l'opération précédente, et elle sert aux cas que l'automatisation ne doit pas clore.

• Message ID : le message à rendre à un humain.

Retire des libellés d'un message. Sans ça, une boîte finit couverte d'étiquettes qui décrivaient une situation d'il y a deux étapes.

• Message ID : le message à nettoyer.
• Label Names or IDs : les libellés à enlever, sélectionnés dans la liste ou passés en identifiants via une expression.

Répond dans la conversation existante, ce qui garde le fil entier chez le destinataire.

• Message ID : le message auquel répondre.
• Email Type : Text ou HTML, et Message contient le corps.
• Reply to Sender Only : activé, seul l'expéditeur reçoit la réponse ; désactivé, toute la liste des destinataires.
• Append n8n Attribution : activé par défaut, il ajoute la phrase qui signale un envoi automatique par n8n. À couper pour un mail client.

Part de la boîte connectée pour écrire un mail neuf, en dehors de tout fil existant.

• To : une adresse, ou plusieurs séparées par des virgules.
• Subject, Message et Email Type : l'objet, le corps, et Text ou HTML.
• Sender Name : le nom que les destinataires voient dans leur boîte, rarement identique à l'adresse.
• CC, BCC, Send Replies To et Attachments : les compléments habituels, plus les fichiers pris dans un champ de l'item entrant.

Envoie un mail puis met l'exécution en pause tant que le destinataire n'a pas répondu. C'est la façon de faire entrer une décision humaine dans un enchaînement automatique.

• Response Type : Approval, la personne tranche depuis le message ; Free Text, une réponse libre via un formulaire ; Custom Form, un formulaire que tu construis.
• Type of Approval : Approve Only, ou Approve and Disapprove pour deux boutons.
• Limit Wait Time : borne le temps d'attente avant que l'exécution reprenne seule.

Crée un libellé dans la boîte. Chez Gmail, le libellé tient lieu de dossier.

• Name : le nom affiché, invoices par exemple.
• Label List Visibility : Show, Hide ou Show If Unread dans la liste des libellés de l'interface web Gmail.
• Message List Visibility : Show ou Hide pour les messages qui portent ce libellé dans la liste des messages.

Supprime un libellé de la boîte. À regarder à deux fois avant de le mettre sur une exécution planifiée.

• Label ID : l'identifiant du libellé, pas le nom affiché dans Gmail. Un Get Many sur les libellés donne la correspondance, et un identifiant inexistant termine l'exécution sur Bad request - please check your parameters.

Renvoie le détail d'un libellé. Petite opération, surtout utile en garde-fou.

• Label ID : l'identifiant du libellé à consulter.

Liste les libellés de la boîte avec leurs identifiants. C'est le chemin le plus court vers les valeurs que réclament les autres opérations sur les libellés.

• Return All : activé, tous les libellés reviennent ; désactivé, Limit fixe le maximum.

Écrit un mail dans les brouillons et s'arrête là. Rien ne quitte la boîte tant qu'une personne n'a pas cliqué sur Envoyer, ce qui en fait la manière la plus prudente d'automatiser une réponse.

• Subject, Message et Email Type : le contenu du brouillon, en Text ou en HTML.
• To Email : facultatif ici, un brouillon peut donc attendre sans destinataire.
• Thread ID : rattache le brouillon à une conversation existante, du type 18cc573e2431878f.
• From Alias Name or ID : l'alias depuis lequel le brouillon partira.

Jette un brouillon dont le workflow n'a plus l'usage. Du ménage, mais c'est ce qui évite que le dossier Brouillons devienne un cimetière.

• Draft ID : l'identifiant du brouillon, de la forme r-3254521568507167962, qui n'a rien à voir avec un identifiant de message.

Relit un brouillon, pièces jointes comprises quand le workflow les réclame.

• Draft ID : le brouillon à récupérer.
• Download Attachments : les fichiers arrivent en données binaires, nommées à partir d'Attachment Prefix suivi d'un index qui démarre à 0.

Liste les brouillons qui dorment dans la boîte, avec la même logique de pagination que les opérations sur les messages.

• Return All : activé, tous les brouillons remontent ; désactivé, Limit coupe la liste.
• Include Spam and Trash : activé, les brouillons rangés dans Spam et Corbeille comptent aussi.
• Download Attachments et Attachment Prefix : le même nommage binaire que sur le Get unitaire.

Un libellé posé ici s'applique à la conversation entière, et pas au seul message qui vient d'arriver.

• Thread ID : l'identifiant Gmail de la conversation, une chaîne du genre 172ce2c4a72cc243, le plus souvent reprise en {{ $json.threadId }} depuis le nœud précédent.
• Label Names or IDs : tu choisis les libellés dans la liste que n8n lit sur le compte connecté, ou tu passes des identifiants de libellé par une expression quand une étape en amont a déjà tranché.

Ici, rien ne se récupère : la conversation et tous ses messages disparaissent immédiatement et définitivement. Pour garder une marche arrière, c'est l'opération Trash qu'il faut viser.

• Thread ID : l'identifiant de la conversation visée. Une mauvaise valeur efface le mauvais échange, donc mieux vaut lire la conversation juste avant et transmettre son identifiant.

Récupérer une conversation ramène ses messages dans un seul item, et Simplify décide du poids de cet item.

• Thread ID : l'identifiant de la conversation à lire.
• Simplify : actif par défaut, il renvoie une version simplifiée plutôt que les données brutes, soit les identifiants de message, les libellés et les en-têtes From, To, CC, BCC et Subject. Désactive-le pour la réponse brute.
• Return Only Messages : rangé dans Options, il ne garde que les messages de la conversation en sortie.

Quand le workflow travaille sur un lot de conversations et non sur une seule, c'est cette opération qui les liste, avec un item par conversation.

• Return All et Limit : coché, Return All enchaîne les pages de l'API Gmail jusqu'au bout ; décoché, Limit fixe le nombre de conversations renvoyées.
• Search : la même syntaxe que la barre de recherche Gmail, par exemple has:attachment, ce qui permet de recycler une requête déjà testée à la main.
• Read Status : conversations non lues uniquement, lues uniquement, ou les deux.
• Received After et Received Before : dans une expression, une date au format ISO ou un horodatage en millisecondes.

Poser un libellé ne suffit pas, encore faut-il le retirer quand la conversation change d'état. Sinon la vue filtrée dans Gmail se remplit de fils déjà traités.

• Thread ID : la conversation qui perd le libellé, souvent celle que le trigger vient de remonter.
• Label Names or IDs : les libellés à retirer, pris dans la liste déroulante ou fournis en identifiants par une expression ; plusieurs peuvent partir d'un coup.

La réponse part dans la conversation d'origine au lieu d'ouvrir un nouveau fil, comme l'attend un destinataire déjà engagé dans l'échange.

• Thread ID : la conversation où la réponse se glisse.
• Email Type : Text ou HTML, selon que le corps porte ou non de la mise en forme.
• Message : le corps du message, écrit dans l'éditeur d'expressions quand il mélange texte fixe et données du nœud précédent.
• Reply to Sender Only : dans Options, la réponse ne part qu'à l'expéditeur ; Reply to Recipients Only l'exclut, et CC, BCC, Sender Name et Attachments sont au même endroit.

La corbeille déplace la conversation et tous ses messages hors de la boîte sans les détruire. C'est l'opération à préférer quand la règle de tri peut se tromper.

• Thread ID : la conversation à mettre à la corbeille, alimentée par n'importe quelle étape en amont qui renvoie un fil.

Parfois la règle qui a envoyé un fil à la corbeille était trop large. Cette opération récupère la conversation et tous ses messages depuis la corbeille et les remet dans la boîte.

• Thread ID : l'identifiant de la conversation à restaurer, ce qui suppose de l'avoir gardé quelque part au moment de la mise à la corbeille.