Engenharia4 min de leitura
Simplificamos os status de e-mail
Substituímos os antigos status de e-mail por um conjunto mais claro e consistente. Veja o que mudou e como os novos status correspondem aos anteriores.
GPorGeorge

Os status de e-mail são uma das partes mais importantes da API: eles mostram exatamente em que ponto do ciclo de vida um e-mail está. Com o tempo, o nosso conjunto original de status cresceu de forma orgânica e ficou confuso: qual é a diferença entre error e softfail? held é o mesmo que pending? Decidimos arrumar a casa.
Os novos status
Agora temos 12 status claros, cada um com um significado e uma cor próprios:
Status | Cor | Descrição |
|---|---|---|
accepted | 🟡 | Aceito para entrega |
scheduled | 🟡 | Agendado para entrega futura |
delivered | 🟢 | Entregue ao servidor de e-mail do destinatário |
bounced | 🔴 | Falha permanente (hard bounce) |
attempted | 🟠 | Tentativa de entrega feita, mas com falha temporária |
failed | 🔴 | Falha na entrega por causa de um erro específico |
rejected | 🔴 | Aceito inicialmente, depois rejeitado |
loaded | 🔵 | O conteúdo do e-mail foi carregado (rastreamento de abertura) |
clicked | 🟣 | Um link do e-mail foi clicado |
suppressed | ⚪ | O destinatário está na lista de supressão |
received | 🟢 | Um e-mail recebido foi aceito |
complained | 🔴 | Uma reclamação de spam foi registrada |
O que mudou em relação aos status antigos
Os status antigos estão descontinuados. Veja como eles correspondem aos novos:
Status antigo (descontinuado) | Novo status |
|---|---|
|
|
|
|
| (removido) |
| (removido) |
|
|
|
|
|
|
|
|
| (removido) |
| (removido) |
Os status renomeados são mais descritivos: loaded deixa claro que rastreamos o carregamento do conteúdo do e-mail (não necessariamente uma pessoa abrindo a mensagem), attempted é menos ambíguo que softfail e bounced é entendido por todo mundo.
Compatibilidade com versões anteriores
Todos os e-mails existentes e as suas entregas foram migrados para os novos status. Você não verá nenhum nome de status antigo nos registros de e-mail ou de entrega, não importa quando eles foram criados.
O único lugar onde os nomes antigos ainda podem aparecer são os eventos e as requisições de webhook disparados antes desta mudança. Esses payloads históricos são imutáveis e mantêm os valores de status com que foram criados.
Se o seu código filtra ou compara valores de status, atualize as suas integrações para usar os novos nomes.


