Source: https://once-email.com/pt/blog/email-testing-checklist Testes e engenharia · 2 de ago. de 2026Atualizado 9 de ago. de 2026 # Checklist de testes de e-mail para desenvolvedores: da solicitação à expiração Um plano reproduzível para verificar geração, entrega, conteúdo, links, anexos, acessibilidade e limpeza sem usar dados reais. [Equipe de engenharia do Once Email, Once Email author Equipe de engenharia do Once Email]() Revisado por Revisão editorial do Once Email O que este guia ajuda você a fazer A equipe recebe uma lista reutilizável com evidência mínima, horários UTC e critérios de resultado que reduzem testes instáveis. Guia do artigo Por que vale a pena ler este artigo **Análise original** Dividimos o percurso em eventos observáveis para distinguir defeitos de aplicação, provedor, transporte, renderização e limpeza. **Contexto de tendências** E-mails transacionais combinam mais modelos, localização, links assinados e autenticação, aumentando os pontos de falha. **Valor prático** A equipe recebe uma lista reutilizável com evidência mínima, horários UTC e critérios de resultado que reduzem testes instáveis. Um teste de e-mail confiável não termina quando “alguma mensagem apareceu”. Ele precisa demonstrar que a solicitação correta gerou a mensagem correta, para o destinatário correto, dentro de um limite de tempo conhecido, e que os dados foram removidos ao final. ## [Prepare um caso isolado]() Use uma caixa por execução ou por caso independente. Não reutilize uma caixa compartilhada em jobs paralelos. Gere dados sintéticos e nunca envie senha real, documento pessoal ou informação de cliente para um ambiente de teste. Registre um identificador de correlação seguro no sistema em teste e, se possível, no assunto ou em um cabeçalho não sensível. Defina horário inicial UTC, tempo máximo e condição explícita de sucesso. ## [Verifique solicitação e transporte]() Confirme a resposta da aplicação: status, evento criado e destinatário. Depois consulte a caixa com intervalo crescente e limite total. Esperas fixas curtas produzem falhas intermitentes; consultas agressivas criam carga e podem acionar limites. Ao receber a mensagem, compare destinatário, tipo de evento, identificador e horário. Não selecione apenas “o e-mail mais recente”, pois outra execução pode ter criado uma mensagem semelhante. ## [Revise conteúdo e apresentação]() Valide assunto, remetente visível, versão em texto simples, HTML e idioma. Confirme que variáveis obrigatórias foram substituídas e que dados de outra pessoa não aparecem. Teste texto longo, caracteres acentuados, modo escuro e largura móvel. Links devem usar HTTPS, domínio esperado e parâmetros corretos. Não registre o token completo. Para anexos, verifique nome, tipo declarado, tamanho e comportamento quando ausente ou acima do limite. O [orçamento local de anexos]() ajuda a estimar crescimento por Base64 e MIME. ## [Acessibilidade e segurança]() O conteúdo precisa manter ordem de leitura, títulos coerentes, texto alternativo útil e links compreensíveis fora do contexto. Imagens não devem ser o único meio de transmitir um código ou instrução. Confira SPF, DKIM e DMARC como evidência de autenticação, sem tratá-los como análise de conteúdo. Garanta que links e códigos tenham expiração e que uma nova solicitação invalide o segredo anterior quando esse for o contrato. ## [Expiração, erro e limpeza]() Teste mensagem atrasada, duplicada, ausente e fora de ordem. Verifique o comportamento depois que código e caixa expiram. A aplicação deve apresentar erro compreensível sem revelar segredo ou estado interno desnecessário. No ` finally ` do teste, exclua a caixa e remova artefatos. Guarde apenas resultado, horário, identificador redigido e versão do sistema. A [orientação sobre evidências]() detalha o que não deve ir para logs, tickets ou screenshots. ## [Critério de encerramento]() Um caso passa quando todas as etapas observáveis atendem ao contrato dentro do orçamento. Ele falha com uma causa localizada quando isso não ocorre. “Tentar novamente até funcionar” não é critério: mascara defeitos e torna a suíte impossível de confiar. ## Guias relacionados Como guardar evidências de testes de e-mail sem expor segredos O que manter, o que ocultar e como demonstrar um resultado sem arquivar códigos, links de acesso ou mensagens completas. [Como guardar evidências de testes de e-mail sem expor segredos]() Como usar uma API de e-mail temporário sem criar testes instáveis Projete testes com caixas isoladas, consultas limitadas, tempo máximo, correlação segura e limpeza determinística. [Como usar uma API de e-mail temporário sem criar testes instáveis]() Postfix vs Dovecot: funções diferentes em um servidor de recebimento Entenda onde Postfix, Dovecot, LMTP, fila e IMAP atuam e use evidências para localizar uma falha de entrega. [Postfix vs Dovecot: funções diferentes em um servidor de recebimento]() [Por que o Once Email apenas recebe mensagens por design Entenda o problema que uma caixa temporária resolve, quando não usá-la e por que o Once Email mantém um limite estrito de somente recebimento.]() [Como guardar evidências de testes de e-mail sem expor segredos O que manter, o que ocultar e como demonstrar um resultado sem arquivar códigos, links de acesso ou mensagens completas.]()