Invio SMTP per email transazionali

Oltre all'API HTTP, Flexmail supporta l'invio di email transazionali tramite SMTP. Questo è utile quando l'applicazione o la piattaforma dispone già del supporto SMTP integrato — un CMS, una piattaforma di e-commerce o un sistema legacy che invia email tramite un relay SMTP.

L'invio SMTP è incluso nel prodotto transazionale senza costi aggiuntivi. Offre la stessa affidabilità di consegna e le stesse capacità di tracciamento dell'API, con alcune differenze nelle impostazioni predefinite e nelle funzionalità supportate.

Nota

L'invio SMTP non è abilitato per impostazione predefinita. È necessario richiedere esplicitamente l'accesso. Si consulti "Richiedere l'accesso" di seguito.

Richiedere l'accesso

L'accesso SMTP non viene abilitato automaticamente quando si attiva il prodotto transazionale. Per richiedere le credenziali SMTP per il proprio account, contattare il supporto Flexmail all'indirizzo support@flexmail.eu e includere l'ID del proprio account nella richiesta. Il nome utente e la password SMTP verranno forniti come parte della risposta con le credenziali.

Nota

Le credenziali SMTP sono separate dal token di accesso personale. Il nome utente e la password per SMTP vengono forniti da Flexmail su richiesta — non usare l'ID dell'account e il token di accesso personale come credenziali SMTP.

Impostazioni di connessione

Una volta concesso l'accesso SMTP, usare le seguenti impostazioni:

Impostazione

Valore

Server

submission.flexmail.eu

Porta

587

Sicurezza connessione

STARTTLS

Nome utente

Fornito da Flexmail su richiesta

Password

Fornita da Flexmail su richiesta

Intestazioni personalizzate

Gli invii SMTP supportano diverse intestazioni personalizzate opzionali che controllano il comportamento dei messaggi e il tracciamento. Funzionano in modo simile alle opzioni disponibili nell'API HTTP.

Intestazione

Descrizione

X-Flexmail-Tag

Aggiunge un tag per categorizzare i messaggi e accumulare statistiche. Deve essere in formato snake_case (1–50 caratteri, ad es. order_confirmation).

X-Flexmail-Metadata-{key}

Aggiunge metadati personalizzati come coppie chiave/valore. Sostituire {key} con il nome del campo in snake_case. Il valore deve essere di 1–80 caratteri.

X-Flexmail-Open-Tracking

Impostare su true per abilitare il tracciamento delle aperture. Disabilitato per impostazione predefinita.

X-Flexmail-Link-Tracking

Impostare su true per abilitare il tracciamento dei link. Disabilitato per impostazione predefinita.

Esempio:

X-Flexmail-Tag: order_confirmation X-Flexmail-Metadata-order_id: 12345 X-Flexmail-Metadata-customer_id: C-789 X-Flexmail-Open-Tracking: true X-Flexmail-Link-Tracking: true

Nota

Il tracciamento delle aperture e dei link è disabilitato per impostazione predefinita sia per gli invii SMTP che per l'API HTTP. Aggiungere le intestazioni corrispondenti se si desidera abilitare il tracciamento.

ID messaggio e correlazione con i webhook

L'intestazione Message-ID originale dell'email inviata viene automaticamente memorizzata come metadati sotto la chiave original_message_id. Questo consente di correlare gli eventi di consegna dei webhook con i messaggi inviati dal proprio sistema.

SMTP vs. API HTTP

I due metodi presentano alcune differenze nelle impostazioni predefinite e nelle funzionalità:

Funzionalità

API HTTP

Invio SMTP

Tracciamento aperture

Disabilitato per impostazione predefinita

Tracciamento link

Disabilitato per impostazione predefinita

Message-ID originale

N/A

Conservato come metadati original_message_id

Allegati inline

Supportati

Non supportati

Email solo testo normale

Supportata

Non supportata

Funzionalità supportate

Email HTML con o senza una parte in testo normale multipart.
Tracciamento aperture e link (tramite intestazioni personalizzate).
Destinatari CC e BCC.
Allegati — devono essere codificati in base64. Gli allegati inline non sono supportati.
Limitazione della frequenza per destinatario, coerente con i limiti di frequenza dell'API.

Requisiti

L'indirizzo From deve essere un mittente verificato nell'account Flexmail.
Il dominio di invio deve essere autenticato con SPF, DKIM e DMARC, e deve essere configurato un return-path. Questi requisiti sono gli stessi dell'API HTTP.

Gestione degli errori

Gli errori di invio vengono segnalati tramite un NDR (Rapporto di mancata consegna) inviato all'indirizzo del mittente della busta. Gli eventi di bounce e tutti gli altri eventi del messaggio sono disponibili anche tramite l'endpoint dei dettagli del messaggio e i webhook, nello stesso modo degli invii API.

Passi successivi

Si consulti "Iniziare con l'API transazionale" per l'intero processo di configurazione dell'account.
Si consulti "Webhook transazionali" per ricevere eventi di consegna e tracciamento in tempo reale.
Si consulti "Risoluzione dei problemi transazionali" se la connessione SMTP o la recapitabilità non funzionano come previsto.