Aller au contenu

E-mail · Étape

Lire des e-mails `mail.read`

Lit les messages d'un compte e-mail (IMAP) configuré dans l'Orchestrator.

Type: mail.read
Famille: E-mail
Exécuté par: Orchestrator
Quand l’utiliser: Traiter les factures reçues par e-mail, réagir à des demandes entrantes.

Synopsis

{
  "id": "mails",
  "type": "mail.read",
  "label": "Lire les factures reçues",
  "props": {
    "account": "Compta",
    "folder": "INBOX",
    "unread_only": "true",
    "subject": "Facture",
    "limit": "20",
    "into": "emails"
  }
}

Propriétés

Toutes les valeurs s’écrivent en chaînes JSON et acceptent l’interpolation {{variable}}. Voir Objet Étape.

Propriété	Type	Requis	Défaut	Description
`account`	texte	oui	—	Nom du compte e-mail (ZOKAS Agent › E-mail). Ex. `Compta`
`folder`	texte	non	`INBOX`	Dossier IMAP.
`unread_only`	booléen	non	`true`	Messages non lus seulement.
`from`	texte	non	—	Filtre sur l'expéditeur (contient).
`subject`	texte	non	—	Filtre sur le sujet (contient). Ex. `Facture`
`limit`	nombre	non	`20`	Nombre maximum de messages.
`mark_seen`	booléen	non	`false`	Marquer les messages comme lus.
`into`	variable	non	`emails`	Variable liste.

Résultat

Variable: emails — modifiable par into
Nature: liste d'objets
Contenu: Un objet par message. Voir l’objet Message e-mail.

Remarques

Le mot de passe du compte est stocké chiffré par l'Orchestrator, jamais dans le processus.

Erreurs fréquentes

Message	Cause	Solution
`compte e-mail introuvable`	Nom inconnu.	Créez le compte dans ZOKAS Agent › E-mail.

Voir aussi

Source : orchestrator/zokas_orch/runtime.py — PackageRunner._mail ; orchestrator/zokas_orch/automation.py — read_mail

Mis à jour le 28 octobre 2026