Visão Geral
Todo e-mail no Emailit possui um status que indica exatamente onde ele se encontra em seu ciclo de vida. Existem 12 status, cada um com uma cor e significado distintos. O status sempre reflete a situação mais recente do e-mail.
Referência de Status
| Status | Cor | Descrição |
|---|---|---|
| accepted | 🟡 | O e-mail foi aceito para entrega e está sendo processado. |
| scheduled | 🟡 | O e-mail está agendado para entrega em um horário futuro especificado por scheduled_at. |
| delivered | 🟢 | O e-mail foi entregue com sucesso ao servidor de e-mail do destinatário. |
| bounced | 🔴 | O e-mail falhou permanentemente na entrega. O servidor de e-mail do destinatário rejeitou a mensagem (bounce definitivo). |
| attempted | 🟠 | A entrega foi tentada mas resultou em uma falha temporária. O sistema pode tentar novamente automaticamente. |
| failed | 🔴 | O e-mail falhou na entrega devido a um erro específico durante o processo de entrega. |
| rejected | 🔴 | O e-mail foi inicialmente aceito para entrega mas foi rejeitado posteriormente. |
| loaded | 🔵 | O conteúdo do e-mail foi carregado pelo destinatário. Usado para rastreamento de abertura e requer que o rastreamento esteja habilitado no domínio de envio. |
| clicked | 🟣 | Um link dentro do e-mail foi clicado pelo destinatário. Requer que o rastreamento de cliques esteja habilitado no domínio de envio. |
| suppressed | ⚪ | O endereço de e-mail do destinatário está na lista de supressão e o e-mail não foi enviado. |
| received | 🟢 | Um e-mail recebido foi registrado em seu domínio. |
| complained | 🔴 | Uma reclamação de spam (feedback loop) foi registrada para este e-mail pelo destinatário. |
Fluxo de Status
Um e-mail típico passa pelo seguinte fluxo:
- accepted — o e-mail entra no sistema
- delivered — o servidor de e-mail do destinatário o aceita
- loaded — o destinatário abre o e-mail (se o rastreamento estiver habilitado)
- clicked — o destinatário clica em um link (se o rastreamento estiver habilitado)
Se algo der errado, o e-mail pode acabar em um dos estados de falha:
- attempted — falha temporária, pode ser tentado novamente
- bounced — falha permanente, não será tentado novamente
- failed — erro de entrega
- rejected — rejeitado após aceitação inicial
E-mails Agendados
Quando você envia um e-mail com um timestamp scheduled_at no futuro, ele entra no status scheduled em vez de accepted. O e-mail será processado e entregue no horário especificado.
Você pode cancelar um e-mail agendado antes que seja enviado, ou atualizar seu horário agendado.
E-mails Suprimidos
Se o destinatário estiver na lista de supressão do seu workspace, o e-mail receberá imediatamente o status suppressed e não será entregue. Isso protege sua reputação de remetente evitando endereços conhecidamente problemáticos.
Status de Rastreamento
Os status loaded e clicked requerem que o rastreamento esteja habilitado em seu domínio de envio. Quando habilitado:
- loaded é registrado quando o pixel de rastreamento no e-mail é carregado
- clicked é registrado quando um link rastreado no e-mail é seguido
Esses status incluem metadados adicionais como o endereço IP e user agent do destinatário.
Verificando Status do E-mail
Você pode verificar o status atual de qualquer e-mail usando o endpoint Obter E-mail, ou navegar pelos status de e-mail no Painel do Emailit.