Pular para o conteúdo

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.

GPor

Simplificamos os status de e-mail

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.

Compartilhar

Experimente o que você acabou de ler.

3.000 e-⁠mails por mês grátis. Sem cartão de crédito.

3.000 e-⁠mails por mês grátis · Sem cartão de crédito