De códigos a recibos:
como testar modelos de e-mail

Receber não significa passar: diferencie três resultados

“A API de envio aceitou a solicitação”, “o e-mail apareceu na caixa de entrada” e “a pessoa conseguiu usar o e-mail corretamente” são resultados diferentes. A aceitação da solicitação pelo serviço de envio não garante que a mensagem chegou. E, mesmo que tenha chegado, o modelo pode estar incompleto ou aparecer de forma diferente em cada cliente.

Por isso, anotar “o código estava legível por inteiro na prévia do navegador” é mais útil do que dizer genericamente “teste de e-mail aprovado”. Se a mensagem nem apareceu, primeiro use o diagnóstico de entrega de códigos para conferir o endereço, o prazo de validade e os limites de envio. Não confunda um problema de entrega com um problema de layout.

Prepare dois tipos de amostra própria; não teste com usuários reais

Na primeira mensagem, use um código de teste de seis dígitos, como 418752; inclua também o prazo de validade, um aviso de segurança e uma explicação clara da ação. A segunda deve conter número do pedido, nome longo do produto, valor e forma de pagamento, para revelar problemas como tabelas espremidas e campos ausentes. Envie ambas do seu próprio ambiente de teste, usando pedidos fictícios e sem gerar cobranças reais.

Os e-mails de demonstração do PayPal e do Steam na página inicial apenas ilustram como ler esses dois tipos de informação e não têm relação com as marcas. Eles não comprovam que seu sistema de envio entregou as mensagens. Não se passe por essas marcas para enviar e-mails a outras pessoas nem use o layout de demonstração para concluir que os sites correspondentes aceitam endereços temporários.

Defina as condições antes de alterar o modelo

• Identifique a versão do modelo e mantenha fixos o idioma do teste, a configuração de envio e os campos da amostra.
• Anote o endereço de teste e o horário do envio, mas não inclua credenciais de acesso à caixa de entrada no chamado.
• Prepare dados comuns e extremos, como nomes de produtos curtos e longos.
• Guarde as versões HTML e em texto simples geradas pelo sistema de envio para compará-las com o resultado recebido.

Por padrão, o endereço temporário fica ativo por 3 horas. Cada extensão acrescenta mais 3 horas; confira o cronômetro da caixa de entrada. Em testes de regressão prolongados, planeje com antecedência a duração do endereço em vez de esperar que ele expire para concluir que o e-mail se perdeu.

Na primeira mensagem, avalie a ação: é fácil encontrar o código?

O objetivo do layout de um e-mail com código de verificação não é promover a marca, mas facilitar o caminho entre abrir a mensagem e voltar à página de verificação. Comece pelo assunto na lista: dá para distinguir login, cadastro e ações sensíveis? O nome do remetente combina com a ação que a pessoa acabou de realizar? Evite encher o assunto de mensagens promocionais e deixar a ação importante escondida quando ele for cortado.

O código precisa ser fácil de ver e copiar

Use os seis dígitos como texto de verdade, não embutidos em uma imagem. Selecione e copie o código; depois confira se há espaços, quebras de linha ou outros caracteres. O espaçamento visual não deve alterar o código. Teste também uma amostra com zero à esquerda, como 048193 para confirmar que o modelo não trata o código como número e remove o primeiro dígito.

O prazo de validade deve aparecer junto ao código e corresponder à regra real do sistema. Se “válido por 10 minutos” for contado a partir da emissão, quem receber o e-mail com atraso não deve ser levado a pensar que ainda tem dez minutos completos. Quanto ao contexto da ação, mostre apenas informações que você realmente tem; não invente dispositivo, localização ou avaliação de risco.

Por fim, confira o aviso de segurança: não compartilhe o código e explique o que fazer se a solicitação não tiver sido feita pela própria pessoa. Mesmo que o código da captura de tela já tenha expirado, oculte-o antes de compartilhá-la. Quanto mais curta e clara for a orientação do e-mail, menor a chance de a pessoa ignorar as informações que realmente precisa proteger.

Na segunda mensagem, avalie a estrutura: os campos longos continuam associados aos valores corretos?

Testar um e-mail de recibo é como conferir uma fatura. Use o número de pedido fictício STM-6093-2741-58, o nome do produto Hollow Lantern: Deluxe Edition, o valor $14.99 e “saldo da carteira” para verificar se os rótulos permanecem sempre junto dos valores correspondentes. Depois, aumente o número do pedido e veja se a coluna do valor sai da tela.

Confira os dados antes da aparência

Indique claramente a moeda e mantenha as casas decimais de acordo com as regras de cobrança. Se houver impostos, descontos ou reembolsos, o cálculo do total também deve fazer sentido. Não exponha o número completo do cartão nem credenciais de pagamento. Campos opcionais ausentes devem ser omitidos ou receber um status claro, em vez de aparecer como “undefined” ou com um rótulo vazio.

Se o modelo tiver um botão “Ver pedido”, confira no seu sistema de teste o endereço de destino, a quem pertence o pedido e se é necessário fazer login. O botão falso dos e-mails de demonstração não leva a lugar nenhum, então não serve para testar links. A mensagem de confirmação de compra no e-mail também não substitui o status do pedido no sistema de pagamento; em operações reais, consulte os registros do servidor.

Em telas estreitas, não basta reduzir: é preciso conferir a leitura novamente

