Central de diagnóstico de entrega

O e-mail de teste não chegou? Descubra primeiro em que etapa ele parou

Não comece reenviando várias vezes. Confirme o endereço, verifique a tarefa de envio e a resposta do provedor; por fim, confira a consulta da caixa e a renderização do conteúdo.

Iniciar diagnóstico passo a passo

Aguardando dados

Conclua primeiro os quatro itens à esquerda

A conclusão indicará a primeira camada que vale a pena verificar e mostrará quais evidências buscar em seguida. Ela não finge acessar diretamente o sistema de envio.

Copie o endereço completo usado nesta rodada.
Guarde o horário de envio, o identificador da mensagem e o código de resposta.
Registre se o assunto, o corpo HTML e o corpo em texto simples estão visíveis.

Cadeia de evidências em cinco camadas

Avance começando pela etapa mais fácil de verificar

Em cada camada, encontre uma evidência observável antes de passar à próxima. Assim, você evita confundir um problema de endereço com um problema de template.

Camada do endereço

Copie novamente o endereço na página atual e confira se tudo está completo antes e depois de @ e se a caixa temporária ainda está dentro do prazo. Depois de trocar de endereço, o token e o endereço antigo não devem continuar sendo usados no teste.

Evidência: endereço completo e validade

Camada da tarefa

Confirme se a ação do sistema realmente acionou uma tarefa de envio, em vez de apenas gravá-la na fila de processamento. Verifique as variáveis de ambiente, o consumidor da fila, o template selecionado e os parâmetros do destinatário.

Evidência: ID da tarefa e logs de execução

Camada da entrega

Confira a resposta retornada pelo SMTP ou pelo provedor de e-mail. Uma aceitação só significa que o próximo salto recebeu a mensagem; não significa que ela chegou à caixa de entrada. Um código de rejeição geralmente já aponta o caminho.

Evidência: ID da mensagem e código de resposta

Camada de leitura

Aguarde um ciclo de consulta e atualize a página manualmente. Se outras mensagens da mesma caixa aparecerem, o problema provavelmente está em uma mensagem específica ou na entrega upstream, não na conexão da página.

Evidência: horário da atualização e contagem de mensagens

Camada do conteúdo

Quando a lista mostra o assunto, mas os detalhes estão vazios, verifique separadamente html_body e text_body. Um erro no template HTML, um recurso remoto grande demais ou um script perigoso não significa que o e-mail não chegou.

Evidência: assunto, remetente e campos originais do conteúdo

Diagnóstico rápido

Sintomas diferentes exigem prioridades diferentes

Sintoma	Verifique primeiro	Verifique depois
Nenhum e-mail chega	Validade do endereço e tarefa de envio	Resposta do provedor, DNS e limitação de taxa
Apenas um determinado template não chega	Tarefa do template e parâmetros do destinatário	Política de conteúdo e tamanho dos anexos
A mensagem aparece na lista, mas os detalhes estão vazios	Campos HTML/texto simples	Sintaxe do template e isolamento do leitor
A entrega demora claramente	Espera na fila e eventos do provedor	Consulta da caixa e estado da rede

Reprodução mínima

Reduza o fluxo complexo a um e-mail comparável

Envie para um endereço novo usando um assunto fixo, uma frase em texto simples e um identificador de evento exclusivo. Se o e-mail mínimo chegar, adicione novamente HTML, imagens, anexos e variáveis do sistema aos poucos.

Registre também

Ambiente de teste e versão enviada

Por exemplo, staging / commit hash

Horário do disparo e identificador da mensagem

Use UTC de forma consistente ou informe o fuso horário

Endereço, assunto e resultado

Oculte tokens; não cole códigos de verificação em chamados

Voltar ao teste real de recebimento

Crie um endereço limpo e conclua a reprodução mínima

Guarde as evidências deste envio e use uma caixa temporária para conferir o assunto, o horário e o conteúdo.

Abrir e-mail temporário