Description

Batch variant of tracked email sending, designed for volume-controlled commercial outreach that respects provider anti-spam policies: per-recipient leadId tracking, paced dispatch and per-message customisation.

⚙️ Configuration parameters

Fields shown in the editor when configuring the node. Generated directly from the NodeDefconfigFields.

Field	Type	Required	Default	Description
`systemAccountId` Account email di sistema	`email-account-picker`	no	—	Account configurato in Settings → Email accounts. Se OAuth Gmail, il token viene rinnovato automaticamente quando scade — il batch può durare ore senza interruzioni.
`host` SMTP host (override)	`string`	no	—	Manuale (sconsigliato per batch).
`port` SMTP porta	`number`	no	`587`	587 STARTTLS, 465 TLS implicito.
`security` Sicurezza	`enum` `starttlstlsnone`	no	`starttls`	Lascia starttls salvo motivi specifici.
`username` SMTP username	`string`	no	—	Per Gmail: l\'email completa.
`password` SMTP password	`string (encrypted)`	no	—	Per Gmail: App Password. Per OAuth: NON COMPILARE.
`from` Mittente (From) template	`string`	no	— [email protected]	Indirizzo del mittente. Se vuoto e c\'e\` un account di sistema, eredita il suo fromAddress.
`replyTo` Reply-To	`string`	no	—	Indirizzo dove arrivano le risposte se diverso dal From.
`subject` Oggetto template	`string`	yes	— Ciao {{lead.name}} · una proposta da Redivivo Gin	Supporta interpolazione `{{vars}}` per ogni destinatario.
`body` Corpo template (HTML)	`string (multiline)`	yes	—	Body template HTML. I link verso domini in `clickWhitelist` vengono tracciati; il pixel viene aggiunto in fondo. Le variabili `{{lead.field}}` per ogni destinatario.
`bodyType` Tipo corpo	`enum` `htmltext`	no	`html`	HTML obbligatorio se vuoi il tracking pixel.
`campaignId` Campagna ID	`string`	yes	— redivivo-2026-w23-enoteche-lazio	Stringa libera. Tutti i destinatari di questo batch ereditano questo campaignId.
`trackOpens` Traccia aperture (pixel)	`boolean`	no	`true`	On: inietta pixel 1x1 in ogni email del batch.
`trackClicks` Traccia click (URL rewrite)	`boolean`	no	`true`	On: riscrive i link verso domini whitelisted.
`trackingBaseUrl` URL base tracking	`string`	no	—	URL del runtime FlowForge. Vuoto = eredita FLOWFORGE_PUBLIC_BASE_URL.
`clickWhitelist` Domini permessi nei link	`chip-list`	no	—	Lista di domini (suffix-match) per il tracking link. Vuoto = solo trackingBaseUrl. Mettere "*" per riscrivere TUTTI i link (sconsigliato).
`requireConsent` Richiede consenso GDPR upstream	`boolean`	no	`true`	On (default): rifiuta il batch se l\'input non porta `consentVerified=true`.
`recipients` Lista destinatari (JSON inline)	`JSON object/array`	no	—	Array `[{leadId, to, fromAddress?, templateVars?, sendId?}, …]`. Se vuoto, il nodo legge `$json.recipients` dall\'input upstream (tipicamente un db_query).
`ratePerHour` Rate (email/h)	`number`	no	`60`	Cap superiore di mail/h. Gmail Workspace: 60-100/h per account è il safe spot. Salire a 300+/h significa segnalazioni "soft fail" o ban temporaneo.
`jitter` Jitter (0–0.95)	`number`	no	`0.2`	Variazione casuale del delay tra send (0 = cadenza fissa, 0.5 = ±50%). 0.2 default per apparire "umani" agli antispam senza spaccare il rate.
`maxAttempts` Tentativi per destinatario	`number`	no	`3`	Numero di tentativi (incluso il primo) prima di marcare un destinatario come fallito.
`backoffBaseMs` Backoff base (ms)	`number`	no	`5000`	Backoff esponenziale: backoffBaseMs · 2^(attempt-1), cap 60s. 5_000 → tentativi a 5s, 10s, 20s.
`budgetMs` Budget totale (ms, opzionale)	`number`	no	—	Tempo massimo del batch. Oltre questo, i destinatari residui escono con requeued=true cosi\` un cron a monte li riprende. Vuoto = 2× il tempo ideale.

💡 Configuration example

JSON snippet of the node as it appears in the workflow. Values are derived fromdefaultValue and from required parameters.

{
  "id": "node-action_email_send_tracked_batch-1",
  "defId": "action_email_send_tracked_batch",
  "label": "Email: batch send with tracking",
  "config": {
    "port": 587,
    "security": "starttls",
    "subject": "Ciao {{lead.name}} · una proposta da Redivivo Gin",
    "body": "<body>",
    "bodyType": "html",
    "campaignId": "redivivo-2026-w23-enoteche-lazio",
    "trackOpens": true,
    "trackClicks": true,
    "requireConsent": true,
    "ratePerHour": 60,
    "jitter": 0.2,
    "maxAttempts": 3,
    "backoffBaseMs": 5000
  }
}

Email: batch send with tracking

Description

⚙️ Configuration parameters

💡 Configuration example

🔗 Related nodes in the same category

Ready to use Email: batch send with tracking?