# 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](/pt/docs/dictionary/smtp-reply-codes/), 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`:

```text
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](/pt/docs/dictionary/smtp-reply-codes/#how-emailit-handles-replies-from-recipient-servers).

## 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](/pt/docs/limits/) 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](/pt/docs/deliverability/sending-health/), 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](/pt/docs/email-verification/) 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](/pt/docs/domains/dns-records/). |
| `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](/pt/docs/deliverability/best-practices/). 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](/pt/docs/domains/verification/) para que o DKIM passe e confira, com os [relatórios DMARC](/pt/docs/dmarc/reports/), 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](/pt/docs/dmarc/set-up/). |
| `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. |

> **Os provedores usam os códigos de formas diferentes:** As RFCs definem o significado geral, mas os provedores de e-mail muitas vezes reaproveitam os códigos por motivos próprios. O texto da mensagem depois do código costuma ser mais específico, então leia-o antes de decidir o que mudar.

## Veja também

- [Códigos de resposta SMTP](/pt/docs/dictionary/smtp-reply-codes/)
- [Categorias de bounce](/pt/docs/dictionary/bounce-categories/)
- [Bounces e reclamações](/pt/docs/deliverability/bounces-and-complaints/)
- [Detalhes do e-mail](/pt/docs/logs/email-details/)

---
Fonte: https://emailit.com/pt/docs/dictionary/enhanced-status-codes/