tecnico · risposta con fonti
Intestazioni email personalizzate: definizione e implementazione tecnica
Le intestazioni email personalizzate sono campi di metadati non standard aggiunti alla sezione delle intestazioni di un messaggio email. A differenza delle intestazioni standard come Subject o From, le intestazioni personalizzate permettono agli sviluppatori di includere dati specifici dell'applicazione che viaggiano con l'email ma di solito restano nascosti all'utente finale.
Come si implementano
Le intestazioni personalizzate sono coppie chiave-valore poste prima del corpo del messaggio e seguono il formato Nome-Intestazione: Valore. Secondo la RFC 5322, le intestazioni personalizzate iniziano spesso con X per indicare che sono sperimentali o non standard, anche se nei sistemi moderni questa convenzione è meno rigida. Queste intestazioni vengono elaborate dal Mail Transfer Agent durante la transazione SMTP e memorizzate nei metadati del messaggio.
Utilità per il mittente e tracciamento
I mittenti usano le intestazioni personalizzate per trasmettere ID interni, codici campagna o informazioni di instradamento. È fondamentale per le email transazionali, dove un sistema deve correlare un evento di consegna a uno specifico record del database. Con le intestazioni personalizzate puoi tracciare il ciclo di vita di un messaggio attraverso diversi relay senza modificare il contenuto visibile dell'email.
Aspetti operativi
Alcuni provider di servizi email rimuovono o modificano le intestazioni personalizzate per prevenire abusi o garantire la compatibilità. Verifica che l'API o il relay SMTP che hai scelto supporti le intestazioni specifiche che intendi inviare. Sovraccaricare le intestazioni con troppi dati può a volte far scattare i filtri antispam, se il rapporto tra intestazioni e corpo diventa sproporzionato o contiene pattern sospetti.
Esempio concreto
Un'implementazione comune è l'intestazione X-Campaign-ID. Ad esempio, X-Campaign-ID: summer_sale_2024 permette al mittente di capire a quale invio di marketing ha risposto un utente. Puoi usare gli strumenti gratuiti di SendHQ (https://sendhq.cc/tools) per analizzare la configurazione email e assicurarti che il setup tecnico sia ottimizzato per la consegna.
Integrazione con le API
Le API email moderne consentono di passare le intestazioni personalizzate come array o oggetto nel payload JSON. Invece di costruire a mano il flusso di dati SMTP, l'API gestisce la formattazione e colloca correttamente le intestazioni nella struttura MIME prima che il messaggio venga messo in coda per la consegna.
Le domande dei team
Le intestazioni personalizzate influiscono sulla deliverability?
In genere no, ma intestazioni che contengono pattern di spam noti o sono troppo lunghe possono aumentare lo spam score di un messaggio.
Il destinatario può vedere le intestazioni personalizzate?
La maggior parte dei client email le nasconde per impostazione predefinita, ma qualsiasi utente può visualizzare il sorgente di un'email per vedere tutte le intestazioni.
Il prefisso X- è ancora obbligatorio?
La RFC 5322 suggeriva il prefisso X- per le intestazioni non standard, ma oggi la maggior parte dei server di posta moderni non lo richiede più in modo rigoroso.
Fonti primarie
- RFC 5322: formato dei messaggi Internet — RFC Editor
- RFC 5321: Simple Mail Transfer Protocol (SMTP) — RFC Editor