Référence
En-têtes d’e-mail
Le rôle des en-têtes d’e-mail courants, de From et Reply-To à DKIM-Signature et List-Unsubscribe, et ceux qu’Emailit ajoute, réécrit ou supprime à l’envoi.
Les en-têtes sont les lignes Name: value situées en haut de chaque e-mail. Ils contiennent l’expéditeur, les destinataires, l’objet, l’historique d’acheminement et les résultats d’authentification. Cette page présente les en-têtes que vous aurez le plus probablement à consulter ou à définir, et ce qu’Emailit fait de chacun quand il envoie vos e-mails.
Enveloppe et en-têtes
Un e-mail comporte deux jeux d’adresses, qui ne sont pas forcément identiques :
| Enveloppe | En-têtes | |
|---|---|---|
| Expéditeur | MAIL FROM, l’adresse de rebond. Emailit la définit sur votre return-path, une adresse sur emailit.yourdomain.com. |
From, l’adresse que voient les destinataires. C’est vous qui la définissez. |
| Destinataires | RCPT TO, où le serveur livre réellement le message. |
To et Cc, que voient les destinataires. Bcc n’est jamais affiché. |
Les destinataires vérifient SPF par rapport à l’expéditeur d’enveloppe et DKIM par rapport à la signature, puis DMARC vérifie qu’au moins l’un de ces domaines est aligné sur l’en-tête From.
Définir les en-têtes
- API e-mail. Utilisez les champs
from,to,cc,bcc,reply_toetsubject, et transmettez tout autre en-tête dans l’objetheaders. Consultez En-têtes et métadonnées. - SMTP. Emailit envoie le message MIME soumis par votre application, avec les modifications listées ci-dessous. Consultez En-têtes SMTP.
Référence des en-têtes
La colonne Emailit indique si Emailit ajoute, réécrit ou supprime l’en-tête, ou s’il vous le laisse.
Adresses et objet
| En-tête | Rôle | Emailit |
|---|---|---|
From |
L’adresse et le nom d’affichage de l’auteur, visibles par les destinataires. | C’est vous qui le définissez. Il doit utiliser un domaine d’envoi vérifié de l’espace de travail, comparé sans tenir compte de la casse. Sinon, l’API renvoie 422 et SMTP renvoie 530. |
Sender |
L’adresse qui a réellement envoyé le message quand elle diffère de From, par exemple un assistant qui envoie pour le compte d’un responsable. |
Transmis tel quel. Emailit ne vérifie que From. |
Reply-To |
L’adresse où arrivent les réponses à la place de l’adresse From. |
C’est vous qui le définissez. Emailit le supprime lorsqu’il contient les mêmes adresses que From, car les filtres anti-spam pénalisent ce cas. |
To |
Les destinataires principaux, visibles par tous. | C’est vous qui le définissez. Chaque destinataire reçoit une copie distincte avec son propre ID d’e-mail. |
Cc |
Les destinataires en copie visible. | C’est vous qui le définissez. Chaque destinataire reçoit une copie distincte. |
Bcc |
Les destinataires en copie cachée. | Retiré du message avant la livraison. Les destinataires en copie cachée reçoivent quand même leur copie. |
Subject |
La ligne d’objet. | C’est vous qui le définissez. Emailit encode les caractères non ASCII (RFC 2047) pour que les accents et les écritures non latines s’affichent correctement. |
Date |
La date de rédaction du message. | Défini par Emailit à l’heure à laquelle il envoie le message. |
Identification et fils de discussion
| En-tête | Rôle | Emailit |
|---|---|---|
Message-ID |
Un ID unique au monde pour le message, au format <id@domain>. |
Défini par Emailit sur un ID de votre domaine d’envoi, qui remplace toute valeur que vous envoyez. L’API le renvoie dans message_id. |
In-Reply-To |
Le Message-ID du message auquel on répond. Les clients de messagerie s’en servent pour regrouper les conversations en fils. |
Transmis tel quel. Définissez-le avec le champ headers ou dans votre MIME. |
References |
La chaîne des valeurs Message-ID d’un fil de discussion. |
Transmis tel quel. |
Acheminement et traçage
| En-tête | Rôle | Emailit |
|---|---|---|
Return-Path |
L’expéditeur d’enveloppe, normalement ajouté par le serveur destinataire lors de la livraison finale. | Défini par Emailit sur une adresse de emailit.yourdomain.com, pour que les rebonds parviennent à Emailit et que SPF soit vérifié sur votre domaine. Vous ne pouvez pas le modifier. |
Received |
Une ligne par serveur traversé par le message, la plus récente en premier. Utile pour retrouver l’origine d’un retard. | Ajouté par l’API ou le relais SMTP d’Emailit, et par son MTA. Le relais SMTP rejette un message avec 550 Loop detected au-delà de 4 passages par le relais. |
Structure MIME
| En-tête | Rôle | Emailit |
|---|---|---|
MIME-Version |
Déclare que le message utilise MIME, toujours 1.0. |
Généré par l’API. Transmis tel quel via SMTP. |
Content-Type |
Le type du corps ou d’une partie, comme text/html, multipart/alternative ou multipart/mixed, et son jeu de caractères. |
Généré par l’API à partir de html, text et attachments. Transmis tel quel via SMTP. |
Content-Transfer-Encoding |
La façon dont une partie est encodée pour le transport, comme quoted-printable, base64 ou 7bit. |
Généré par l’API. Transmis tel quel via SMTP. |
Authentification
| En-tête | Rôle | Emailit |
|---|---|---|
DKIM-Signature |
Une signature cryptographique du corps et de certains en-têtes, vérifiée à l’aide de la clé publique publiée dans le DNS. | Ajouté par Emailit avec d= défini sur votre domaine et le sélecteur emailit, ainsi qu’une seconde signature pour emailitmail.com, que les fournisseurs de messagerie utilisent pour les boucles de rétroaction. |
Authentication-Results |
Les verdicts SPF, DKIM et DMARC du serveur destinataire. | Ajouté par le serveur du destinataire, pas par Emailit. Consultez-le dans la copie du destinataire pour déboguer l’authentification. |
ARC-Seal, ARC-Message-Signature, ARC-Authentication-Results |
Authenticated Received Chain : les services de transfert et les listes de diffusion enregistrent les résultats d’authentification qu’ils ont constatés, pour que les serveurs suivants puissent s’y fier. | Non ajouté par Emailit. Ajouté par les intermédiaires qui transfèrent vos e-mails. |
Listes et e-mails automatiques
| En-tête | Rôle | Emailit |
|---|---|---|
List-Unsubscribe |
Un lien mailto: ou https: qui permet aux fournisseurs de messagerie d’afficher un bouton de désinscription. |
Ajouté à chaque e-mail de campagne, et pointe vers la page de désinscription hébergée. Pour les e-mails envoyés via l’API ou SMTP, ajoutez le vôtre avec le champ headers ou dans votre MIME. |
List-Unsubscribe-Post |
Défini sur List-Unsubscribe=One-Click pour permettre la désinscription en un clic (RFC 8058). Gmail et Yahoo l’exigent pour les envois en masse. |
Ajouté à chaque e-mail de campagne avec List-Unsubscribe. |
Feedback-ID |
Un identifiant que les fournisseurs de messagerie incluent dans les données de plainte pour que les expéditeurs puissent les regrouper. | Ajouté par Emailit à chaque message, au format :campaign-id:workspace-id:Emailit. |
Precedence |
Une ancienne indication, comme bulk ou list, que certains répondeurs automatiques respectent. |
Non ajouté. Vous pouvez le définir vous-même. |
Auto-Submitted |
Indique qu’un message a été généré automatiquement, par exemple auto-generated ou auto-replied, pour que d’autres systèmes n’y répondent pas. |
Non ajouté. Définissez-le sur les réponses automatiques pour éviter les boucles d’e-mails. |
En-têtes Emailit
| En-tête | Rôle | Emailit |
|---|---|---|
X-Emailit-ID |
Le jeton interne de l’e-mail. Emailit s’en sert pour associer les messages de rebond à l’e-mail d’origine. | Ajouté à chaque message. Ne le supprimez pas si vous relayez des e-mails Emailit via un autre système. |
X-Emailit-Tag |
Un ancien en-tête servant à étiqueter les e-mails. | Non lu par Emailit. Il est transmis comme n’importe quel en-tête personnalisé. |
X-Emailit-Meta |
Les métadonnées de l’e-mail, encodées en base64. | Ajouté par l’API quand vous envoyez meta. Il reste dans le message livré : ne mettez donc pas de secrets dans les métadonnées. |
X-Emailit-Tracking |
Les paramètres de suivi des ouvertures et des clics de l’e-mail. | Ajouté par l’API quand vous activez le suivi pour un envoi. |