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

Fonte: https://couryo.com/ferramentas/explicar-erro-smtp · Atualizado em 2026-10-21

## 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](https://couryo.com/ferramentas/verificar-email).
- **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](https://couryo.com/blog/email-nao-chega-no-hotmail-outlook).
- **550 5.7.26 (Gmail):** a mensagem não passou no DMARC. Confira o domínio no [verificador de SPF, DKIM e DMARC](https://couryo.com/ferramentas/verificar-dominio).
- **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](https://couryo.com/guias/codigos-de-erro-smtp.md).

## Pela API e pelo MCP

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