Solução de problemas de SMTP

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 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

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?.

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 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.

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.

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. Consulte Como testar o envio antes de o meu workspace ser verificado?.

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?.

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 e Bounces e reclamações.

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, 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 ou ative a recarga automática. Os e-mails que o remetente tentar enviar de novo chegam assim que houver créditos disponíveis.

Problemas de conexão

Consulte Por que recebo erros de TLS ao me conectar ao SMTP? 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. Corrija a causa e tente de novo. Consulte Por que o meu e-mail está retido?.
• Suppressed: o destinatário está na sua lista de supressão.
• 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.

Para um checklist completo, consulte Por que o meu e-mail não chegou?.

Ainda com problemas?

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