Referencia
Cabeceras de email
Para qué sirven las cabeceras de email más comunes, de From y Reply-To a DKIM-Signature y List-Unsubscribe, y cuáles añade, reescribe o elimina Emailit al enviar.
Las cabeceras son las líneas Name: value del principio de cada email. Contienen el remitente, los destinatarios, el asunto, el historial de enrutamiento y los resultados de autenticación. Esta página explica las cabeceras que más probablemente vas a inspeccionar o configurar, y qué hace Emailit con cada una cuando envía tu correo.
Sobre y cabeceras
Un email tiene dos conjuntos de direcciones, y no tienen por qué coincidir:
| Sobre | Cabeceras | |
|---|---|---|
| Remitente | MAIL FROM, la dirección de rebote. Emailit la configura con tu return-path, una dirección en emailit.yourdomain.com. |
From, la dirección que ven los destinatarios. La configuras tú. |
| Destinatarios | RCPT TO, adonde entrega realmente el servidor. |
To y Cc, que ven los destinatarios. Bcc nunca se muestra. |
Los receptores comprueban SPF con el remitente del sobre y DKIM con la firma, y después DMARC comprueba que al menos uno de esos dominios está alineado con la cabecera From.
Cómo configurar las cabeceras
- API de email. Usa los campos
from,to,cc,bcc,reply_toysubject, y pasa cualquier otra cabecera en el objetoheaders. Consulta Cabeceras y metadatos. - SMTP. Emailit envía el mensaje MIME que entrega tu aplicación, con los cambios que se indican más abajo. Consulta Cabeceras SMTP.
Referencia de cabeceras
La columna Emailit indica si Emailit añade, reescribe o elimina la cabecera, o si la deja en tus manos.
Direcciones y asunto
| Cabecera | Finalidad | Emailit |
|---|---|---|
From |
La dirección y el nombre visible del autor, que ven los destinatarios. | La configuras tú. Debe usar un dominio de envío verificado del espacio de trabajo, sin distinguir mayúsculas y minúsculas. Si no, la API devuelve 422 y SMTP devuelve 530. |
Sender |
La dirección que envió realmente el mensaje cuando no es la de From, por ejemplo un asistente que envía en nombre de un directivo. |
Se pasa sin cambios. Emailit solo comprueba From. |
Reply-To |
Adónde van las respuestas en lugar de a la dirección de From. |
La configuras tú. Emailit la elimina cuando contiene las mismas direcciones que From, porque los filtros de spam lo penalizan. |
To |
Destinatarios principales, visibles para todos. | La configuras tú. Cada destinatario recibe una copia independiente con su propio ID de email. |
Cc |
Destinatarios en copia visibles. | La configuras tú. Cada destinatario recibe una copia independiente. |
Bcc |
Destinatarios en copia oculta. | Se elimina del mensaje antes de la entrega. Los destinatarios en CCO reciben igualmente su copia. |
Subject |
La línea de asunto. | La configuras tú. Emailit codifica los caracteres no ASCII (RFC 2047) para que los acentos y los alfabetos no latinos se muestren correctamente. |
Date |
Cuándo se escribió el mensaje. | Emailit la configura con la hora en que envía el mensaje. |
Identificación e hilos
| Cabecera | Finalidad | Emailit |
|---|---|---|
Message-ID |
Un ID único global del mensaje, con el formato <id@domain>. |
Emailit la configura con un ID en tu dominio de envío, y sustituye cualquier valor que envíes. La API la devuelve como message_id. |
In-Reply-To |
El Message-ID del mensaje al que se responde. Los clientes de correo lo usan para agrupar las conversaciones en hilos. |
Se pasa sin cambios. Configúrala con el campo headers o en tu MIME. |
References |
La cadena de valores Message-ID de un hilo. |
Se pasa sin cambios. |
Enrutamiento y trazabilidad
| Cabecera | Finalidad | Emailit |
|---|---|---|
Return-Path |
El remitente del sobre, que normalmente añade el servidor receptor en la entrega final. | Emailit la configura con una dirección en emailit.yourdomain.com, para que los rebotes lleguen a Emailit y SPF se compruebe con tu dominio. No puedes cambiarla. |
Received |
Una línea por cada servidor por el que pasó el mensaje, de la más reciente a la más antigua. Útil para rastrear retrasos. | La añaden la API o el SMTP relay de Emailit y su MTA. El SMTP relay rechaza un mensaje con 550 Loop detected cuando ha pasado por él más de 4 veces. |
Estructura MIME
| Cabecera | Finalidad | Emailit |
|---|---|---|
MIME-Version |
Declara que el mensaje usa MIME; siempre 1.0. |
La genera la API. Por SMTP se pasa sin cambios. |
Content-Type |
El tipo del cuerpo o de la parte, como text/html, multipart/alternative o multipart/mixed, y su juego de caracteres. |
La genera la API a partir de html, text y attachments. Por SMTP se pasa sin cambios. |
Content-Transfer-Encoding |
Cómo se codifica una parte para el transporte, como quoted-printable, base64 o 7bit. |
La genera la API. Por SMTP se pasa sin cambios. |
Autenticación
| Cabecera | Finalidad | Emailit |
|---|---|---|
DKIM-Signature |
Una firma criptográfica del cuerpo y de determinadas cabeceras, que se comprueba con la clave pública publicada en DNS. | La añade Emailit con d= igual a tu dominio y el selector emailit, más una segunda firma para emailitmail.com que los proveedores de correo usan para los feedback loops. |
Authentication-Results |
Los veredictos SPF, DKIM y DMARC del servidor receptor. | La añade el servidor del destinatario, no Emailit. Léela en la copia del destinatario para depurar la autenticación. |
ARC-Seal, ARC-Message-Signature, ARC-Authentication-Results |
Authenticated Received Chain: los reenviadores y las listas de correo registran los resultados de autenticación que vieron, para que los servidores posteriores puedan fiarse de ellos. | Emailit no las añade. Las añaden los intermediarios que reenvían tu correo. |
Listas y correo automatizado
| Cabecera | Finalidad | Emailit |
|---|---|---|
List-Unsubscribe |
Un enlace mailto: o https: que permite a los proveedores de correo mostrar un botón de baja. |
Se añade a todos los emails de campaña y apunta a la página de baja alojada. En el correo de la API o SMTP, añade la tuya con el campo headers o en tu MIME. |
List-Unsubscribe-Post |
Con el valor List-Unsubscribe=One-Click, permite la baja con un clic (RFC 8058). Gmail y Yahoo la exigen para el correo masivo. |
Se añade a todos los emails de campaña junto con List-Unsubscribe. |
Feedback-ID |
Un identificador que los proveedores de correo incluyen en los datos de quejas para que los remitentes puedan agruparlos. | Emailit la añade a todos los mensajes, con el formato :campaign-id:workspace-id:Emailit. |
Precedence |
Una indicación antigua, como bulk o list, que respetan algunas respuestas automáticas. |
No se añade. Puedes configurarla tú. |
Auto-Submitted |
Marca un mensaje como generado automáticamente, por ejemplo auto-generated o auto-replied, para que otros sistemas no le respondan. |
No se añade. Configúrala en las respuestas automáticas para evitar bucles de correo. |
Cabeceras de Emailit
| Cabecera | Finalidad | Emailit |
|---|---|---|
X-Emailit-ID |
El token interno del email. Emailit lo usa para asociar los mensajes de rebote con el email original. | Se añade a todos los mensajes. No la elimines si retransmites correo de Emailit a través de otro sistema. |
X-Emailit-Tag |
Una cabecera antigua para etiquetar emails. | Emailit no la lee. Se pasa sin cambios como cualquier cabecera personalizada. |
X-Emailit-Meta |
Los metadatos del email, codificados en base64. | La añade la API cuando envías meta. Se mantiene en el mensaje entregado, así que no pongas secretos en los metadatos. |
X-Emailit-Tracking |
La configuración de seguimiento de aperturas y clics del email. | La añade la API cuando activas el seguimiento en un envío. |