Simplificando os Status de E-mail
Os status de email são uma das partes mais importantes da API — eles indicam exatamente onde um email está no seu ciclo de vida. Com o tempo, nosso conjunto original de status cresceu de forma orgânica e se tornou confuso: qual a diferença entre error e softfail? O held é igual ao pending? Decidimos fazer uma limpeza.
Os novos status
Agora temos 12 status claros, cada um com um significado distinto e uma cor:
| Status | Cor | Descrição |
|---|---|---|
| accepted | 🟡 | Aceito para entrega |
| scheduled | 🟡 | Agendado para entrega futura |
| delivered | 🟢 | Entregue ao servidor de email do destinatário |
| bounced | 🔴 | Falha permanente (rejeição definitiva) |
| attempted | 🟠 | Tentativa de entrega realizada mas falhou temporariamente |
| failed | 🔴 | Falha na entrega devido a um erro específico |
| rejected | 🔴 | Aceito inicialmente, depois rejeitado |
| loaded | 🔵 | Conteúdo do email foi carregado (rastreamento de abertura) |
| clicked | 🟣 | Um link no email foi clicado |
| suppressed | ⚪ | Destinatário está na lista de supressão |
| received | 🟢 | Email recebido foi aceito |
| complained | 🔴 | Uma reclamação de spam foi registrada |
O que mudou dos status antigos
Os status antigos estão descontinuados. Veja como eles correspondem aos novos:
| Status antigo (descontinuado) | Novo status |
|---|---|
pending | accepted ou scheduled |
sent | delivered |
held | (removido) |
hold_cancelled | (removido) |
softfail | attempted |
hardfail | bounced |
opened | loaded |
error | failed |
delayed | (removido) |
processed | (removido) |
Os status renomeados são mais descritivos: loaded deixa claro que estamos rastreando o carregamento do conteúdo do email (não necessariamente uma pessoa abrindo), attempted é menos ambíguo que softfail, e bounced é universalmente compreendido.
Compatibilidade com versões anteriores
Todos os emails existentes e suas entregas foram migrados para os novos status. Você não verá nenhum nome de status antigo nos registros de email ou entrega, independentemente de quando foram criados.
O único lugar onde nomes de status antigos ainda podem aparecer é em eventos e requisições de webhook disparados anteriormente que foram enviados antes desta mudança. Esses dados históricos são imutáveis e manterão os valores de status originais com os quais foram criados.
Se você está filtrando ou comparando valores de status no seu código, atualize suas integrações para usar os novos nomes.
Blog
As últimas novidades e atualizações, direto da Emailit.
Mantenha-se atualizado com os artigos mais recentes do Blog Emailit.