Comece com uma janela de cerca de 390 px de largura e depois confira em um celular de verdade. Leia na ordem natural: quem enviou, o que aconteceu, onde estão o código ou o valor e qual é o próximo passo. Não olhe apenas a captura da primeira tela; role até o fim da mensagem.

• O número longo do pedido pode quebrar linha dentro do campo, mas não deve cobrir o rótulo nem esconder o valor ao lado.
• O nome do produto pode ocupar várias linhas, mas não deve ser cortado justamente na parte que identifica a versão comprada.
• Se o texto do botão for longo, ele deve quebrar linha naturalmente e continuar dentro da área clicável.
• Mesmo com o texto ampliado, tabelas, explicações e ações devem continuar aparecendo em uma ordem lógica.

A própria caixa de entrada online também tem uma lista e uma área de leitura. Por isso, diferencie um problema de transbordamento do conteúdo do e-mail de um problema na página que o exibe. Apenas estreitar a janela do navegador no computador não simula a substituição de fontes, o redimensionamento automático ou o modo escuro de um aplicativo de e-mail para celular.

O que ainda funciona quando as imagens são desativadas?

Se as imagens não carregarem, o logotipo pode desaparecer, mas o código, o valor e as instruções não. Escreva textos alternativos breves para imagens informativas; use texto alternativo vazio em imagens decorativas, para que leitores de tela não anunciem nomes de arquivos sem sentido. Não coloque informações importantes apenas em imagens de fundo.

Desativar imagens não é o mesmo que testar a versão em texto simples

A versão em texto simples de um e-mail HTML é o conteúdo text/plain enviado junto com a mensagem, não o resultado de o navegador remover as tags HTML. A equipe responsável pelo envio deve conferir as duas versões. Para verificar a estrutura MIME, consulte os registros do seu próprio sistema de envio ou um cliente que permita visualizar a mensagem original.

A versão em texto simples deve manter, no mínimo, a finalidade da ação, o código completo e o prazo de validade ou, no caso do recibo, o número do pedido, o produto, o valor e a forma de pagamento. Os links necessários devem ter contexto suficiente para serem compreendidos. Não escreva apenas “consulte a versão HTML” nem mantenha no texto valores ou prazos antigos que já foram alterados no HTML.

Se a prévia online não permitir desativar imagens nem alternar para a versão em texto, marque esses itens como “não verificados” e conclua o teste em outro ambiente. Uma página com aparência normal não significa que ambos os itens foram aprovados.

Registre o que encontrou, em vez de dizer apenas “está meio apertado”

Um bom registro permite que alguém que não estava presente reproduza o mesmo problema. No mínimo, inclua a versão do modelo, as condições do teste, as características da amostra, o resultado esperado, o resultado observado e evidências com dados anonimizados. Não anexe apenas uma captura de tela sem informações sobre o ambiente.

Classifique o resultado como “aprovado”, “reprovado” ou “não verificado” e indique o escopo. Problemas como conteúdo ausente, valor incorreto ou código inválido têm prioridade sobre diferenças de margem. Depois de corrigir, envie novamente o e-mail; não encerre o problema apenas por ter deixado a página bonita nas ferramentas de desenvolvedor do navegador.

Onde conferir além da prévia online

A prévia online usa o mecanismo de renderização do navegador. Já aplicativos como Gmail, Outlook e Apple Mail tratam HTML, estilos, fontes e imagens de formas diferentes. Recursos de segurança também podem remover scripts, formulários e outros conteúdos perigosos. A ausência deles na prévia não garante compatibilidade com clientes de e-mail.

Monte uma matriz mínima de clientes com base no perfil real das pessoas usuárias: por exemplo, Gmail no navegador e no celular, a versão específica do Outlook no ambiente Windows de destino e Apple Mail no iPhone. Registre as versões do sistema e do aplicativo; não escreva apenas “testado no Outlook”.

Em cada ambiente, confira os modos claro e escuro, as restrições de imagem, o texto ampliado e o funcionamento dos links. Se precisar de acessibilidade, verifique a ordem de leitura com um leitor de tela real. Receber o e-mail em um endereço temporário não significa que passaram nos testes a classificação de spam de outros provedores, a reputação do domínio ou os resultados de autenticação. Entrega e autenticação de envio devem ser verificadas separadamente.

Conclua o teste: encerre cada amostra com clareza

Depois de guardar os registros necessários com dados anonimizados, exclua os e-mails de teste que não forem mais necessários. Excluir uma mensagem não cancela imediatamente o endereço inteiro nem apaga os registros do sistema de envio, os anexos de chamados ou as capturas de tela locais. Cada cópia deve ser tratada de acordo com suas próprias regras de retenção.

Não use endereços temporários em alertas de produção, faturas, recuperação de senha ou scripts de regressão de longo prazo. Se precisar receber mensagens continuamente, avalie um alias de encaminhamento permanentee verifique se ele atende ao seu fluxo. Contas importantes devem continuar vinculadas a um endereço de e-mail que você possa manter sob seu controle.

O resultado final não são duas capturas de tela bonitas, mas um conjunto de condições que pode ser testado novamente: as instruções estão claras? Os dados da transação estão completos? Quais clientes de e-mail já foram testados e quais ainda precisam de validação? Para saber mais sobre credenciais do navegador e limites de uso dos dados, consulte a Política de Privacidade.