# Status de e-mail

> Todos os status de e-mail do Emailit, o que significam, se ainda podem mudar, qual evento de webhook enviam e o que fazer em seguida.

Cada e-mail tem um status que mostra em que ponto do ciclo de vida ele está. Esta página lista os 14 status, como um e-mail passa de um para outro e o que fazer quando um e-mail para onde você não esperava. O status é apenas o estado mais recente; o histórico completo fica na [página de detalhes](/pt/docs/logs/email-details/) do e-mail e nos [eventos](/pt/docs/logs/events/).

## Referência de status

“Final” significa que o Emailit não vai mais mudar o status por conta própria. Ainda é possível tentar enviar de novo um e-mail com status final, o que cria um novo e-mail com um novo ID.

| Status | Dica no painel | Final | Evento de webhook | Significado e o que fazer |
| --- | --- | --- | --- | --- |
| `accepted` | Accepted for delivery | Não | `email.accepted` | Armazenado e na fila para entrega. Normalmente avança em segundos. Os e-mails enviados por SMTP não emitem `email.accepted`. |
| `scheduled` | Scheduled for delivery in the future | Não | `email.scheduled` | Aguardando o horário de `scheduled_at`. Você pode [alterar o horário](/pt/docs/api-reference/emails/update/) ou cancelá-lo até 3 minutos antes do envio. |
| `delivered` | Delivered to the recipient's mail server | Não | `email.delivered` | O servidor de destino aceitou a mensagem. Ela ainda pode passar a `loaded` ou `clicked`, e um relatório de bounce ou uma reclamação posteriores podem mudá-la para `bounced` ou `complained`. |
| `loaded` | Email content was loaded by the recipient | Não | `email.loaded` | A imagem de rastreamento foi carregada (uma abertura). Requer o rastreamento de carregamentos em um [domínio de rastreamento](/pt/docs/tracking/) verificado. |
| `clicked` | A link in the email was clicked | Não | `email.clicked` | Um link rastreado foi clicado. Requer o rastreamento de cliques em um domínio de rastreamento verificado. |
| `attempted` | Delivery attempted but resulted in a temporary failure | Não | `email.attempted` | O servidor de destino respondeu com um erro temporário. O Emailit tenta de novo automaticamente; consulte o [cronograma de novas tentativas](#retry-schedule-for-attempted). |
| `bounced` | Email permanently failed to deliver | Sim | `email.bounced` | O servidor de destino rejeitou a mensagem de forma permanente, um relatório de bounce chegou depois ou as novas tentativas se esgotaram. Confira o endereço antes de enviar para ele de novo. Consulte [Bounces e reclamações](/pt/docs/deliverability/bounces-and-complaints/) para saber quando o endereço é suprimido automaticamente. |
| `failed` | Failed to deliver due to a specific error | Sim | `email.failed` | Um erro de processamento, e não uma resposta do servidor do destinatário. Raro. Tente enviar de novo pela API. |
| `rejected` | Accepted for delivery but rejected after | Sim | `email.rejected` | O Emailit se recusou a enviá-lo depois de aceitá-lo, porque um [workspace não verificado](#why-an-email-is-rejected) só pode enviar para membros. |
| `suppressed` | Recipient is on the suppression list | Sim | `email.suppressed` | Não enviado porque o endereço está na sua [lista de supressão](/pt/docs/suppressions/). Remova a supressão só se tiver certeza e tente de novo. |
| `received` | Incoming email was accepted | Sim | `email.received` | Uma mensagem foi [recebida](/pt/docs/inbound/) no seu subdomínio de recebimento. |
| `complained` | A complaint was registered for this email | Sim | `email.complained` | O destinatário marcou o e-mail como spam e o provedor dele informou isso. O endereço é adicionado às supressões, a menos que as suas configurações de supressão automática excluam as reclamações. Não envie e-mails para ele de novo. |
| `canceled` | Canceled: pulled from the send queue when possible | Sim | `email.canceled` | Você o cancelou no painel ou pela API. O cancelamento é feito em regime de melhor esforço. |
| `held` | Email is being held | Sim | `email.held` | O Emailit não o enviou. Veja [por que um e-mail é retido](#why-an-email-is-held), corrija a causa e tente de novo. |

Os webhooks recebem `email.canceled` e `email.held` quando estão inscritos em todos os eventos, ou quando você os adiciona à lista de eventos do webhook pela API. Consulte [Tipos de eventos](/pt/docs/webhooks/event-types/).

## Ciclo de vida

A maioria dos e-mails segue este caminho:

1. **Criado.** Um envio pela API cria o e-mail como `accepted`, ou como `scheduled` quando `scheduled_at` está no futuro. Os envios por SMTP também começam como `accepted`. Os e-mails recebidos são criados como `received` e nunca mudam.
2. **Verificado.** Antes de cada tentativa de entrega, o Emailit verifica o workspace, o domínio, a chave de API, os créditos, a lista de supressão e a pontuação de spam. Uma verificação com falha encerra o e-mail como `held`, `rejected` ou `suppressed`, sem enviá-lo.
3. **Entregue ou adiado.** A tentativa de entrega é bem-sucedida (`delivered`), falha temporariamente (`attempted`, e depois recebe novas tentativas) ou falha permanentemente (`bounced`).
4. **Engajamento.** Se o rastreamento estiver ativado, aberturas e cliques levam um e-mail entregue a `loaded` e depois a `clicked`.
5. **Relatórios tardios.** Um relatório de bounce que chega depois da entrega muda o status para `bounced`. Uma reclamação de spam o muda para `complained`.

Em qualquer momento antes da entrega, um e-mail `scheduled`, `accepted` ou `attempted` pode passar a `canceled`.

### A escada de engajamento

Os status de entrega e de engajamento só avançam:

`accepted`, `scheduled` ou `attempted` → `delivered` → `loaded` → `clicked`

Um evento posterior nunca faz um e-mail descer na escada. Se um clique for registrado, o e-mail continua `clicked` mesmo que cheguem mais aberturas. Uma abertura ou um clique pode pular à frente de `delivered`, porque prova que a mensagem chegou. Os status que encerram a entrega (`bounced`, `failed`, `rejected`, `suppressed`, `complained` e `canceled`) nunca são substituídos por aberturas ou cliques.

## Cronograma de novas tentativas para attempted

Quando um servidor de destino responde com um erro temporário (uma resposta `4xx`, como `421` ou `451`, um timeout ou um erro de conexão), o e-mail passa a `attempted` e o Emailit tenta de novo. Cada espera é o dobro da anterior:

| Depois da tentativa com falha | Próximo passo |
| --- | --- |
| 1 | Tentar de novo depois de 10 minutos |
| 2 | Tentar de novo depois de 20 minutos |
| 3 | Tentar de novo depois de 40 minutos |
| 4 | Tentar de novo depois de 80 minutos |
| 5 | Tentar de novo depois de 160 minutos |
| 6 | Tentar de novo depois de 320 minutos |
| 7 | Esperar 640 minutos e depois marcar o e-mail como `bounced` |

São 7 tentativas de entrega ao longo de cerca de 21 horas. Quando elas se esgotam, o e-mail é marcado como `bounced` com “Maximum number of delivery attempts (7) has been reached”, e o destinatário é adicionado às supressões com o motivo `too many soft fails`, a menos que as suas configurações de [supressão automática](/pt/docs/suppressions/manage/) excluam os bounces.

Cada tentativa aparece na aba **Deliveries** do e-mail com a resposta do servidor, e cada uma envia um evento `email.attempted` que inclui `smtp_code`, `smtp_enhanced_code` e `smtp_response`. Algumas respostas temporárias que indicam claramente um problema permanente, como uma caixa de e-mail desativada, são tratadas como bounce imediatamente. Quando um provedor está limitando o ritmo, o Emailit também pode pausar brevemente as entregas para ele; essas linhas dizem “Delivery delayed due to…”.

## Por que um e-mail é retido

Um e-mail retido foi tirado da fila de envio sem ser enviado. A aba **Deliveries** do e-mail mostra qual foi o motivo:

| Motivo | Mensagem na aba Deliveries | O que fazer |
| --- | --- | --- |
| Workspace suspenso | Mail server has been suspended. No e-mails can be processed at present. Contact support for assistance. | Confira a [saúde de envio](/pt/docs/deliverability/sending-health/) e fale com o suporte. |
| Domínio de envio pausado | Sending from this domain is paused. Contact support for assistance. | A taxa de bounce do domínio estava alta demais. Consulte [Saúde de envio](/pt/docs/deliverability/sending-health/). |
| Créditos insuficientes | Workspace has not enough email credits to send this email. | [Compre créditos](/pt/docs/billing/credits/) ou ative a [recarga automática](/pt/docs/billing/auto-refill/). |
| Pontuação de spam alta demais | Held because Rspamd scored this message 8.4, which is at or above the threshold of 7. | Leia a [verificação de spam](/pt/docs/logs/email-details/#spam-checks) do e-mail, corrija o conteúdo e tente de novo. |
| Chave de API configurada para reter | Credential is configured to hold all messages authenticated by it. | As mensagens enviadas com essa chave são retidas de propósito. Fale com o suporte. |

Os e-mails retidos não são liberados automaticamente. Depois de corrigir a causa, selecione **Retry** no e-mail ou chame [Tentar enviar um e-mail de novo](/pt/docs/api-reference/emails/retry/). A nova tentativa cria um novo e-mail com o mesmo conteúdo e cobra os créditos de novo.

## Por que um e-mail é rejeitado

Enquanto o seu workspace não tiver [acesso de produção](/pt/docs/workspaces/production-access/), você só pode enviar para os e-mails das contas dos membros do workspace. A API retorna `403` e o SMTP retorna `550` para os outros destinatários no momento do envio, então na maioria das vezes você vê o erro em vez de um e-mail. O status `rejected` aparece quando a mesma verificação falha mais tarde, no momento da entrega, por exemplo em um e-mail agendado antes. A aba **Deliveries** mostra “Unverified workspaces can only send to workspace members' account emails” e o endereço bloqueado.

## Regras para novas tentativas

| | Botão **Retry** no painel | API [Tentar enviar um e-mail de novo](/pt/docs/api-reference/emails/retry/) |
| --- | --- | --- |
| Status | `held`, `suppressed` | `bounced`, `failed`, `suppressed`, `held` |
| Idade | Menos de 30 dias | Menos de 30 dias |
| Conteúdo | Não pode ter sido apagado pela [retenção de dados](/pt/docs/data-retention/) | Não pode ter sido apagado |
| Resultado | Um novo e-mail com um novo ID; o original não é alterado | Igual; a resposta inclui `original_id` |

Para um e-mail suprimido, primeiro remova o endereço da sua [lista de supressão](/pt/docs/suppressions/manage/), senão a nova tentativa é suprimida de novo.

## Veja também

  - [Detalhes do e-mail](/pt/docs/logs/email-details/)
  - [Bounces e reclamações](/pt/docs/deliverability/bounces-and-complaints/)
  - [Novas tentativas e encaminhamento](/pt/docs/email-api/retry-and-forward/)
  - [Tipos de eventos de webhook](/pt/docs/webhooks/event-types/)

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