Riferimento

Header email

A cosa servono gli header email più comuni, da From e Reply-To a DKIM-Signature e List-Unsubscribe, e quali Emailit aggiunge, riscrive o rimuove quando invia.

Aggiornato il 1 ott 2026

Gli header sono le righe Name: value all’inizio di ogni email. Contengono mittente, destinatari, oggetto, cronologia dell’instradamento e risultati dell’autenticazione. Questa pagina spiega gli header che probabilmente esaminerai o imposterai più spesso, e cosa fa Emailit con ciascuno quando invia la tua posta.

Busta e header

Un’email ha due serie di indirizzi, che non devono per forza coincidere:

	Busta	Header
Mittente	`MAIL FROM`, l’indirizzo dei bounce. Emailit lo imposta sul tuo return path, un indirizzo su `emailit.yourdomain.com`.	`From`, l’indirizzo che vedono i destinatari. Lo imposti tu.
Destinatari	`RCPT TO`, dove il server consegna effettivamente.	`To` e `Cc`, che i destinatari vedono. `Bcc` non viene mai mostrato.

I server riceventi controllano l’SPF sul mittente della busta e il DKIM sulla firma, poi DMARC controlla che almeno uno di questi domini sia allineato con l’header From.

Come impostare gli header

API email. Usa i campi from, to, cc, bcc, reply_to e subject, e passa qualsiasi altro header nell’oggetto headers. Vedi Header e metadati.
SMTP. Emailit invia il messaggio MIME che la tua app gli passa, con le modifiche elencate qui sotto. Vedi Header SMTP.

Riferimento degli header

La colonna Emailit indica se Emailit aggiunge, riscrive o rimuove l’header, oppure lo lascia a te.

Indirizzi e oggetto

Header	Scopo	Emailit
`From`	L’indirizzo e il nome visualizzato dell’autore, mostrati ai destinatari.	Lo imposti tu. Deve usare un dominio di invio verificato del workspace, senza distinzione tra maiuscole e minuscole. Altrimenti l’API restituisce `422` e l’SMTP restituisce `530`.
`Sender`	L’indirizzo che ha effettivamente inviato il messaggio quando è diverso da `From`, ad esempio un assistente che invia per conto di un manager.	Passato senza modifiche. Emailit controlla solo `From`.
`Reply-To`	Dove arrivano le risposte al posto dell’indirizzo `From`.	Lo imposti tu. Emailit lo rimuove quando contiene gli stessi indirizzi di `From`, perché i filtri antispam lo penalizzano.
`To`	I destinatari principali, visibili a tutti.	Lo imposti tu. Ogni destinatario riceve una copia separata con il proprio ID email.
`Cc`	I destinatari in copia visibili.	Lo imposti tu. Ogni destinatario riceve una copia separata.
`Bcc`	I destinatari in copia nascosta.	Rimosso dal messaggio prima della consegna. I destinatari in Bcc ricevono comunque la loro copia.
`Subject`	La riga dell’oggetto.	La imposti tu. Emailit codifica i caratteri non ASCII (RFC 2047), così accenti e alfabeti non latini vengono visualizzati correttamente.
`Date`	Quando è stato scritto il messaggio.	Impostato da Emailit sull’ora in cui invia il messaggio.

Identificazione e conversazioni

Header	Scopo	Emailit
`Message-ID`	Un ID univoco a livello globale del messaggio, nel formato `<id@domain>`.	Impostato da Emailit su un ID del tuo dominio di invio, che sostituisce qualsiasi valore inviato da te. L’API lo restituisce come `message_id`.
`In-Reply-To`	Il `Message-ID` del messaggio a cui si risponde. I client di posta lo usano per raggruppare le conversazioni.	Passato senza modifiche. Impostalo con il campo `headers` o nel tuo MIME.
`References`	La catena dei valori `Message-ID` di una conversazione.	Passato senza modifiche.

Instradamento e tracce

