# Solução de problemas de SMTP

> Todos os códigos de resposta que o SMTP relay do Emailit pode retornar, com a causa e a solução, além de portas bloqueadas, erros de TLS, timeouts e e-mails aceitos que não são entregues.

Use esta página quando o SMTP relay rejeitar uma mensagem ou o seu cliente não conseguir se conectar. Os erros estão agrupados pela etapa da conversa SMTP em que acontecem, e cada um indica a causa e a solução.

## Encontrar o código de resposta

- **Na sua aplicação.** As bibliotecas de e-mail incluem a resposta do servidor no erro, por exemplo `Error: Invalid login: 535 Authentication failed` no Nodemailer ou `SMTPAuthenticationError: (535, b'Authentication failed')` no Python.
- **No Emailit.** **Email API → Logs** registra cada mensagem enviada com a origem **SMTP** e o código de resposta dela, além das rejeições por limite de envio e das falhas de login de chaves que o Emailit consegue identificar. Filtre por **Status code** ou **API key**.
- **Com um teste manual.** Execute o comando cURL de [Enviar uma mensagem de teste](/pt/docs/smtp/#send-a-test-message) com `-v` para ver a conversa inteira.

Os códigos que começam com `4` são temporários: os clientes bem implementados tentam de novo mais tarde. Os códigos que começam com `5` são permanentes: corrija a causa antes de enviar de novo.

## Referência rápida

| Código e mensagem | Etapa | Seção |
| --- | --- | --- |
| `535 Authentication failed` | AUTH | [Erros de login](#login-errors) |
| `454 Temporary authentication failure` | AUTH | [Erros de login](#login-errors) |
| `452 4.4.5 Messages per second limit exceeded` | MAIL FROM | [Erros de limite de envio](#rate-limit-errors) |
| `452 4.5.3 Daily message limit exceeded` | MAIL FROM | [Erros de limite de envio](#rate-limit-errors) |
| `451 Temporary local error in processing` | Qualquer | [Erros temporários](#temporary-errors) |
| `501 Invalid RCPT TO` | RCPT TO | [Erros de destinatário](#recipient-errors) |
| `530 Authentication required` | RCPT TO | [Erros de destinatário](#recipient-errors) |
| `535 Mail server has been suspended` | RCPT TO | [Erros de destinatário](#recipient-errors) |
| `550 Unverified workspaces can only send to…` | RCPT TO | [Erros de destinatário](#recipient-errors) |
| `552 Message too large` | DATA | [Erros de mensagem](#message-errors) |
| `530 From/Sender domain is not verified for this workspace` | DATA | [Erros de mensagem](#message-errors) |
| `530 API key is restricted to sending domain` | DATA | [Erros de mensagem](#message-errors) |
| `550 Sending from this domain is paused` | DATA | [Erros de mensagem](#message-errors) |
| `550 Loop detected` | DATA | [Erros de mensagem](#message-errors) |
| `550 Message processing failed` | DATA | [Erros de mensagem](#message-errors) |
| `452 Insufficient credits to receive inbound email` | DATA | [Erros de recebimento](#inbound-errors) |

## Erros de login

Estes erros acontecem quando o seu cliente envia `AUTH`.

### 535 Authentication failed

**Causa.** A senha não é uma chave de API válida de nenhum workspace. A chave pode ter um erro de digitação ou espaços extras, pode ter sido excluída ou regenerada, ou pode ser uma chave antiga que você substituiu.

**Solução.** Copie a chave de novo do lugar em que você a guardou quando a criou. O Emailit mostra as chaves uma única vez, então, se você não a tiver mais, crie uma chave nova em **Email API → API Keys**. Use `emailit` como usuário e a chave completa, começando com `secret_`, como senha. Consulte [Por que o SMTP retorna 535 Authentication failed?](/pt/docs/kb/smtp-535-authentication-failed/).

### 454 Temporary authentication failure

**Causa.** O Emailit não conseguiu verificar a chave por causa de um erro interno.

**Solução.** Tente de novo depois de uma breve espera. Se continuar por mais de alguns minutos, consulte [status.emailit.com](https://status.emailit.com) e fale com o suporte.

## Erros de limite de envio

Estes erros acontecem quando o seu cliente envia `MAIL FROM` para iniciar uma mensagem.

### 452 4.4.5 Messages per second limit exceeded

**Causa.** O seu workspace enviou no último segundo mais mensagens do que o limite por segundo dele, que é 2 por padrão. O limite é compartilhado com a API e conta cada transação SMTP como uma mensagem. Os números entre parênteses mostram a contagem atual e o limite.

**Solução.** A maioria dos clientes tenta de novo automaticamente após um `452`. Para evitá-lo, envie a partir de uma fila com concorrência limitada, ou reutilize uma única conexão e envie as mensagens uma depois da outra. Se precisar de um ritmo maior, use **Request Increase** no card **Sending Limits** da página inicial do painel. Consulte [Limites](/pt/docs/limits/).

### 452 4.5.3 Daily message limit exceeded

**Causa.** O workspace atingiu o limite diário, que é de 5.000 mensagens por padrão e é compartilhado com a API.

**Solução.** Os envios são retomados depois da meia-noite UTC. Solicite um limite diário maior pelo card **Sending Limits** na página inicial do painel. Os workspaces no Pro e no Business também recebem aumentos automáticos quando a saúde de envio deles está boa.

## Erros temporários

### 451 Temporary local error in processing

**Causa.** O Emailit encontrou um erro interno ao tratar o comando. Isso pode acontecer em qualquer etapa.

**Solução.** Tente de novo mais tarde. Os servidores de e-mail e a maioria das bibliotecas fazem isso automaticamente com respostas `4xx`. Se persistir, fale com o suporte informando o horário da tentativa.

## Erros de destinatário

Estes erros acontecem quando o seu cliente envia `RCPT TO` para cada destinatário.

### 501 Invalid RCPT TO

**Causa.** O endereço do destinatário está malformado, por exemplo não tem `@` ou não tem nada antes ou depois dele. A mensagem completa é `Invalid RCPT TO format` ou `Invalid RCPT TO`.

**Solução.** Valide os endereços antes de enviar. Procure valores vazios e nomes de exibição passados onde só um endereço é esperado.

### 530 Authentication required

**Causa.** O cliente não fez login, ou o login falhou e ele continuou mesmo assim. Sem login, o relay só aceita e-mails para os próprios endereços de recebimento e de bounce do Emailit.

**Solução.** Ative a autenticação SMTP no seu cliente e defina o usuário e a senha. Procure um `535` anterior na mesma sessão.

### 535 Mail server has been suspended

**Causa.** O workspace está suspenso, normalmente por causa de uma taxa de bounce alta. Consulte [Saúde de envio](/pt/docs/deliverability/sending-health/).

**Solução.** Fale com o suporte em support@emailit.com. Os envios são retomados depois que a suspensão é removida.

### 550 Unverified workspaces can only send to workspace members' account emails

**Causa.** O workspace está no modo sandbox, e o destinatário não é o e-mail da conta de um membro do workspace. A mensagem termina com o endereço bloqueado.

**Solução.** Teste com o e-mail da conta de um membro ou [solicite o acesso de produção](/pt/docs/workspaces/production-access/). Consulte [Como testar o envio antes de o meu workspace ser verificado?](/pt/docs/kb/test-sending-before-production-access/).

## Erros de mensagem

Estes erros acontecem depois que o seu cliente envia a mensagem com `DATA`.

### 552 Message too large (maximum size 40MB)

**Causa.** A mensagem, incluindo os anexos codificados, tem mais de 40 MB. A codificação Base64 deixa os anexos cerca de um terço maiores que os arquivos.

**Solução.** Envie anexos menores, ou envie os arquivos grandes para o seu próprio armazenamento e inclua um link.

### 530 From/Sender domain is not verified for this workspace

**Causa.** Um endereço do cabeçalho `From` não está em um domínio de envio verificado do workspace dono da chave. Motivos comuns: o domínio ainda não foi verificado ou está aguardando análise, o endereço From está em um subdomínio que você não adicionou, a chave pertence a outro workspace ou a mensagem não tem cabeçalho `From`. O endereço `MAIL FROM` do envelope não importa.

**Solução.** Confira o status do domínio em **Email API → Domains**, faça o endereço From corresponder exatamente a um domínio verificado e use uma chave do mesmo workspace. Consulte [Por que o SMTP retorna 530 From domain not verified?](/pt/docs/kb/smtp-530-from-domain-not-verified/).

### 530 API key is restricted to sending domain

**Causa.** A chave é uma chave **Sending Only** restrita a um domínio, e o endereço From está em outro domínio. A mensagem indica o domínio permitido.

**Solução.** Envie do domínio permitido ou use uma chave sem restrição de domínio.

### 550 Sending from this domain is paused

**Causa.** O Emailit pausou o domínio do From porque a taxa de bounce dele passou de 5%.

**Solução.** Encontre a origem dos bounces e limpe a sua lista. Consulte [Saúde de envio](/pt/docs/deliverability/sending-health/) e [Bounces e reclamações](/pt/docs/deliverability/bounces-and-complaints/).

### 550 Loop detected

**Causa.** A mensagem já passou pelo relay do Emailit mais de quatro vezes, normalmente porque regras de encaminhamento a mandam de um lado para o outro.

**Solução.** Encontre e quebre o loop de encaminhamento entre os seus sistemas ou caixas de e-mail.

### 550 Message processing failed

**Causa.** O Emailit aceitou os dados, mas não conseguiu armazenar a mensagem.

**Solução.** Tente enviar a mensagem de novo. Se falhar outra vez, fale com o suporte informando o horário da tentativa e os endereços From e To.

## Erros de recebimento

### 452 Insufficient credits to receive inbound email

**Causa.** Uma mensagem foi enviada para um dos seus endereços de [recebimento](/pt/docs/inbound/), mas o workspace está sem créditos. Receber um e-mail custa 1 crédito. O servidor remetente recebe esse erro temporário e tenta de novo mais tarde.

**Solução.** Recarregue os seus [créditos](/pt/docs/billing/credits/) ou ative a [recarga automática](/pt/docs/billing/auto-refill/). Os e-mails que o remetente tentar enviar de novo chegam assim que houver créditos disponíveis.

## Problemas de conexão

| Sintoma | Causa provável | Solução |
| --- | --- | --- |
| A conexão dá timeout ou é recusada | O seu provedor de internet, de hospedagem ou de nuvem bloqueia a porta. A porta 25 é bloqueada na maioria das plataformas de nuvem, e algumas bloqueiam a 587. | Use a `587` e depois a `2525` ou a `2587`. Consulte [Por que a minha conexão SMTP dá timeout?](/pt/docs/kb/smtp-connection-timeout-port-25/). |
| `wrong version number`, ou a conexão trava depois de conectar | O modo de TLS não corresponde à porta: TLS implícito na 587, ou STARTTLS na 465. | Use STARTTLS nas portas 587, 2525, 2587 e 25, e TLS implícito apenas na 465. |
| O nome do certificado não corresponde | Você se conecta pelo endereço IP ou por um nome de host próprio. | Conecte-se a `smtp.emailit.com`. |
| O handshake falha em um sistema antigo | O cliente não consegue negociar uma versão moderna de TLS, ou os certificados de CA dele estão desatualizados. | Atualize o runtime, o OpenSSL e o pacote de CAs. |

Consulte [Por que recebo erros de TLS ao me conectar ao SMTP?](/pt/docs/kb/smtp-tls-errors/) para mais detalhes.

## Aceito, mas não entregue

Uma resposta `250` significa que o Emailit aceitou a mensagem, não que ela chegou à caixa de entrada. Abra o e-mail em **Email API → Emails** usando o ID da resposta e confira o status dele:

- **Held:** o workspace ficou sem créditos, o domínio foi pausado ou a mensagem teve pontuação 7 ou mais na [verificação de spam](/pt/docs/deliverability/spam-checks/). Corrija a causa e [tente de novo](/pt/docs/email-api/retry-and-forward/). Consulte [Por que o meu e-mail está retido?](/pt/docs/kb/email-status-held/).
- **Suppressed:** o destinatário está na sua [lista de supressão](/pt/docs/suppressions/).
- **Attempted:** o servidor do destinatário retornou um erro temporário. O Emailit tenta de novo por cerca de 21 horas.
- **Bounced** ou **Failed:** os detalhes da entrega mostram a resposta do servidor de destino. Consulte [Bounces e reclamações](/pt/docs/deliverability/bounces-and-complaints/).

Para um checklist completo, consulte [Por que o meu e-mail não chegou?](/pt/docs/kb/email-not-delivered-checklist/).

## Ainda com problemas?

Envie um e-mail para support@emailit.com ou pergunte no [Discord](https://discord.emailit.com). Informe o horário da tentativa, a porta, a sua biblioteca de e-mail e a resposta completa do servidor.

---
Fonte: https://emailit.com/pt/docs/smtp/troubleshooting/