Guia do Desenvolvedor: Testando Fluxos de Email de Ponta a Ponta (Cadastro, OTP, Redefinição, Webhooks)
Fluxos de email são críticos para o produto e fáceis de quebrar. Uma única URL errada, token ausente ou problema de entregabilidade pode causar falhas no cadastro ou bloqueios de conta. Este guia fornece um fluxo de trabalho repetível para testes de ponta a ponta.
1) O que testar (checklist principal)
- Renderização do template: desktop + mobile; garantir que botões e texto sejam legíveis.
- Correção dos links: sem links de staging em produção; sem mistura de http/https.
- Lógica do token: expiração funciona; tokens são de uso único quando necessário.
- Política de reenvio: limites de taxa previnem spam e abuso; mensagens para o usuário são claras.
- Localização: idioma correto, formatos de data e suporte RTL se aplicável.
2) Use uma caixa de entrada nova por cenário
Caixas de entrada de teste compartilhadas criam resíduos confusos. Uma caixa de entrada descartável nova por execução de teste mantém os resultados limpos.
Crie uma caixa de correio: TempMailbox
3) Verifique a jornada do usuário, não apenas o email
Para cada fluxo (verificação de cadastro, OTP, redefinição):
- Dispare o email pela interface do produto ou API.
- Confirme o tempo de entrega (meça a latência mediana e de cauda).
- Abra e verifique os destinos dos CTAs (parâmetros de consulta, tokens, comportamento de redirecionamento).
- Confirme os resultados pós-clique (flag de verificado definida, sessão criada, página de sucesso apropriada).
4) Teste casos extremos intencionalmente
- Token expirado (deve falhar graciosamente)
- Clique duplo no link (não deve quebrar o estado)
- Reenvio múltiplo (aplicar cooldown)
- Email errado digitado e depois corrigido (atualizar caminho)
5) Observabilidade: acompanhe as métricas certas
- Taxa de sucesso no envio
- Taxa de rejeição e rejeições do provedor
- Taxa de conclusão da verificação
- Distribuição do tempo para verificar
6) Noções básicas de segurança (não pule)
- Tokens devem ser aleatórios, com escopo e tempo limitado.
- Evite colocar identificadores sensíveis do usuário nas URLs.
- Invalide tokens após o uso quando apropriado.
7) Mantenha o QA ético e seguro
Use caixas de entrada descartáveis para testes legítimos e higiene de privacidade. Não as use para abuso, fraude ou para burlar regras de outros serviços.
