systemAccountId Account email (Settings → Email Accounts) | email-account-picker | no | — | Se selezionato, l'engine usa SMTP host/port/credentials di quell'account. I campi SMTP sottostanti sono ignorati. |
host SMTP host | string | no | — smtp.example.com | — |
port SMTP port | number | no | 465 | 465 = SMTPS (TLS implicito). 587 = STARTTLS. 25 = plain (sconsigliato). |
security Security | enumtlsstarttlsplain
| no | tls | tls = TLS immediato (port 465). starttls = upgrade da plain (port 587). plain = nessuna cifratura. |
username SMTP username | string | no | — | — |
password SMTP password | string (encrypted) | no | — | — |
from From (override account) | string | no | — Mario Rossi <[email protected]> | Lascia vuoto per usare il from dell'account selezionato. Formato: "Nome <email@dominio>" oppure solo email. |
replyTo Reply-To | string | no | — [email protected] | Indirizzo a cui il destinatario risponderà se clicca "Rispondi". Diverso da From — utile per inviare da un service account e ricevere risposte su una casella reale. |
to To (separati da virgola) | string | si | — [email protected], [email protected] | — |
cc CC (separati da virgola) | string | no | — | — |
bcc BCC (separati da virgola) | string | no | — | — |
inReplyTo In-Reply-To (Message-ID originale) | string | no | — <[email protected]> | Per rispondere ad un'email esistente. Mette il messaggio nello stesso thread per il destinatario. Mantieni le parentesi angolari < >. |
references References (Message-ID separati da spazio) | string | no | — | Catena di Message-ID precedenti del thread. Tipicamente: il References originale + lo spazio + il Message-ID a cui rispondi. |
subject Subject | string | si | — Conferma ordine #{{input.orderId}} | — |
bodyType Body type | enumtexthtmlmarkdown
| si | html | text = plain (massima deliverability). html = formattato. markdown = converte in HTML server-side. |
body Body | rich-text | si | — | Editor visuale (grassetto/corsivo/liste/link). Switcha "HTML" nella barra per editare il sorgente. Se Body type = "text", il contenuto viene inviato come plain text. |
priority Priorità | enumnormalhighlow
| no | normal | high = X-Priority: 1 + Importance: High. low = X-Priority: 5 + Importance: Low. Alcuni client mostrano un'icona, ma NON è un canale rapido. |
headersJson Header personalizzati | key-value | no | — | Header custom da aggiungere (es. X-Mailer=FlowForge, List-Unsubscribe=<mailto:...>, Auto-Submitted=auto-generated). |
deliverabilityCheck Pre-flight deliverability (SPF/DKIM/DMARC) | enumoffwarnstrict
| no | off | Verifica i record DNS del dominio mittente PRIMA di inviare. Senza DKIM/SPF, ~60% delle email finisce in spam (Gmail/Outlook).
• off (default): nessun check, back-compat.
• warn: esegue check, logga warning se mancano, MA invia comunque.
• strict: esegue check, FALLISCE il nodo se SPF/DKIM/DMARC mancanti (CONSIGLIATO per cold outreach + workflow lead-gen).
Cache 1h sul fromAddress → cost ~0 in produzione. Output del nodo include sempre il report deliverability quando il check è attivo (visibile nel RunInspector). |
attachmentsJson Allegati | attachments | no | — | Carica file dal computer (base64), oppure URL pubblico, oppure path sul server. File grandi conviene linkarli via URL. |
inlineImagesJson Immagini inline (CID) | attachments | no | — | Immagini referenziate nel body HTML con src="cid:<nome>". Esempio: aggiungi qui un file "logo.png" e usa <img src="cid:logo.png"> nel body. A differenza degli allegati normali, le inline non appaiono come file da scaricare ma sono renderizzate dentro il messaggio. |
dkimDomain DKIM domain (opzionale) | string | no | — example.com | Se valorizzato: firma il messaggio con DKIM. Devi anche compilare selector + private key sotto. Lascia vuoto se il provider SMTP firma per te (Postmark, SendGrid). |
dkimSelector DKIM selector | string | no | — default | — |
dkimPrivateKey DKIM private key (PEM) | string (encrypted) | no | — | Chiave privata RSA in formato PEM. Tipicamente -----BEGIN RSA PRIVATE KEY-----... |