# Logs de e-mail

> Encontre qualquer e-mail que você enviou ou recebeu, veja o que aconteceu com ele e inspecione as requisições à API e ao SMTP e os eventos por trás dele.

O Emailit registra todos os e-mails que passam pelo seu workspace, todas as requisições à API e ao SMTP feitas com as suas chaves e todos os eventos que ele envia aos webhooks. Esta página explica onde cada registro fica no painel e por quanto tempo ele é mantido, para você saber onde procurar quando precisar responder “o e-mail chegou?” ou “por que essa chamada falhou?”.

## Onde procurar

| Pergunta | Onde | O que você vê |
| --- | --- | --- |
| O meu e-mail chegou? O que o servidor de destino respondeu? | **Email API → Emails** | Cada e-mail enviado ou recebido, o status dele, as tentativas de entrega, as aberturas, os cliques e a verificação de spam. |
| Por que a minha chamada à API ou a minha sessão SMTP falhou? | **Email API → Logs** | Cada requisição à API v2 e cada transação SMTP feitas com uma chave de API, com o código de status e os corpos da requisição e da resposta. |
| O que aconteceu no meu workspace e o que os webhooks receberam? | **Email API → Events** | O fluxo de eventos: mudanças de status, aberturas, cliques, e-mails recebidos e alterações em recursos. |
| Como estão os envios no geral? | **Email API → Analytics** | Gráficos e totais. Consulte [Análises](/pt/docs/analytics/). |

## E-mails

**Email API → Emails** lista os e-mails individualmente. Cada destinatário de um envio é um e-mail separado, com o seu próprio ID `em_` e o seu próprio status.

- **Abas:** **Outgoing** mostra os e-mails que você enviou pela API, por SMTP, por campanhas, por automações e pelo Compose. **Incoming** mostra os e-mails recebidos no seu subdomínio de [recebimento](/pt/docs/inbound/).
- **Pesquisa:** busca no destinatário, no remetente ou no assunto.
- **Período:** sem um período definido, a lista mostra os últimos 14 dias.
- **Filtros:** **Recipient**, **From**, **Subject**, **Status**, **Tag**, **Created**, **Updated**, **Spam score**, **API key** e **Domain**. Combine vários e escolha se todos ou qualquer um deles deve corresponder.
- **Colunas:** **Recipient** sempre aparece. **Status**, **Subject**, **Type**, **Spam score**, **Sent** (o horário de envio ou o horário agendado), **Created** e **Updated** podem ser mostradas ou ocultadas em **Display options** > **Edit columns**. A coluna **Type** e o filtro **Tag** costumam ficar vazios para e-mails da API e do SMTP. Para identificar os e-mails e encontrá-los depois, anexe valores de `meta` ao enviar; eles são incluídos em todos os eventos de e-mail. Consulte [Cabeçalhos e metadados](/pt/docs/email-api/headers-and-metadata/).
- **Ações da linha:** os e-mails agendados, aceitos ou com falha temporária têm um menu com **Cancel delivery**.

Selecione um e-mail para abrir a [página de detalhes](/pt/docs/logs/email-details/) dele: cabeçalhos, conteúdo, anexos, todas as tentativas de entrega, aberturas, cliques, verificação de spam e as ações **Forward**, **Cancel delivery** e **Retry**. Cada status é explicado em [Status de e-mail](/pt/docs/logs/email-statuses/).

O botão **Compose** envia um e-mail avulso pelo painel. Consulte [Escrever um e-mail](/pt/docs/logs/compose/).

## Logs

**Email API → Logs** é um log de requisições para desenvolvedores: todas as requisições à API v2 e todas as transações SMTP autenticadas com uma das suas chaves de API, com sucesso ou com falha. Use-o para ver exatamente o que o seu código enviou e o que o Emailit respondeu. Consulte [Logs de requisições](/pt/docs/logs/request-logs/).

## Eventos

**Email API → Events** lista os eventos que o Emailit registra, como `email.delivered`, `email.bounced` ou `contact.created`. Toda requisição de webhook é montada a partir desses eventos, e você pode ler o mesmo fluxo com a [API de eventos](/pt/docs/api-reference/events/). Consulte [Eventos](/pt/docs/logs/events/).

## Retenção

O tempo de retenção de cada registro depende do seu plano e das configurações de [Retenção de dados](/pt/docs/data-retention/) em **Workspace → Settings**:

- **O conteúdo das mensagens** é o corpo, os cabeçalhos e os anexos mostrados na página de detalhes do e-mail e retornados pelos endpoints de conteúdo.
- **A atividade das mensagens** é o próprio registro do e-mail, com o status, as tentativas de entrega, as aberturas e os cliques. É o que a lista de e-mails mostra.
- **Os logs** abrangem os logs de requisições, os eventos e as requisições de webhook.

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Retenção do conteúdo das mensagens | 7 dias | 30 dias | 30 dias | Flexível |
| Retenção da atividade das mensagens | 30 dias | 365 dias | 365 dias | Flexível |
| Retenção dos logs de requisições | 7 dias | 30 dias | 30 dias | Flexível |

Depois que o conteúdo é apagado, o e-mail continua na lista com o status e o histórico, mas a pré-visualização, os anexos, **Forward** e **Retry** deixam de funcionar. Com o complemento de retenção de dados, você define cada período, de 1 a 365 dias.

## Próximos passos

  - [Status de e-mail](/pt/docs/logs/email-statuses/): O que cada status significa e o que fazer a respeito.
  - [Detalhes do e-mail](/pt/docs/logs/email-details/): Leia as tentativas de entrega, a verificação de spam e o engajamento de um e-mail.
  - [Logs de requisições](/pt/docs/logs/request-logs/): Depure erros da API e do SMTP.
  - [Eventos](/pt/docs/logs/events/): O fluxo de eventos por trás dos webhooks.

---
Fonte: https://emailit.com/pt/docs/logs/