Referência
Cabeçalhos de e-mail
O que fazem os cabeçalhos de e-mail mais comuns, de From e Reply-To a DKIM-Signature e List-Unsubscribe, e quais o Emailit adiciona, reescreve ou remove ao enviar.
Os cabeçalhos são as linhas Name: value no topo de todo e-mail. Eles trazem o remetente, os destinatários, o assunto, o histórico de roteamento e os resultados da autenticação. Esta página explica os cabeçalhos que você mais provavelmente vai inspecionar ou definir e o que o Emailit faz com cada um ao enviar os seus e-mails.
Envelope e cabeçalhos
Um e-mail tem dois conjuntos de endereços, e eles não precisam coincidir:
| Envelope | Cabeçalhos | |
|---|---|---|
| Remetente | MAIL FROM, o endereço de bounce. O Emailit o define como o seu return path, um endereço em emailit.yourdomain.com. |
From, o endereço que os destinatários veem. Você o define. |
| Destinatários | RCPT TO, para onde o servidor realmente entrega. |
To e Cc, que os destinatários veem. Bcc nunca aparece. |
Os destinatários verificam o SPF com base no remetente do envelope e o DKIM com base na assinatura, e então o DMARC confere se pelo menos um desses domínios está alinhado com o cabeçalho From.
Como definir cabeçalhos
- API de e-mail. Use os campos
from,to,cc,bcc,reply_toesubjecte passe qualquer outro cabeçalho no objetoheaders. Consulte Cabeçalhos e metadados. - SMTP. O Emailit envia a mensagem MIME que a sua aplicação submete, com as alterações listadas abaixo. Consulte Cabeçalhos SMTP.
Referência de cabeçalhos
A coluna Emailit indica se o Emailit adiciona, reescreve ou remove o cabeçalho, ou se deixa isso com você.
Endereços e assunto
| Cabeçalho | Finalidade | Emailit |
|---|---|---|
From |
O endereço e o nome de exibição do autor, mostrados aos destinatários. | Você o define. Ele precisa usar um domínio de envio verificado do workspace, comparado sem diferenciar maiúsculas de minúsculas. Caso contrário, a API retorna 422 e o SMTP retorna 530. |
Sender |
O endereço que realmente enviou a mensagem, quando é diferente do From, por exemplo um assistente que envia em nome de um gerente. |
Repassado sem alterações. O Emailit só verifica o From. |
Reply-To |
Para onde vão as respostas, no lugar do endereço From. |
Você o define. O Emailit o remove quando ele contém os mesmos endereços do From, porque os filtros de spam penalizam isso. |
To |
Os destinatários principais, mostrados a todos. | Você o define. Cada destinatário recebe uma cópia separada, com o próprio ID de e-mail. |
Cc |
Destinatários em cópia visível. | Você o define. Cada destinatário recebe uma cópia separada. |
Bcc |
Destinatários em cópia oculta. | Removido da mensagem antes da entrega. Os destinatários em Bcc continuam recebendo a sua cópia. |
Subject |
A linha de assunto. | Você o define. O Emailit codifica os caracteres não ASCII (RFC 2047) para que acentos e alfabetos não latinos apareçam corretamente. |
Date |
Quando a mensagem foi escrita. | Definido pelo Emailit com o horário em que ele envia a mensagem. |
Identificação e conversas
| Cabeçalho | Finalidade | Emailit |
|---|---|---|
Message-ID |
Um ID globalmente único para a mensagem, no formato <id@domain>. |
Definido pelo Emailit com um ID no seu domínio de envio, substituindo qualquer valor que você envie. A API o retorna como message_id. |
In-Reply-To |
O Message-ID da mensagem que está sendo respondida. Os clientes de e-mail o usam para agrupar as conversas. |
Repassado. Defina-o com o campo headers ou no seu MIME. |
References |
A cadeia de valores Message-ID de uma conversa. |
Repassado. |
Roteamento e rastro
| Cabeçalho | Finalidade | Emailit |
|---|---|---|
Return-Path |
O remetente do envelope, normalmente adicionado pelo servidor de destino na entrega final. | Definido pelo Emailit com um endereço em emailit.yourdomain.com, para que os bounces cheguem ao Emailit e o SPF seja verificado com base no seu domínio. Você não pode alterá-lo. |
Received |
Uma linha por servidor pelo qual a mensagem passou, da mais recente para a mais antiga. Útil para rastrear atrasos. | Adicionado pela API ou pelo SMTP relay do Emailit e pelo MTA dele. O SMTP relay rejeita uma mensagem com 550 Loop detected depois de mais de 4 passagens por ele. |
Estrutura MIME
| Cabeçalho | Finalidade | Emailit |
|---|---|---|
MIME-Version |
Declara que a mensagem usa MIME, sempre 1.0. |
Gerado pela API. Repassado no SMTP. |
Content-Type |
O tipo do corpo ou da parte, como text/html, multipart/alternative ou multipart/mixed, e o conjunto de caracteres. |
Gerado pela API a partir de html, text e attachments. Repassado no SMTP. |
Content-Transfer-Encoding |
Como uma parte é codificada para o transporte, como quoted-printable, base64 ou 7bit. |
Gerado pela API. Repassado no SMTP. |
Autenticação
| Cabeçalho | Finalidade | Emailit |
|---|---|---|
DKIM-Signature |
Uma assinatura criptográfica do corpo e de cabeçalhos selecionados, verificada com a chave pública publicada no DNS. | Adicionado pelo Emailit com d= definido como o seu domínio e o seletor emailit, além de uma segunda assinatura para emailitmail.com, que os provedores de e-mail usam para os feedback loops. |
Authentication-Results |
Os veredictos de SPF, DKIM e DMARC do servidor de destino. | Adicionado pelo servidor do destinatário, não pelo Emailit. Leia-o na cópia do destinatário para depurar a autenticação. |
ARC-Seal, ARC-Message-Signature, ARC-Authentication-Results |
Authenticated Received Chain: encaminhadores e listas de discussão registram os resultados de autenticação que viram, para que os servidores seguintes possam confiar neles. | Não é adicionado pelo Emailit. Adicionado pelos intermediários que encaminham os seus e-mails. |
Listas e e-mails automáticos
| Cabeçalho | Finalidade | Emailit |
|---|---|---|
List-Unsubscribe |
Um link mailto: ou https: que permite aos provedores de e-mail mostrar um botão de descadastro. |
Adicionado a todo e-mail de campanha, apontando para a página de descadastro hospedada. Para e-mails pela API ou por SMTP, adicione o seu próprio com o campo headers ou no seu MIME. |
List-Unsubscribe-Post |
Definido como List-Unsubscribe=One-Click para permitir o descadastro em um clique (RFC 8058). O Gmail e o Yahoo o exigem para e-mails em massa. |
Adicionado a todo e-mail de campanha junto com o List-Unsubscribe. |
Feedback-ID |
Um identificador que os provedores de e-mail incluem nos dados de reclamação para que os remetentes possam agrupá-los. | Adicionado pelo Emailit a todas as mensagens, no formato :campaign-id:workspace-id:Emailit. |
Precedence |
Uma indicação mais antiga, como bulk ou list, que algumas respostas automáticas respeitam. |
Não é adicionado. Você pode defini-lo por conta própria. |
Auto-Submitted |
Marca uma mensagem como gerada automaticamente, por exemplo auto-generated ou auto-replied, para que outros sistemas não respondam a ela. |
Não é adicionado. Defina-o nas respostas automáticas para evitar loops de e-mail. |
Cabeçalhos do Emailit
| Cabeçalho | Finalidade | Emailit |
|---|---|---|
X-Emailit-ID |
O token interno do e-mail. O Emailit o usa para associar mensagens de bounce ao e-mail original. | Adicionado a todas as mensagens. Não o remova se você retransmitir e-mails do Emailit por outro sistema. |
X-Emailit-Tag |
Um cabeçalho legado para marcar e-mails com tags. | Não é lido pelo Emailit. É repassado como qualquer cabeçalho personalizado. |
X-Emailit-Meta |
Os metadados do e-mail, em base64. | Adicionado pela API quando você envia meta. Ele permanece na mensagem entregue, então não coloque segredos nos metadados. |
X-Emailit-Tracking |
As configurações de rastreamento de aberturas e cliques do e-mail. | Adicionado pela API quando você ativa o rastreamento em um envio. |