Códigos de erro SMTP e o que eles significam
O e-mail parece um pouco mágico, até parar de funcionar. Você clica em enviar e espera que a mensagem chegue à caixa de entrada, mas, às vezes, ela é devolvida com uma mensagem de erro enigmática. Existem muitos tipos de erros, pois o quebra-cabeça do e-mail tem muitas peças para fazer a mágica acontecer. Erros de devolução são bastante mencionados, mas e os erros SMTP?
O SMTP, ou Simple Mail Transfer Protocol, é a linguagem que os servidores usam para se comunicar ao enviar e-mails. Quando algo dá errado nessa conversa, o servidor retorna um código para explicar o que aconteceu.
Esses códigos de status oferecem insights valiosos, ajudando você a descobrir o que deu errado e como corrigir o problema. De falhas temporárias a erros permanentes, os códigos SMTP ajudam você a manter o controle da sua entrega de e-mail.
Como funcionam os códigos SMTP
Os códigos SMTP são curtos — apenas três dígitos —, mas cheios de significado.
O primeiro dígito indica o tipo de resposta:
- 2 significa sucesso: a ação solicitada foi concluída.
- 4 indica um problema temporário: você pode tentar novamente mais tarde.
- 5 significa falha permanente: você precisa corrigir algo antes de tentar novamente.
O segundo e o terceiro dígitos oferecem mais detalhes, apontando para problemas específicos, como autenticação, roteamento ou problemas na caixa de correio.
Ler os códigos SMTP é como aprender um idioma simples. Depois que você pega o jeito, a solução de problemas fica mais fácil e rápida.
Erros SMTP comuns explicados
Embora existam muitos códigos, alguns aparecem com mais frequência. Vamos analisar os principais tipos de respostas SMTP e o que elas significam.
Problemas temporários
Erros temporários sugerem um problema de curto prazo. Na maioria dos casos, tentar novamente mais tarde resolve. Por exemplo, se você vir o erro 421 service not available, o servidor de recebimento pode estar temporariamente offline ou muito ocupado. Um erro 450 mailbox unavailable significa que a caixa de entrada do destinatário está cheia ou temporariamente desativada. Erros de timeout, como 447 timeout occurred, costumam indicar problemas de servidor ou conexão que devem ser resolvidos rapidamente.
Falhas permanentes
Erros permanentes indicam que algo deve ser corrigido antes que o e-mail possa ser enviado novamente.
Um erro 550 mailbox unavailable significa que o endereço não existe. O erro 553 mailbox name not allowed costuma indicar um problema de formatação ou que o domínio está rejeitando sua mensagem. E o erro 554 transaction failed pode significar que sua mensagem caiu em um filtro de spam ou foi bloqueada pelo servidor do destinatário.
Bônus: códigos de status aprimorados
Alguns servidores usam códigos SMTP aprimorados para fornecer detalhes adicionais. Esses códigos, como 5.1.1 bad destination mailbox address, são mais específicos e ajudam a identificar problemas como erros de digitação ou domínios inválidos.
Entender tanto os códigos básicos quanto os aprimorados oferece visibilidade total dos problemas de e-mail.
Códigos de resposta SMTP, decifrados
À primeira vista, os erros SMTP parecem complicados. Mas com um pouco de orientação, eles se tornam sinais claros que ajudam você a resolver problemas rapidamente. De erros de sintaxe a domínios bloqueados, ler esses códigos ajuda a manter seu programa de e-mail funcionando sem problemas e suas mensagens chegando às caixas de entrada.
Lista completa de códigos de erro SMTP
Aqui está uma lista de códigos de erro SMTP que você pode encontrar e algumas soluções rápidas que podem ajudar.
| Código | O que significa | Como corrigir |
|---|---|---|
| 101 | A conexão falhou devido a uma configuração de SSL ou TLS inválida. | Revise as configurações de segurança do seu servidor e verifique se os certificados SSL/TLS são válidos e estão instalados corretamente. |
| 111 | O servidor de envio não conseguiu se conectar ao servidor SMTP remoto. | Verifique a conexão de rede, as regras de firewall e certifique-se de que o servidor do destinatário esteja online e aceitando conexões. |
| 221 | O servidor do domínio está fechando o canal de transmissão — isso geralmente acontece após uma sessão de e-mail bem-sucedida. | Nenhuma ação é necessária. Isso é normal quando a comunicação é concluída. |
| 250 | A ação solicitada foi concluída com sucesso. | Nenhuma correção é necessária — isso significa que seu e-mail foi aceito. |
| 420 | Um firewall ou filtro bloqueou o e-mail antes que ele pudesse ser entregue. | Revise as políticas do destinatário, os filtros de spam e a reputação do IP para garantir que seus e-mails sejam permitidos. |
| 421 | O servidor de e-mail do destinatário está temporariamente indisponível ou ocupado. | Aguarde e tente novamente mais tarde. Se persistir, entre em contato com a pessoa responsável pela administração do servidor de destino. |
| 422 | A caixa de correio de destino excedeu sua cota de armazenamento. | Peça para a pessoa destinatária liberar espaço ou aguarde até que o problema seja resolvido. |
| 431 | Não há armazenamento ou memória suficiente disponível para processar a mensagem. | Tente novamente mais tarde ou entre em contato com a pessoa responsável pela administração do servidor de destino para resolver os problemas de capacidade. |
| 441 | A conexão foi interrompida antes que o servidor pudesse terminar de processar a mensagem. | Verifique a estabilidade da rede e tente novamente. |
| 442 | O servidor começou a processar a mensagem, mas a conexão foi fechada inesperadamente. | Investigue possíveis interrupções de rede ou esgotamentos de tempo limite no servidor. |
| 446 | A mensagem passou por muitos servidores em loop e foi rejeitada. | Revise as regras de roteamento de e-mail e verifique se os registros MX estão corretos. |
| 447 | O servidor de envio sofreu um esgotamento do tempo limite enquanto aguardava uma resposta. | Tente enviar novamente mais tarde e verifique se há problemas de conectividade ou sobrecarga do servidor. |
| 449 | Falha em uma busca DNS durante a tentativa de entrega. | Verifique a configuração DNS do domínio de destino e tente novamente mais tarde. |
| 450 | A caixa de correio está temporariamente indisponível — geralmente por estar cheia ou inativa. | Tente novamente após um tempo ou verifique o endereço de e-mail de destino. |
| 451 | O servidor encontrou um erro local ao processar o e-mail. | Tente novamente mais tarde. Se persistir, entre em contato com a pessoa responsável pela administração de e-mail de destino. |
| 452 | O servidor de recebimento não tem armazenamento suficiente para aceitar sua mensagem. | Aguarde e tente novamente. Em caso de problemas persistentes, notifique a pessoa destinatária. |
| 454 | A criptografia TLS é obrigatória, mas está indisponível no momento. | Verifique as configurações de TLS do seu servidor ou tente novamente mais tarde, quando o servidor de destino suportar criptografia. |
| 471 | A mensagem foi bloqueada por uma regra de antispam ou firewall. | Verifique seu IP de envio e conteúdo em busca de gatilhos de spam e remova elementos problemáticos. |
| 500 | O comando enviado não foi reconhecido ou estava formatado incorretamente. | Verifique os comandos SMTP e veja se há erros de digitação ou de sintaxe. |
| 501 | Os parâmetros ou argumentos fornecidos não são válidos. | Revise o endereço de e-mail de destino e a sintaxe do comando. |
| 502 | O comando utilizado não é suportado pelo servidor de recebimento. | Revise a compatibilidade do protocolo e evite comandos não suportados. |
| 503 | Os comandos foram enviados fora de ordem ou na hora errada. | Revise a sequência de comandos SMTP e ajuste sua lógica de envio para seguir a ordem correta. |
| 504 | O parâmetro de comando fornecido não é suportado pelo servidor. | Remova os parâmetros não suportados ou ajuste-os para ter compatibilidade com o servidor de destino. |
| 510 | O endereço de destino era inválido ou estava formatado incorretamente. | Verifique se há erros de digitação ou falhas no endereço de e-mail. |
| 511 | A caixa de correio de destino não existe. | Verifique novamente o endereço de e-mail de destino ou confirme-o diretamente com a pessoa destinatária. |
| 512 | A parte do domínio do endereço de destino não existe. | Verifique os registros DNS do domínio ou corrija eventuais erros de digitação no endereço de e-mail. |
| 513 | O servidor não permite relaying ou o tipo de endereço está incorreto. | Confirme as permissões de relaying ou corrija o formato do endereço. |
| 515 | O endereço da caixa de correio de destino é inválido. | Confirme o endereço de e-mail de destino e corrija os problemas. |
| 517 | Os atributos de e-mail do remetente estão incorretos ou não são suportados. | Revise e corrija o endereço e as configurações do remetente. |
| 521 | O domínio de destino não aceita e-mails recebidos. | Entre em contato com a pessoa proprietária do domínio ou escolha um método de contato alternativo. |
| 522 | A pessoa destinatária excedeu o limite da sua caixa de correio. | Peça para a pessoa destinatária liberar espaço ou tente novamente mais tarde. |
| 523 | O e-mail é muito grande para o servidor de recebimento aceitar. | Reduza o tamanho do anexo ou compacte o conteúdo do e-mail e reenvie. |
| 530 | É necessário se autenticar para enviar e-mails a este servidor. | Configure e forneça credenciais de autenticação SMTP válidas. |
| 531 | O sistema de e-mail está cheio e não pode aceitar mais mensagens. | Aguarde e tente novamente mais tarde ou notifique a pessoa destinatária. |
| 533 | O servidor remoto não tem espaço em disco suficiente para armazenar o e-mail. | Tente novamente mais tarde ou entre em contato com a pessoa responsável pela administração do servidor de destino. |
| 534 | O mecanismo de autenticação usado é muito fraco para a política deste servidor. | Faça upgrade para um método de autenticação mais forte, como STARTTLS ou SSL. |
| 535 | A autenticação é obrigatória, mas está ausente ou é inválida. | Revise seu nome de usuário e senha SMTP e garanta a configuração adequada. |
| 538 | A criptografia é obrigatória para o processo de autenticação, mas não foi fornecida. | Ative a criptografia (TLS/SSL) e tente enviar novamente. |
| 540 | O domínio de destino não tem registros DNS para tratamento de e-mail. | Verifique os registros DNS do domínio ou entre em contato com a pessoa responsável pela sua administração. |
| 541 | O servidor de destino não respondeu à tentativa de entrega. | Tente novamente mais tarde ou investigue possíveis problemas de rede. |
| 542 | A conexão foi rejeitada devido à má qualidade da conexão. | Tente enviar novamente ou verifique sua conexão de rede. |
| 543 | O servidor de roteamento não conseguiu encontrar um caminho de entrega válido. | Revise o DNS do domínio e os registros MX ou entre em contato com a pessoa responsável pela administração do domínio de destino. |
| 546 | O e-mail entrou em loop entre servidores e foi rejeitado. | Revise as configurações de roteamento de e-mail para evitar cenários de loop. |
| 547 | O tempo limite de entrega foi esgotado após várias tentativas falhas. | Tente novamente mais tarde ou investigue a disponibilidade do servidor. |
| 550 | A ação solicitada não foi realizada porque a caixa de correio está indisponível. | Verifique o endereço de destino ou entre em contato com a pessoa destinatária diretamente. |
| 551 | O usuário não é local no servidor de destino e o encaminhamento não está configurado. | Solicite um endereço de e-mail atualizado ou confirme se o encaminhamento está configurado. |
| 552 | A caixa de correio de destino excedeu seu espaço de armazenamento alocado. | Peça para a pessoa destinatária liberar espaço na caixa de correio ou tente novamente mais tarde. |
| 553 | O nome da caixa de correio é inválido ou não é permitido pelo servidor. | Corrija o endereço de e-mail de destino ou verifique as restrições de domínio. |
| 554 | A transação falhou devido a uma rejeição relacionada a uma política ou a spam. | Revise o conteúdo da mensagem e a reputação do IP, e garanta a conformidade com as práticas recomendadas de envio. |
| 555 | A versão do protocolo SMTP usada não é suportada pelo servidor de destino. | Atualize seu servidor de e-mail para usar uma versão compatível do SMTP. |
| 556 | O e-mail enviado é muito grande para o servidor de destino lidar. | Reduza o tamanho da mensagem ou use links de compartilhamento de arquivos em vez de anexos grandes. |
Conclusão
Os códigos de erro SMTP podem parecer complexos no começo, mas têm um papel importante em ajudar você a entender e a solucionar problemas de entrega de e-mail. Ao aprender o que esses códigos significam e como agir em relação a eles, você pode reduzir as falhas de envio, melhorar o desempenho e manter seu programa de e-mail funcionando perfeitamente.
