# 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.

2026-02-25 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

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 |
| --- | --- |
| `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 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.

---

Source: https://emailit.com/pt/blog/simplificando-status-de-email/
