Códigos SMTP comuns e como solucioná-los
O padrão SMTP atual define códigos de resposta, mas eles são aplicados de forma diferente entre os servidores SMTP. Nem todo servidor de e-mail é configurado da mesma forma, e por isso há diferenças em como as falhas de entrega são interpretadas.
Lembre-se: Como não existem dois servidores SMTP iguais, uma resposta “caixa de correio indisponível” em um servidor pode ser um erro de “mensagem rejeitada” em outro!
Códigos de status gerais do SMTP
Códigos SMTP que começam com 2 e 3 são mensagens gerais de status enviadas em resposta a solicitações do servidor remetente. Eles não indicam erros na entrega do e-mail, mas são utilizados como prompts na comunicação entre os servidores de e-mail.
| Código SMTP | Descrição | Significado |
|---|---|---|
| 214 | Mensagem de ajuda | Resposta ao comando HELP, geralmente inclui um link ou URL para a página de FAQ. |
| 220 | Serviço SMTP pronto | O servidor destinatário está pronto para o próximo comando. |
| 221 | Fechando canal de transmissão | O servidor destinatário está fechando a conexão SMTP. |
| 235 | 2.7.0 Autenticação bem-sucedida | A autenticação do servidor remetente foi bem-sucedida. |
| 250 | Ação de e-mail solicitada concluída | Sucesso! O e-mail foi entregue. |
| 251 | Usuário não local; irá encaminhar para <forward-path> | O servidor não reconhece o destinatário, mas irá encaminhar o e-mail. |
| 252 | Não consegue verificar o usuário, mas irá tentar entregar | O servidor não reconhece o destinatário, mas tentará entregar mesmo assim. |
| 334 | Resposta ao comando AUTH quando o método é aceito | Autenticação bem-sucedida. |
| 354 | Iniciar entrada de e-mail | Cabeçalho do e-mail recebido, servidor aguardando o corpo da mensagem. |
Códigos de erro SMTP temporários
Códigos SMTP que começam com 4 são erros transitórios (soft bounce), geralmente relacionados ao servidor de destino. O remetente pode tentar novamente após, por exemplo, reduzir o tamanho dos anexos.
| Código SMTP | Descrição | Significado |
|---|---|---|
| 421 | Serviço indisponível, fechando canal | O servidor não está acessível, mas outra tentativa será feita. Verifique se consegue conectar ao servidor remoto ou o status do servidor de destino. |
| 450 | Ação solicitada não realizada: caixa de correio indisponível | Pode significar destinatário inexistente, permissão negada ou bloqueio por lista negra/filtro. Verifique o endereço do destinatário, bloqueios e conteúdo do e-mail. |
| 451 | Ação abortada: erro no processamento | O servidor não consegue processar o e-mail devido a regras de autenticação (por exemplo, SPF). Verifique os registros DNS e o funcionamento do servidor de nomes. |
| 452 | Ação não realizada: armazenamento insuficiente | O servidor está sobrecarregado ou sem espaço/memória. Verifique a fila de envio ou informe o administrador do servidor. |
| 455 | Servidor não consegue acomodar os parâmetros | O servidor não consegue processar o comando no momento. Tente novamente após aguardar ou contate o administrador do servidor. |
Códigos de erro SMTP permanentes
Códigos SMTP começando com 5 indicam erros permanentes (hard bounce) geralmente causados pelo remetente. O servidor retorna a mensagem e espera que o remetente não tente novamente sem corrigir o problema.
| Código SMTP | Descrição | Significado |
|---|---|---|
| 500 | Erro de sintaxe, comando não reconhecido | Comando não reconhecido. Verifique antivírus/firewall antes de tentar novamente. |
| 501 | Erro de sintaxe em parâmetros | Comando reconhecido, mas com erros nos parâmetros. Verifique se o e-mail está correto e o antivírus/firewall. |
| 502 | Comando não implementado | O comando não é suportado no servidor de destino. Verifique os comandos e a configuração do MTA. |
| 503 | Sequência incorreta de comandos | Comando reconhecido, mas os parâmetros estão em ordem errada. Verifique a configuração do MTA. |
| 504 | Parâmetro de comando não implementado | Similar ao 502, mas o parâmetro não é suportado. Revise os comandos e o MTA. |
| 521 | Servidor não aceita e-mails | O servidor não recebe/envia e-mails, podendo estar em um relay. Verifique se o e-mail foi entregue. |
| 535 | Credenciais de autenticação inválidas | Problemas com autenticação, credenciais ou configuração de criptografia inválidas. |
| 541 | Destinatário rejeitou a mensagem | Mensagem sinalizada como spam ou bloqueada. Verifique listas de bloqueio e o conteúdo do e-mail. |
| 550 | Ação não realizada: caixa de correio indisponível | Endereço do destinatário não existe. Verifique erros de digitação ou use ferramenta de verificação de e-mails. |
| 551 | Usuário não local; tentar <forward-path> | Usuário não encontrado no servidor, mas e-mail será encaminhado. Verifique os registros de autenticação se usar relay SMTP. |
| 552 | Ação abortada: limite de armazenamento excedido | Caixa de entrada do usuário cheia. Tente contato por outro meio para informar. |
| 553 | Nome de caixa de correio não permitido | Endereço inválido no campo To, Cc ou Bcc. Verifique os endereços. |
| 554 | Transação falhou | O servidor de destino não aceita sua mensagem, possivelmente por lista de bloqueio. Verifique e solicite inclusão na safelist se necessário. |
Como ler os códigos SMTP
Os códigos SMTP básicos, criados em 1982, são compostos por três dígitos:
Primeiro dígito (status geral):
-
2: Sucesso
-
3: Comando aceito, mas precisa de mais informações
-
4: Erro temporário (soft bounce)
-
5: Erro permanente (hard bounce)
Segundo dígito (categoria):
-
0: Sintaxe
-
1: Informação
-
2: Conexões
-
5: Sistema de e-mail
Terceiro dígito: Detalha a categoria específica do erro.
Exemplo:
Aqui, o código 250 indica sucesso e que o servidor está pronto para o próximo comando.
Códigos de status avançados
Os códigos avançados possuem três dígitos separados por pontos (ex: 5.1.1), permitindo diagnósticos mais detalhados:
Primeiro dígito:
-
2: Sucesso
-
4: Falha transitória persistente
-
5: Falha permanente
Segundo dígito (assunto):
-
0: Outro ou indefinido
-
1: Endereçamento
-
2: Status da caixa de correio
-
3: Status do sistema de e-mail
-
4: Rede e roteamento
-
5: Protocolo de entrega
-
6: Conteúdo da mensagem
-
7: Segurança ou política
Terceiro dígito: Detalhe específico.
Exemplo:
Indica que o comando foi bem-sucedido e o destinatário foi aceito pelo servidor.
Resumo
O SMTP é essencial para a infraestrutura de e-mail, mas quando algo falha, entender os códigos pode ser difícil. Salve esta explicação e utilize-a sempre que precisar interpretar os códigos SMTP ao diagnosticar problemas de envio de e-mails.