Ouvrir l'app

DocumentationWorkflowsApps et services

Gmail node

Envoyer, rechercher ou lire des e-mails via ton compte Gmail connecté. Les identifiants Google BYO sont stockés dans un profil OAuth chiffré sous Secrets des workflows. Découvrez sa configuration, les entrées et sorties, le test et la résolution des erreurs.

9 min de lectureMis à jour le

Fonction du node

Envoyer, rechercher ou lire des e-mails via ton compte Gmail connecté. Les identifiants Google BYO sont stockés dans un profil OAuth chiffré sous Secrets des workflows.

Utilisez Gmail comme étape clairement définie dans un workflow anymize.

  • Traite 1 entrée.
  • Fournit 1 sortie aux étapes suivantes.
  • S'exécute comme une étape normale du workflow.

Configurer le node

  1. 01Ouvrez un workflow et ajoutez Gmail depuis le catalogue.
  2. 02Sélectionnez votre connexion google_byo. Vous pouvez la créer directement dans le workflow.
  3. 03Renseignez les champs requis et associez les valeurs des étapes précédentes.
  4. 04Testez le node avec un petit jeu de données et vérifiez sa sortie.
  5. 05Reliez la sortie réussie et activez le workflow après un test complet.

Actions et modes

Choisissez la fonction voulue dans Action. Le panneau affiche ensuite les paramètres utiles.

  • Envoyer un e-mail
  • Rechercher des messages
  • Récupérer un message
  • Ajouter des libellés
  • Retirer des libellés
  • Marquer comme lu
  • Marquer comme non lu

Paramètres

ChampSignificationZone
ActionChoix: Envoyer un e-mail, Rechercher des messages, Récupérer un message, Ajouter des libellés, Retirer des libellés, Marquer comme lu, Marquer comme non luStandard
Format d’importConfigurez cette valeur dans le panneau du node.Standard
Compte GoogleSélectionne ton profil Google OAuth configuré. Les actions importées nécessitent cette attribution explicite du compte.Protégé
DestinataireÀ qui va l'e-mail ? Sépare plusieurs adresses par une virgule.Standard
ObjetConfigurez cette valeur dans le panneau du node.Standard
MessageContenu du message. Les e-mails importés conservent leur format texte ou HTML choisi explicitement.Standard
Format du messageChoix: Texte brut, HTMLStandard
Mention n8n du modèleConserve la mention n8n à la fin du message texte si le modèle original la prévoit.Standard
Copie (CC)Configurez cette valeur dans le panneau du node.Standard
Copie cachée (CCI)Configurez cette valeur dans le panneau du node.Standard
Adresse de réponseConfigurez cette valeur dans le panneau du node.Standard
RechercheFiltre comme dans la barre de recherche Gmail, p. ex. from:chef@firma.de, non lus, a:pièce jointe. Vide = tout.Standard
Résultats maxConfigurez cette valeur dans le panneau du node.Standard
ID du messageL'ID de l'e-mail (p. ex. issu d'une étape « Rechercher des messages » précédente).Standard
LibellésSaisis les identifiants des libellés Gmail dans une liste ou utilise les valeurs d’une étape précédente.Standard
Exécuter une fois par élémentDésactivé (par défaut) : le node s'exécute une fois pour tout l'input. Activé : s'il reçoit plusieurs éléments (par ex. de « Séparer la liste »), il s'exécute une fois PAR élément, et {{ $json }} correspond alors à cet élément. C'est ainsi que tu traites une liste de fichiers entrée par entrée.Standard
Si un élément échoue« Ignorer » écrit un champ `error` pour l'élément en échec et poursuit avec les autres, au lieu de perdre toute l'exécution à cause d'un seul fichier illisible.Standard
Pause entre les éléments (millisecondes)Attente avant chaque exécution sauf la première. 1000 = 1 seconde par élément. Utile si le service distant te limite. Maximum 300000 (5 minutes).Standard

Entrées et sorties

EntréeSignificationType
StandardReçoit le résultat complet de l'étape précédente.JSON
SortieSignificationType
StandardMet le résultat à disposition de l'étape suivante au format JSON.JSON

Ce node peut traiter les listes élément par élément. La gestion des erreurs et la pause se trouvent dans les paramètres avancés.

Exemple et test

E-mail de confirmation: commencez avec un petit jeu de données reconnaissable. Vérifiez la sortie et utilisez uniquement les champs présents.

Exemple de test

{
  "to": "kunde@example.com",
  "subject": "Danke für deine Anfrage",
  "body": "Wir melden uns in Kürze zurück."
}

Accès et sécurité

Ce node utilise une connexion google_byo. Vérifiez les autorisations demandées et accordez uniquement les accès requis.

Stockez les clés et identifiants dans le gestionnaire protégé. Ne les insérez jamais dans les champs, données de test ou descriptions.

Résoudre les erreurs

  • Aucune sortie: vérifiez la dernière exécution et les champs fournis par le node précédent.
  • Variable vide: ouvrez la sortie précédente et utilisez un nom de champ réellement présent.
  • Connexion refusée: reconnectez le service avec les autorisations nécessaires.
  • Liste traitée une seule fois: activez l'exécution par élément.

Articles liés