Email Bounce (IMAP)

trigger_email_bounce · trigger · Triggers · Disponibile · v1.0.0

Descrizione

Monitora una mailbox IMAP e avvia il workflow SOLO quando arriva un bounce (Delivery Status Notification, RFC 3464) — l'avviso "email non recapitata" inviato da MAILER-DAEMON/postmaster. Le email normali nella stessa mailbox vengono ignorate. Differenza con i sibling: trigger_email_bounce = SOLO i rimbalzi, con payload strutturato. Per ingest email generico (con filtri subject/from/allegati) usa trigger_imap. Per inviare email usa action_send_email. Riconoscimento (RFC 3464/3463): rileva il report-type=delivery-status, la parte message/delivery-status o i campi DSN (Action/Status/Final-Recipient); in mancanza, i segnali deboli (mittente MAILER-DAEMON + subject di tipo "delivery failed"). Classifica hard (codice 5.x.x = permanente, rimuovi il contatto) vs soft (4.x.x = transitorio, ritenta più tardi). Output del nodo (triggerInput.bounce): failedRecipients[], bounceType (hard|soft|unknown), status (es. "5.1.1"), action, diagnosticCode, originalMessageId (per correlare al run d'invio), reportingMta. Più i campi email standard (subject, from, date, headers). Infrastruttura riusata da trigger_imap: cursore UID persistente, dedup per Message-ID (exactly-once), markSeen on-success, circuit breaker per host. Credenziali dal vault per-tenant (Settings → Email Accounts) o inline. Use case: (1) cold outreach — rimuovi dalla lista i contatti con hard bounce per proteggere la reputation del dominio, (2) notifica al mittente quando una fattura PEC rimbalza, (3) aggiorna il CRM marcando l'indirizzo come non valido.

⚙️ 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	—	Account IMAP dal vault per-tenant. Se selezionato, host/port/credenziali vengono da lì.
`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`	Dove arrivano i bounce. Di norma INBOX (i DSN tornano al mittente). Se hai una regola che li smista, indica quella cartella.
`pollIntervalSec` Intervallo polling (secondi)	`number`	no	`120`	Frequenza di controllo. I bounce non sono urgenti → 120s di default.
`onlyUnseen` Solo email NON LETTE	`boolean`	no	`false`	Se ON, considera solo i messaggi \Seen=false. Il dedup resta sul Message-ID.
`markSeen` Quando marcare come letta	`enum` `on-successalwaysnever`	no	`on-success`	on-success (raccomandato) = marca letta solo se il workflow completa. always = sempre. never = mai.
`tlsMode` Cifratura	`enum` `tlsstarttlsplain`	no	`tls`	tls = porta 993 (raccomandato). starttls = 143. plain = nessuna cifratura.

💡 Esempio configurazione

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

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

🔗 Nodi correlati nella stessa categoria

Pronto a usare Email Bounce (IMAP)?

Disponibile da subito in tutti i piani FlowForge. Provalo gratis senza carta di credito.

Inizia gratis Sfoglia tutti i nodi