Header	Scopo	Emailit
`Return-Path`	Il mittente della busta, di solito aggiunto dal server ricevente al momento della consegna finale.	Impostato da Emailit su un indirizzo su `emailit.yourdomain.com`, così i bounce arrivano a Emailit e l’SPF viene controllato sul tuo dominio. Non puoi modificarlo.
`Received`	Una riga per ogni server attraversato dal messaggio, a partire dal più recente. Utile per individuare i ritardi.	Aggiunto dall’API o dall’SMTP relay di Emailit e dal suo MTA. L’SMTP relay rifiuta un messaggio con `550 Loop detected` dopo più di 4 passaggi attraverso il relay.

Struttura MIME

Header	Scopo	Emailit
`MIME-Version`	Dichiara che il messaggio usa MIME, sempre `1.0`.	Generato dall’API. Passato senza modifiche via SMTP.
`Content-Type`	Il tipo del corpo o della parte, come `text/html`, `multipart/alternative` o `multipart/mixed`, e il relativo set di caratteri.	Generato dall’API a partire da `html`, `text` e `attachments`. Passato senza modifiche via SMTP.
`Content-Transfer-Encoding`	Come viene codificata una parte per il trasporto, ad esempio `quoted-printable`, `base64` o `7bit`.	Generato dall’API. Passato senza modifiche via SMTP.

Autenticazione

Header	Scopo	Emailit
`DKIM-Signature`	Una firma crittografica del corpo e di alcuni header, verificata con la chiave pubblica pubblicata nei DNS.	Aggiunto da Emailit con `d=` impostato sul tuo dominio e il selettore `emailit`, più una seconda firma per `emailitmail.com` che i provider di posta usano per i feedback loop.
`Authentication-Results`	I verdetti SPF, DKIM e DMARC del server ricevente.	Aggiunto dal server del destinatario, non da Emailit. Leggilo nella copia del destinatario per eseguire il debug dell’autenticazione.
`ARC-Seal`, `ARC-Message-Signature`, `ARC-Authentication-Results`	Authenticated Received Chain: i servizi di inoltro e le mailing list registrano i risultati di autenticazione che hanno visto, così i server successivi possono fidarsene.	Non aggiunti da Emailit. Li aggiungono gli intermediari che inoltrano la tua posta.

Liste e posta automatica

Header	Scopo	Emailit
`List-Unsubscribe`	Un link `mailto:` o `https:` che permette ai provider di posta di mostrare un pulsante di disiscrizione.	Aggiunto a ogni email delle campagne, con un link alla pagina di disiscrizione ospitata. Per le email inviate via API o SMTP, aggiungine uno tuo con il campo `headers` o nel tuo MIME.
`List-Unsubscribe-Post`	Impostato su `List-Unsubscribe=One-Click` per consentire la disiscrizione con un clic (RFC 8058). Gmail e Yahoo lo richiedono per gli invii massivi.	Aggiunto a ogni email delle campagne insieme a `List-Unsubscribe`.
`Feedback-ID`	Un identificatore che i provider di posta includono nei dati sulle segnalazioni, così i mittenti possono raggrupparli.	Aggiunto da Emailit a ogni messaggio, nel formato `:campaign-id:workspace-id:Emailit`.
`Precedence`	Una vecchia indicazione come `bulk` o `list` che alcuni risponditori automatici rispettano.	Non aggiunto. Puoi impostarlo tu.
`Auto-Submitted`	Contrassegna un messaggio come generato automaticamente, ad esempio `auto-generated` o `auto-replied`, così gli altri sistemi non gli rispondono.	Non aggiunto. Impostalo sulle risposte automatiche per evitare loop di posta.

Header di Emailit

Header	Scopo	Emailit
`X-Emailit-ID`	Il token interno dell’email. Emailit lo usa per associare i messaggi di bounce all’email originale.	Aggiunto a ogni messaggio. Non rimuoverlo se inoltri la posta di Emailit attraverso un altro sistema.
`X-Emailit-Tag`	Un header legacy per assegnare tag alle email.	Emailit non lo legge. Viene passato come qualsiasi header personalizzato.
`X-Emailit-Meta`	I metadati dell’email, codificati in base64.	Aggiunto dall’API quando invii `meta`. Resta nel messaggio consegnato, quindi non inserire secret nei metadati.
`X-Emailit-Tracking`	Le impostazioni di tracciamento di aperture e clic dell’email.	Aggiunto dall’API quando attivi il tracciamento per un invio.