Descrizione

Verifica periodicamente una inbox IMAP; si attiva su nuove email che corrispondono ai filtri. Seleziona un Account Email di Sistema oppure compila i campi inline.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

Campo	Tipo	Required	Default	Descrizione
`systemAccountId` Account email (Settings → Email Accounts)	`email-account-picker`	no	—	Se selezionato, l'engine usa IMAP host/port/credentials di quell'account.
`host` IMAP host	`string`	no	— imap.example.com	—
`port` Port	`number`	no	`993`	—
`username` Username	`string`	no	—	—
`password` Password	`string (encrypted)`	no	—	—
`mailbox` Cartella IMAP	`string`	no	`INBOX`	INBOX = posta in arrivo. Altri esempi: Sent, Drafts, Spam, [Gmail]/All Mail.
`pollIntervalSec` Intervallo polling (secondi)	`number`	no	`60`	Frequenza con cui controllare nuove email. 60s default. Più basso = più chiamate IMAP.
`filterSubject` Filtro subject (regex, opzionale)	`string`	no	— ^(Fattura\|Invoice).*2026	Regex case-sensitive sul subject. Esempi: ^Ordine = inizia con "Ordine" · \[ALERT\] = contiene [ALERT] · .urgente./i = "urgente" qualsiasi case (aggiungi (?i) all'inizio).
`filterFrom` Filtro mittente (regex, opzionale)	`string`	no	— @zeli\.it$	Regex sul "from". Esempi: "@zeli\.it$" = da chiunque del dominio zeli.it · "^info@" = email che parte per info@. Combinato in AND con il filtro subject.
`senderAllowlist` Allowlist mittenti (security — opzionale)	`chip-list`	no	— [email protected], [email protected], [email protected]	Lista ESPLICITA di indirizzi email autorizzati a triggerare questo workflow. Più stringente del "filtro mittente" regex. Se popolato: solo le email da indirizzi in questa lista vengono accettate, tutto il resto viene scartato con audit log. Use case: la casella IMAP è pubblicamente conosciuta (es. [email protected]), ma vuoi accettare ordini SOLO da fornitori/dipendenti specifici — impedisce a estranei di triggerare workflow conoscendo l'indirizzo. Vuoto = solo il filterFrom regex viene applicato.
`filterTo` Filtro destinatario (regex, opzionale)	`string`	no	— ^flowforge@	Regex sui destinatari (To + CC). Utile se la stessa casella riceve email diverse per destinatari diversi.
`hasAttachment` Richiede allegato	`boolean`	no	`false`	Se ON, scarta le email senza allegati. Tipico per workflow di ingest PDF/Excel — evita di sprecare LLM call su email vuote.
`onlyUnseen` Solo email NON LETTE (rispolvera UNREAD = re-trigger)	`boolean`	no	`false`	Se ON, il poll pesca solo email con flag \Seen=false (non lette). Pattern operativo: rimetti come "da leggere" un'email già processata su webmail (es. IONOS/Gmail) per far ripartire il workflow su quel messaggio senza dover mandare una nuova email. Combinata con markSeen=on-success diventa una catena retry idempotente perfetta: ordine fallisce → resta UNREAD → utente fixa la config → rimette UNREAD via webmail → workflow riparte automaticamente. ATTENZIONE: con questa opzione il cursor UID viene ignorato — il dedup è gestito SOLO da imap_processed_messages. Per ri-eseguire una mail già completata con successo, cancella la entry dedup (admin/CLI) o rinomina il Message-ID inoltrandola.
`attachmentMime` Filtro MIME allegato (regex, opzionale)	`string`	no	— application/(pdf\|x-pdf)	Solo email che contengono almeno un allegato con questo MIME type. Tipici: application/pdf, image/., application/vnd.openxmlformats-. (Office).
`markSeen` Quando marcare l'email come letta	`enum` `on-successalwaysnever`	no	`on-success`	on-success (raccomandato per produzione) = l'email resta UNREAD finché il workflow non completa con successo, così un ordine fallito viene ri-tentato al prossimo poll. always = marca sempre letta (rischio: ordine perso se il run fallisce). never = non marca mai, l'operatore gestisce i flag a mano.
`tlsMode` Cifratura	`enum` `tlsstarttlsplain`	no	`tls`	tls = porta 993 (raccomandato). starttls = porta 143. plain = NESSUNA cifratura (usare solo in rete fidata).

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-trigger_imap-1",
  "defId": "trigger_imap",
  "label": "Email (IMAP)",
  "config": {
    "port": 993,
    "mailbox": "INBOX",
    "pollIntervalSec": 60,
    "hasAttachment": false,
    "onlyUnseen": false,
    "markSeen": "on-success",
    "tlsMode": "tls"
  }
}

Email (IMAP)

Descrizione

⚙️ Parametri di configurazione

💡 Esempio configurazione

🔗 Nodi correlati nella stessa categoria

Pronto a usare Email (IMAP)?