Códigos de erro

Como erros de API e respostas SMTP são reportados, e o que fazer em cada caso.

Formato de erro da API

Os erros da API são JSON com um código estável e uma mensagem. Use o código na sua lógica e exiba a mensagem apenas para pessoas, pois o texto pode mudar.

{
  "error": { "code": "invalid_recipient", "message": "The recipient address is not valid." }
}

Tentar de novo ou corrigir?

Os erros se dividem em dois grupos. Corrija a requisição: respostas 4xx diferentes de 429 indicam um problema no que foi enviado, então repetir falhará da mesma forma. Tente novamente depois: respostas 429 e 5xx são temporárias, então repita com backoff exponencial e um limite de tentativas.

Respostas SMTP

As respostas SMTP começam com um código de três dígitos. 2xx significa sucesso. 4xx indica falha temporária, então o remetente deve tentar depois. 5xx indica falha permanente, então não reenvie a mesma mensagem a esse endereço. Muitas respostas acrescentam um código estendido, como 5.1.1, que explica a causa.

Como ler os motivos de bounce

Os códigos estendidos são o jeito mais rápido de entender um bounce. 5.1.1 significa que a caixa de e-mail não existe. 5.2.2 significa que a caixa está cheia. 5.7.1 significa que o servidor de destino rejeitou a mensagem por política, geralmente por autenticação ou reputação. Os códigos 4.x.x são temporários e serão reenviados.

O que fazer com bounces

Remova da lista os endereços com hard bounce e investigue as rejeições por política verificando sua configuração de SPF, DKIM e DMARC. Uma taxa de bounce crescente prejudica sua reputação, então aja rápido.