Antes de começar, estabeleça uma linha de base clara
Prepare o ambiente-alvo, acesso aos logs de envio e um novo endereço de e-mail para testes. Não use nomes de clientes reais, documentos de identidade, dados de pagamento ou códigos de verificação de produção. Se o fluxo criar uma conta, confirme primeiro se você tem autorização para removê-la depois.
O prazo restante do endereço deve cobrir toda a rodada de testes. Se o site-alvo não aceitar e-mails temporários, interrompa este fluxo e use um endereço de longa duração sob seu controle ou o mecanismo de teste indicado pela plataforma.
Copie o endereço completo e confirme o ambiente
Copie o endereço da caixa de entrada temporária e confira se não há espaços no prefixo, antes do @ ou no domínio. Informe-o na página de cadastro e confirme que está usando o ambiente de teste ou pré-produção esperado.
Registre o endereço de recebimento e o horário de início desta rodada. Não alterne endereços em várias abas do navegador ao mesmo tempo: o código pode acabar indo para uma caixa que você já não está consultando.
Dispare uma única vez e confira o envio
Depois de enviar o cadastro ou solicitar o código de verificação, anote o horário e a mensagem exibida na página. A confirmação de “envio realizado” pode significar apenas que a tarefa entrou na fila, não que o e-mail chegou.
Se tiver acesso aos logs, confira o endereço do destinatário, o status da tarefa, o identificador da mensagem retornado pelo serviço de envio e o resultado do SMTP. Se a própria solicitação falhou, resolva primeiro o erro da requisição ou o limite de envios; não atribua o problema à caixa de entrada.
Confirme o e-mail recebido na caixa de entrada
A lista de mensagens é atualizada automaticamente, mas você também pode atualizá-la manualmente. Confira o assunto, o remetente e o horário de recebimento para confirmar que a mensagem corresponde à solicitação recém-feita, e não a um código antigo.
Se o e-mail não chegar, confira se o aplicativo ainda está apontando para o ambiente de testes de e-mail e se os logs de entrega registram rejeição, fila ou devolução. Aguarde um tempo razoável e só então siga as regras de reenvio do sistema. Evite reenviar várias vezes seguidas para não confundir os códigos.
Informe o código mais recente e confira a mudança de status
Use o código válido da solicitação mais recente e confirme que o status do cadastro mudou de pendente para verificado. Depois da mensagem de sucesso, confira a sessão e os dados do usuário; não considere a operação concluída apenas porque houve um redirecionamento.
Dentro do escopo autorizado do teste, verifique também códigos incorretos, expirados e enviados mais de uma vez. O resultado esperado é uma mensagem de erro clara, sem exposição excessiva de informações da conta e sem permitir o uso repetido de um código de uso único.
Remova os dados de teste e guarde evidências sem informações sensíveis
Exclua ou desative a conta de teste e limpe a fila e os registros de teste conforme as regras da equipe. Se precisar manter a conta, troque o endereço temporário por um e-mail de longa duração sob seu controle antes que ele expire e verifique o novo endereço.
No relatório do problema, inclua apenas os horários necessários, a categoria do erro e identificadores sem dados pessoais. Não compartilhe links completos de acesso, códigos ainda válidos nem credenciais da caixa de e-mail.
Deixe o próximo colega reproduzir o teste
Cada registro deve corresponder a uma solicitação de envio. Anote separadamente o envio, o recebimento e a verificação. A tabela abaixo é um modelo, não contém dados de testes reais nem indica um prazo fixo para a chegada dos e-mails.
| Item | O que registrar | Como ajuda na investigação |
|---|---|---|
| Ambiente e versão | Pré-produção / número da versão / caminho da página | Evita misturar resultados de ambientes diferentes |
| Solicitação de envio | Horário do disparo, endereço mascarado do destinatário, identificador da solicitação | Ajuda a confirmar se o aplicativo realmente iniciou o envio |
| Resultado da entrega | Na fila / aceito pelo serviço / rejeitado / devolvido | Distingue falha no envio de uma mensagem ainda em espera |
| Resultado do recebimento | Horário de recebimento, assunto, domínio do remetente | Relaciona o e-mail a uma solicitação específica |
| Resultado da verificação | Sucesso / expirado / não corresponde; não registre o código | Confirma se o status da verificação corresponde ao status do e-mail |
Não recebeu o e-mail de teste? Verifique estas três etapas
A solicitação não foi enviada
Confira a validação do formulário, os erros da API e os limites de frequência de envio. Se o aplicativo não criou uma tarefa de envio, trocar o endereço de recebimento geralmente não resolve o problema.
O serviço ainda não entregou o e-mail
Confira a fila e o resultado do SMTP. Uma mensagem devolvida e uma rejeição temporária são situações diferentes; verifique a categoria do erro antes de tentar novamente.
O e-mail chegou, mas a verificação falhou
Confira a conta, a solicitação e a validade associadas ao código. Após um reenvio, o código anterior pode deixar de valer. Não confunda uma falha na validação do cadastro com um e-mail que não chegou.