Mankomail

Mail reçu ​

Démarre le workflow à l’arrivée d’un mail qui correspond aux conditions.

Le déclencheur Mail reçu démarre le workflow quand un nouveau mail arrive dans l’une de vos boîtes et correspond à ses conditions. C’est le seul déclencheur qui apporte un mail porteur : tous les nœuds qui agissent sur ce mail (répondre dans le fil, Classer, Marquer, les nœuds IA qui lisent le corps) peuvent le suivre. Le mail se lit avec {{ email.… }}, pas sous data ; data part vide et se remplit des sorties des étapes.

Les conditions forment un arbre de lignes combinées par « toutes » ou « au moins une », comme dans le nœud Condition. Sans aucune condition, tout mail éligible de vos boîtes démarre le workflow. Les champs et les opérateurs sont décrits dans Déclencheurs et conditions.

Un workflow peut porter plusieurs déclencheurs Mail reçu, un par jeu de conditions. Préférez Lancement manuel quand le workflow ne doit partir qu’à votre demande.

En bref ​

  • Type : trigger.email · version 1
  • Catégorie : Déclencheurs
  • Nature : Déclencheur — lance une exécution
  • Effet : Sans effet externe (none) — rien n’est écrit hors de Mankomail ; rejouable sans risque
  • Exige un mail porteur : Non
  • Connexion : Aucune
  • Sorties : main

Paramètres ​

conditions ​

Conditions — Les mails qui déclenchent ce workflow. Aucune condition = tous les mails de vos boîtes. Les pièces jointes sont des champs comme les autres : « a une PJ PDF » s’écrit attachments.mimeTypes contient application/pdf, et « a une PJ » s’écrit attachments.count supérieur à 0 (les logos de signature ne comptent pas).

  • Type : Arbre de conditions (conditions)
  • Requis : Non
  • Teste les champs du mail reçu

multiMatch ​

Si plusieurs workflows correspondent

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : inherit
  • Options :
    • inherit — Suivre mon réglage : La politique choisie dans vos préférences décide quand plusieurs workflows réclament le même mail.
    • all — Tous se déclenchent : Chaque workflow qui correspond a sa propre exécution.
    • priority — Le premier seulement : Routage exclusif, façon règles de messagerie : le workflow le mieux classé gagne.

Sorties ​

  • main — Emprunté par chaque exécution que ce déclencheur lance : le mail correspondait aux conditions.

Données produites ​

Ce que ce nœud ajoute aux données de l’exécution, et comment le lire dans une expression. <step> désigne la clé de l’étape : le nom du nœud ramené à un identifiant (voir Données et expressions).

  • {{ email.subject }} — string. Objet décodé du mail déclencheur. Chaîne vide si le mail n’en a pas.
  • {{ email.from.email }} — string. Adresse de l’expéditeur, normalisée (domaine en minuscules).
  • {{ email.from.name }} — string. Nom affiché de l’expéditeur, quand le mail en porte un.
  • {{ email.to }} — array of { name, email }. Destinataires. email.cc, email.bcc et email.replyTo ont la même forme ; email.to.0.email lit la première adresse.
  • {{ email.receivedAt }} — string. Heure de réception constatée par le fournisseur, ISO 8601 en UTC. email.sentAt porte la date déclarée par l’expéditeur, quand elle existe.
  • {{ email.bodyText }} — string. Corps texte décodé, dérivé du HTML quand le mail n’a que du HTML. email.bodyHtml porte le corps HTML, non nettoyé.
  • {{ email.attachments }} — array of { filename, mime, size, disposition }. Métadonnées des pièces jointes (sans contenu). disposition vaut attachment ou inline ; size est en octets. email.attachments.0.filename lit le premier nom.
  • {{ email.folderLabels }} — array. Dossiers IMAP ou libellés Gmail portés par le mail.
  • {{ email.flags.seen }} — boolean. Indicateur « lu ». email.flags porte aussi flagged, draft et sent.
  • {{ email.signals.isAutoReply }} — boolean. Signal calculé à l’ingestion. email.signals porte aussi isNoReply, isMailingList et isFromSelf.
  • {{ email.threadProviderId }} — string. Identifiant du fil chez le fournisseur (fil Gmail, conversation Graph), quand il est connu.

Example ​

Traiter les factures fournisseurs envoyées en PDF. Ajoutez un déclencheur Mail reçu dont conditions vaut « toutes » parmi :

from.domain             a pour domaine   fournisseur.example
attachments.mimeTypes   contient         application/pdf

Publiez le workflow. À l’arrivée d’une facture, une exécution démarre sur le port main. En aval, un nœud peut écrire :

Facture de {{ email.from.name }} — {{ email.subject }}
Première pièce jointe : {{ email.attachments.0.filename }}

Tips ​

  • Seuls les nouveaux mails déclenchent : ceux reçus après la connexion de la boîte, livrés par la synchronisation (pas par l’import initial de l’historique), et dans votre périmètre. Les mails des dossiers Envoyés, Spam, Corbeille et Brouillons ne déclenchent jamais.
  • Des garde-fous intégrés écartent, avant qu’un workflow ne les voie, les mails envoyés depuis vos propres boîtes, les réponses automatiques, les messages de listes de diffusion et ceux des adresses « no-reply ». Un tel mail ne lance jamais d’exécution, quelles que soient les conditions.
  • Un mail lance au plus une exécution par version publiée d’un workflow. Si deux déclencheurs Mail reçu du même workflow correspondent au même mail, une seule exécution est créée, et le détail d’exécution indique quel déclencheur a réclamé le mail.
  • Quand plusieurs workflows correspondent au même mail, la politique appliquée est celle de vos préférences (« Ma politique de déclenchement », sur la page du périmètre) : tous les workflows qui correspondent s’exécutent, ou seulement le premier dans l’ordre de priorité. Le paramètre « Si plusieurs workflows correspondent » de ce nœud ne remplace pas cette préférence aujourd’hui.
  • Le déclencheur est armé à la publication. Un workflow en pause garde son armement mais ne lance aucune exécution tant qu’il n’est pas repris.
  • Pour tester, choisissez un mail de vos boîtes dans l’éditeur : l’essai exécute le brouillon sur ce mail (voir Essais).
  • Un chemin qui n’existe pas (un mail sans Cc, par exemple) rend une chaîne vide et consigne un avertissement sur l’étape ; l’exécution n’échoue pas.