Referência
Códigos de status estendidos
Os códigos de status estendidos da RFC 3463, como 5.1.1, 4.7.0 e 5.7.26, explicados com a causa habitual de cada um e o que mudar antes de enviar de novo.
Os códigos de status estendidos são os códigos x.y.z que vêm depois da resposta de três dígitos na maioria das respostas SMTP. Eles são mais precisos que o código de resposta, por isso são o jeito mais rápido de entender por que um e-mail deu bounce ou foi adiado.
Como o código é formado
Um código de status estendido tem três partes, class.subject.detail:
550 5.1.1 The email account that you tried to reach does not exist.
│ │ └─ detail: bad destination mailbox address
│ └─── subject: addressing
└───── class: permanent failure| Classe | Significado |
|---|---|
2 |
Sucesso. |
4 |
Falha transitória persistente. A mensagem pode ser entregue se for enviada de novo mais tarde. |
5 |
Falha permanente. Enviar a mesma mensagem de novo não vai funcionar. |
| Assunto | Área |
|---|---|
0 |
Outro ou indefinido. |
1 |
Endereçamento: o endereço do remetente ou do destinatário. |
2 |
Caixa de e-mail: a caixa do destinatário, por exemplo cheia ou desativada. |
3 |
Sistema de e-mail: o sistema de destino, por exemplo limites de armazenamento ou de tamanho. |
4 |
Rede e roteamento: DNS, conexões e timeouts. |
5 |
Protocolo de entrega de e-mails: comandos e sintaxe SMTP. |
6 |
Conteúdo ou mídia da mensagem: codificação e conversão. |
7 |
Segurança ou política: autenticação, filtragem de spam e reputação. |
O Emailit guarda o código estendido de toda entrega com falha. Você o vê, com a resposta completa, na aba Deliveries do e-mail e como smtp_enhanced_code nos eventos de webhook email.attempted. Se o Emailit faz novas tentativas ou não depende do código de resposta e da mensagem, como descrito em Como o Emailit trata as respostas.
Códigos de sucesso
| Código | Significado | Observações |
|---|---|---|
2.0.0 |
Sucesso. | O SMTP relay do Emailit responde 250 2.0.0 OK: queued as em_... quando aceita a sua mensagem. |
2.1.5 |
Endereço de destino válido. | O destinatário foi aceito. |
2.6.0 |
Mensagem aceita. | Comum nas respostas de servidores da Microsoft. |
Falhas temporárias (4.x.x)
| Código | Significado | Causa comum | O que fazer |
|---|---|---|---|
4.2.1 |
Caixa de e-mail temporariamente indisponível. | A caixa está recebendo e-mails rápido demais ou está inativa. | Nada, para uma única mensagem. O Emailit trata como permanentes as respostas do Gmail “receiving mail at a rate” e “inactive mailbox”. |
4.2.2 |
Caixa cheia. | O destinatário excedeu a cota de armazenamento. | O Emailit trata as respostas comuns de cota excedida como hard bounces. Remova o endereço se isso continuar acontecendo. |
4.3.0 |
Problema no sistema de e-mail. | Uma falha temporária no servidor de destino. | Nada. O Emailit faz novas tentativas. |
4.4.1 |
Sem resposta do host. | O servidor do destinatário não respondeu ou a conexão deu timeout. | Nada, para uma única mensagem. Se um domínio inteiro for afetado, confira se os registros MX dele funcionam. |
4.4.2 |
Conexão ruim. | A conexão caiu durante a transação. | Nada. O Emailit faz novas tentativas. |
4.4.5 |
Congestionamento do sistema. | O servidor de destino está sobrecarregado. O relay do Emailit também usa este código quando você excede o seu limite de envio por segundo. | Reduza o ritmo. No relay do Emailit, fique abaixo do seu limite por segundo. |
4.5.3 |
Destinatários demais. | Destinatários demais em uma única transação. O relay do Emailit também usa este código quando você atinge o seu limite diário de envio. | No relay do Emailit, espere a renovação diária às 00:00 UTC ou solicite um limite maior. |
4.7.0 |
Rejeição temporária por segurança ou política. | Greylisting ou um provedor limitando o ritmo de e-mails que considera suspeitos, como o “unusual rate of unsolicited mail” do Gmail. | Deixe o Emailit tentar de novo. Se persistir, confira a saúde de envio, as taxas de reclamação e a autenticação. |
4.7.1 |
Entrega temporariamente não autorizada. | Greylisting ou um bloqueio temporário por política. | Deixe o Emailit tentar de novo. |
4.7.28 |
Limite de ritmo (Gmail). | O Gmail detectou um volume incomum de e-mails não solicitados vindos do seu IP ou domínio. | Reduza o volume para o Gmail, limpe a sua lista e analise as reclamações. |
Falhas permanentes (5.x.x)
| Código | Significado | Causa comum | O que fazer |
|---|---|---|---|
5.0.0 |
Falha permanente, sem detalhes. | Uma rejeição genérica. | Leia o texto da mensagem para ver o motivo. |
5.1.0 |
Erro de endereço. | O endereço foi rejeitado por um motivo de endereçamento não especificado. | Confira se há erros de digitação no endereço. |
5.1.1 |
Caixa de destino inválida. | A caixa de e-mail não existe. | Remova o endereço. O Emailit o suprime se ele der hard bounce de novo em até 24 horas. |
5.1.2 |
Sistema de destino inválido. | O domínio do destinatário não existe ou não tem servidor de e-mail. | Confira se há erros de digitação no domínio, como gmial.com. |
5.1.3 |
Sintaxe do endereço de destino inválida. | O endereço não é válido. | Corrija o endereço ou verifique a sua lista antes de enviar. |
5.1.8 |
Endereço do sistema do remetente inválido. | O servidor de destino não conseguiu resolver o domínio do remetente do envelope. | Confira se os seus registros MX e SPF de return path em emailit.yourdomain.com estão publicados. Consulte Registros DNS. |
5.1.10 |
O destinatário tem um MX nulo ou não foi encontrado. | MX nulo da RFC 7505. A Microsoft também usa este código quando o destinatário não existe. | Remova o endereço. |
5.2.1 |
Caixa de e-mail desativada. | A conta foi encerrada ou suspensa. | Remova o endereço. |
5.2.2 |
Caixa cheia. | O destinatário excedeu a cota. | Tente de novo bem mais tarde ou remova o endereço se isso continuar acontecendo. |
5.2.3 |
Mensagem longa demais para a caixa de e-mail. | A mensagem excede o limite de tamanho do destinatário. | Reduza o tamanho da mensagem. |
5.3.4 |
Mensagem grande demais para o sistema. | A mensagem excede o limite de tamanho do servidor de destino. | Envie anexos menores ou inclua links para os arquivos. |
5.4.1 |
Sem resposta do host ou acesso negado. | A Microsoft o usa quando um destinatário é rejeitado na borda, muitas vezes porque o endereço não existe. | Confira o endereço e remova-o se for inválido. |
5.4.4 |
Não foi possível rotear. | O domínio do destinatário não tem um registro MX ou A utilizável. | Confira o domínio. |
5.5.0 |
Erro de protocolo. | O servidor rejeitou um comando SMTP. | Fale com o suporte se isso afetar muitos destinatários. |
5.7.0 |
Rejeição por segurança ou política. | Um bloqueio genérico por política, muitas vezes por spam ou reputação. | Leia o texto da mensagem e revise o conteúdo e a qualidade da lista. |
5.7.1 |
Entrega não autorizada, mensagem recusada. | O servidor do destinatário bloqueou a mensagem ou o seu IP: filtragem de spam, uma lista de bloqueio ou um destinatário que só aceita e-mails de certos remetentes. | Leia o texto da mensagem. Para listas de bloqueio, consulte as boas práticas. Em bloqueios que não são por conteúdo, o Emailit pausa aquela rota de IP para domínio por uma hora. |
5.7.8 |
Credenciais de autenticação inválidas. | Usuário ou senha errados, normalmente quando a sua aplicação faz login em um servidor SMTP. | No relay do Emailit, use uma chave de API como senha. |
5.7.9 |
Mecanismo de autenticação fraco demais. | O servidor exige um método de login mais forte. | Use PLAIN ou LOGIN sobre TLS com o relay do Emailit. |
5.7.23 |
Falha na validação do SPF. | O IP de envio não é autorizado pelo registro SPF do domínio do remetente do envelope. | Confira se o registro TXT em emailit.yourdomain.com contém include:_spf.emailit.com. |
5.7.25 |
Falha na validação do DNS reverso. | O IP de envio não tem um registro PTR correspondente. | Fale com o suporte. O Emailit gerencia o DNS reverso dos IPs dele. |
5.7.26 |
Várias verificações de autenticação falharam, ou o DMARC falhou. | A mensagem falhou no alinhamento de SPF e de DKIM, e a política DMARC do domínio manda rejeitar. O Gmail também o usa para e-mails não autenticados. | Verifique o seu domínio para que o DKIM passe e confira, com os relatórios DMARC, outros serviços que enviam em nome do seu domínio. |
5.7.27 |
O endereço do remetente tem um MX nulo. | MX nulo da RFC 7505 no domínio do remetente. O Gmail também o usa quando o SPF não passa. | Confira os seus registros de return path e SPF. |
5.7.509 |
Acesso negado, o DMARC falhou (Microsoft). | O Outlook.com rejeitou a mensagem porque ela falhou no DMARC e a sua política é reject. |
Corrija o SPF e o DKIM do serviço de envio e depois revise a sua política DMARC. |
5.7.515 |
Acesso negado, nível de autenticação não atendido (Microsoft). | O Outlook.com exige que SPF, DKIM e DMARC passem para remetentes de grande volume. | Publique um registro DMARC e confira se o seu domínio está verificado no Emailit. |
5.7.606 |
Acesso negado, IP de envio banido (Microsoft). | O IP de envio está na lista de bloqueio da Microsoft. | Fale com o suporte, enviando a resposta completa. |