# 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](/pt/docs/domains/dns-records/), 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](/pt/docs/dictionary/dns-records/#spf) com base no remetente do envelope e o [DKIM](/pt/docs/dictionary/dns-records/#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_to` e `subject` e passe qualquer outro cabeçalho no objeto `headers`. Consulte [Cabeçalhos e metadados](/pt/docs/email-api/headers-and-metadata/).
- **SMTP.** O Emailit envia a mensagem MIME que a sua aplicação submete, com as alterações listadas abaixo. Consulte [Cabeçalhos SMTP](/pt/docs/smtp/headers/).

## 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](/pt/docs/campaigns/), 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](/pt/docs/email-api/headers-and-metadata/) 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. |

> **O Emailit não lê cabeçalhos SMTP personalizados:** No SMTP, o Emailit não interpreta cabeçalhos `X-Emailit-*`. O rastreamento de aberturas e cliques segue as configurações do domínio de envio, e não há templates processados no servidor. Para controlar o rastreamento por e-mail, use a [API de e-mail](/pt/docs/email-api/send-email/).

## Veja também

- [Cabeçalhos e metadados](/pt/docs/email-api/headers-and-metadata/)
- [Cabeçalhos SMTP](/pt/docs/smtp/headers/)
- [Registros DNS](/pt/docs/dictionary/dns-records/)
- [Descadastros](/pt/docs/audiences/unsubscribes/)

---
Fonte: https://emailit.com/pt/docs/dictionary/email-headers/