Email (IMAP)

Descrizione

Innesco enterprise IMAP che monitora periodicamente una inbox email e attiva il workflow alla ricezione di nuovi messaggi che corrispondono ai filtri configurati — il backbone di tutte le pipeline email-driven business critical: triage automatic email customer support, ingest PEC con allegato fattura per studio commercialista, parse ordini cliente legacy ricevuti via email, archiviazione legale a norma di messaggi contrattuali. Implementazione robusta su protocollo IMAP standard RFC 3501 + estensioni IMAP4 IDLE per push real-time (quando supportato dal server email — Gmail/Outlook/Exchange Online/iCloud) e fallback graceful su polling temporizzato (pattern per server IMAP legacy come Aruba, Register.it, Microsoft Exchange On-Premise di vecchia generazione che non supportano IDLE persistent connection). Due modalità di configurazione complementari per coprire i pattern enterprise: (1) selezione di un Account Email di Sistema dal vault centralizzato del tenant (Settings → Email Accounts), pattern preferito per multi-workflow share dello stesso account senza duplicare credentials in N nodi diversi — un singolo "Inbox Studio" config riusato da workflow PEC + workflow customer support; (2) compilazione inline diretta dei campi (IMAP host, port, username, password) per use case one-off senza vault touch — pattern dev/test o quando ogni workflow ha sua mailbox dedicata. Filtri rich: oggetto (substring o regex match — per workflow specifici dedicati a soggetti pattern come "FATTURA*" o "ORDINE*"), mittente (whitelist email/domain o blocklist per noise reduction), presenza allegato (boolean has_attachment + filter per MIME type ".pdf"/".xml"), etichetta IMAP/folder (filtra solo email in folder "INBOX/Importanti" o flagged \Seen=false per processing solo unread), header custom matching per identificare PEC ufficiali con X-Ricevuta. Polling configurable: 30s default per real-time-ish responsive, fino a 30min per inbox low-volume + cost-conscious — il trigger scheduler centrale del portal orchestra il polling senza tenere il container sveglio inutilmente. Dedup intelligent via Message-ID header persistito nel tenant DB — anche con IMAP IDLE + polling overlap, ogni email è processata esattamente UNA volta (exactly-once delivery semantics cruciale per workflow legali con effetto fiscale). Retry automatic su connection errors (network timeout, server down 5xx, auth expired) con exponential backoff + alert al tenant admin dopo 3 falli consecutivi. Use case: trigger automation alla ricezione PEC con allegato fattura per studio commercialista (filter has_attachment=true + sender_domain in PEC provider list — il workflow parsa il pdf con vision_extract, crea fattura in Odoo, archivia legale via action_pec_legal_archive); parsing automatico ordini email cliente B2B verso ERP (PMI italiani che ancora ricevono ordini via email tradizionale non EDI); reply-handling triage AI per support inbox (agent_email_triage classifica intent → routing al team competente); archiviazione legale automatic delle email contrattuali per compliance.

⚙️ Parametri di configurazione

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

💡 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"
  }
}

🔗 Nodi correlati nella stessa categoria