Déclencheur Email

Le déclencheur Email lance une automatisation à partir des nouveaux emails reçus dans une boîte Gmail connectée. Il est utile pour traiter des demandes entrantes, analyser des pièces jointes, classer des messages ou préparer une réponse.

Cette fonctionnalité dépend de la politique définie par votre administrateur. Si le type Email n'apparaît pas, ou si vous ne pouvez pas connecter de boîte, contactez l'administrateur de votre instance.

Configurer le déclencheur

Dans l'éditeur, sélectionnez le nœud de déclencheur.

Dans Type de déclencheur, choisissez Email.

Sélectionnez une Boîte Gmail déjà connectée, ou cliquez sur le bouton de connexion pour autoriser une nouvelle boîte.

Définissez le dossier ou label à surveiller, puis les filtres éventuels.

Sauvegardez et activez l'automatisation.

Paramètres disponibles

Champ	Description
Boîte Gmail	Boîte qui déclenche l'automatisation. Si la connexion est expirée, révoquée ou en pause, l'interface propose de la reconnecter.
Dossier / label	Dossier Gmail à surveiller, par exemple `INBOX`.
Expéditeur contient	Filtre optionnel sur l'adresse ou le nom de l'expéditeur.
Objet contient	Filtre optionnel sur l'objet de l'email.
Uniquement avec pièce jointe	Ignore les emails sans pièce jointe.
Télécharger les pièces jointes	Rend les pièces jointes disponibles pour les actions compatibles.
Récupération initiale	Choisit si l'automatisation traite uniquement les nouveaux emails ou inclut aussi les emails récents au premier démarrage.

Variables disponibles

Tapez @ dans un champ qui supporte les templates pour utiliser les données de l'email.

Variable	Contenu
`email.from`	Adresse de l'expéditeur.
`email.from_name`	Nom de l'expéditeur, si disponible.
`email.to`	Destinataires.
`email.subject`	Objet de l'email.
`email.snippet`	Aperçu court du contenu.
`email.body_text`	Corps texte complet de l'email.
`email.received_at`	Date de réception.
`email.has_attachments`	Indique si l'email contient des pièces jointes.
`email.attachments`	Liste des pièces jointes disponibles pour les actions compatibles.

Utiliser les pièces jointes

Lorsque Télécharger les pièces jointes est activé, les fichiers peuvent être utilisés dans plusieurs actions :

Base de connaissances temporaire : analyser les pièces jointes pendant l'exécution, sans les conserver après le run.
Interroger un document : poser une question sur les documents reçus.
Insérer fichiers dans projet : copier les pièces jointes comme sources permanentes dans un projet.
Agent : permettre à un agent de travailler sur les pièces jointes via la base temporaire.

Patterns courants

Qualifier une demande entrante

Email
  ↓
Condition (l'objet ou le corps indique une urgence)
  ├── Vrai  → Envoyer un email d'alerte
  └── Faux → Créer un document de suivi

Analyser des pièces jointes

Email (avec téléchargement des pièces jointes)
  ↓
Base de connaissances temporaire (source : pièces jointes d'un email)
  ↓
Agent (base temporaire activée)
  ↓
Créer un document

Alimenter un projet

Email (avec pièces jointes)
  ↓
Projet (Créer)
  ↓
Insérer fichiers dans projet
  ↓
Projet (Insérer un résumé)

Erreurs fréquentes

Symptôme	Cause probable
La boîte n'est pas sélectionnable	Elle n'est pas connectée, est en pause ou doit être reconnectée.
Les pièces jointes ne sont pas disponibles	L'option Télécharger les pièces jointes n'est pas activée.
L'automatisation ne démarre pas	Le trigger est désactivé, les filtres sont trop restrictifs, ou la politique email de l'instance ne l'autorise pas.
Le contenu d'un email n'apparaît pas dans les templates	Vérifiez que le nœud déclencheur est bien de type Email et que le champ est référencé via `@`.