Explicar erro de e-mail (SMTP)

Cole a mensagem de erro ou de devolução (550 5.7.1, 5.1.1, 4.2.2, 5.7.515...) e veja em português o que aconteceu, de quem é o problema e o que fazer.

Como usar#

Cole a mensagem de erro exatamente como ela chegou: a devolução que caiu na sua caixa ("Mail Delivery Subsystem", "Undeliverable"), o log do seu servidor ou a resposta do serviço de envio. A ferramenta acha o código SMTP, diz se o problema é do endereço, temporário ou uma regra do provedor, e o próximo passo.

Os três tipos de recusa#

Tipo	Exemplos	O que quer dizer	O que fazer
Definitiva	550 5.1.1, 550 5.1.10	o endereço não existe	tire da lista e não mande de novo
Temporária	421, 451, 452 4.2.2	servidor ocupado, caixa cheia, limite de ritmo	o envio tenta de novo sozinho; se repetir por dias, pare
Por política	550 5.7.1, 5.7.26, 5.7.515	o provedor bloqueou por autenticação, reputação ou conteúdo	o endereço existe: corrija SPF, DKIM, DMARC ou o conteúdo

Uma mensagem que "expirou" (554 4.4.7 Message expired) traz o motivo de verdade lá dentro, por exemplo 452 4.2.2 inbox out of storage space (caixa cheia). A ferramenta lê o código mais específico.

Os códigos que mais aparecem#

550 5.1.1: a caixa não existe. Quase sempre erro de digitação. Confira no verificador de e-mail.
550 5.7.515 (Microsoft): o domínio não cumpre as regras de autenticação para quem envia em volume. Precisa de SPF, DKIM e DMARC alinhados. Veja e-mail não chega no Hotmail e no Outlook.
550 5.7.26 (Gmail): a mensagem não passou no DMARC. Confira o domínio no verificador de SPF, DKIM e DMARC.
421 4.7.0 / 4.7.28: o provedor está limitando o ritmo. Diminua o volume e mande primeiro para quem mais interage.
452 4.2.2: caixa cheia. Temporário.

A lista completa, com cada caso explicado, está no guia códigos de erro SMTP.

Pela API e pelo MCP#

Terminal

curl -X POST https://api.couryo.com/v1/tools/explain-smtp \
  -H "Content-Type: application/json" \
  -d '{ "message": "550 5.1.1 <ana@exemplo.com.br>: Recipient address rejected: User unknown" }'

Sem chave, são 50 explicações por dia para cada IP; com qualquer chave do Couryo, 2.000 por dia. No MCP público, sem login (https://mcp.couryo.com/tools), a ferramenta é explain_smtp_error: o seu agente de IA pode explicar uma devolução no meio de uma conversa.

No Couryo, você nem precisa colar nada: cada e-mail tem uma linha do tempo com a resposta original do servidor de destino e a explicação em português, e os endereços que não existem vão para a lista de supressão sozinhos.

Perguntas frequentes#

O que significa 550?#

É uma recusa definitiva: o servidor de destino não vai aceitar aquela mensagem como está. O código estendido (como 5.1.1 ou 5.7.1) diz o motivo: endereço inexistente, autenticação, reputação ou conteúdo.

Devo mandar de novo depois de uma recusa?#

Só se for temporária (códigos que começam com 4). Insistir num endereço que não existe derruba a reputação de quem envia, e aí até os e-mails para endereços bons começam a cair no spam.

A culpa é minha ou do destinatário?#

Endereço inexistente e caixa cheia são do lado do destinatário. Recusa por política (5.7.x) quase sempre é do lado de quem envia: autenticação faltando, reputação ou conteúdo suspeito.

A ferramenta guarda o que eu colo?#

Não. O texto é lido, explicado e descartado.