Tutoriais
Token de teste da Chrome Email Verification API expira em 17 de novembro de 2026: como testar o fallback por e-mail?
Este guia ajuda desenvolvedores e QA a identificar se o token antigo do Origin Trial precisa ser renovado e redeployado. Você também encontrará um roteiro temporal para testar o caminho da API, o fallback por e-mail e o fechamento do estado da conta sem confundir evidências.
Sintoma: o fluxo de verificação funcionava, mas você recebeu um aviso de vencimento do token ou não sabe se o site ainda envia a confirmação tradicional.
Adequado se você participa do Origin Trial: primeiro confirme se o token do seu site pertence ao grupo antigo; se pertencer, renove-o pelo processo oficial e faça o redeploy. Mesmo com a API funcionando, teste à parte o fallback por e-mail: verificar o controle do endereço não prova que uma mensagem foi entregue.
Este guia é para você que mantém um site próprio no Origin Trial, valida cadastro ou recuperação de conta como QA, ou separa ambientes de teste e pré-produção como desenvolvedor independente. Se você não participa do teste, a data de vencimento do token não basta para concluir que precisa alterar seu fluxo.
Atualizado em 27 de outubro de 2026. As informações sobre o vencimento e o estado do teste foram conferidas na documentação oficial de Email Verification e na atualização oficial de outubro de 2026.
Primeiro, identifique se o seu token está no grupo afetado
A documentação do Chrome informa que o Email Verification continua em Origin Trial. Ela especifica que os tokens existentes registrados antes da prorrogação do teste vencem em 17 de novembro de 2026 e precisam ser renovados e implantados novamente. Isso não significa que todos os tokens de todos os sites vençam nessa data. Confira a explicação oficial sobre o estado do teste e o token antigo antes de agir.
Não decida apenas pelo domínio ou pelo fato de a funcionalidade estar ativa no navegador. Relacione o token ao registro do Origin Trial da sua aplicação e ao ambiente em que ele é usado. Uma configuração de produção pode ser diferente da configuração de homologação; uma pode estar usando o token antigo enquanto a outra já tem um registro distinto.
Faça este levantamento antes de pedir uma renovação:
- [ ] Identifique a origem exata em que o recurso está habilitado.
- [ ] Localize o registro do Origin Trial associado a essa origem e confira quando ele foi criado.
- [ ] Verifique qual token está efetivamente configurado no ambiente, sem presumir que o valor do arquivo local foi publicado.
- [ ] Separe produção, pré-produção e desenvolvimento. Anote quais páginas e grupos de usuários podem chegar ao fluxo experimental.
- [ ] Consulte o estado atual e os requisitos no guia oficial de Origin Trials.
Esse inventário reduz um erro comum: renovar um token sem confirmar onde o site o entrega, ou concluir que a API está indisponível quando o problema é uma diferença entre ambientes. O registro e a política do Origin Trial são uma questão; o envio de e-mail da aplicação é outra. Trate-os como configurações independentes.
Quando expiram os tokens antigos do Origin Trial?
O prazo informado para os tokens existentes registrados antes da prorrogação é 17 de novembro de 2026. A data deve ser aplicada a esse grupo descrito pela documentação, não generalizada para qualquer token ou participante. Se você não consegue confirmar a data do registro, verifique o token e o estado do teste nas páginas oficiais antes de alterar a implantação.
Também não extrapole essa informação para prever quando o Origin Trial terminará ou se a API será lançada de forma geral. A data de vencimento indicada para tokens antigos não confirma uma decisão futura sobre a disponibilidade do recurso.
Antes da renovação, registre o comportamento atual
Antes de mudar qualquer token, capture como o sistema se comporta hoje. Você precisa saber quais condições iniciam a verificação pela API, quais conduzem ao fluxo tradicional e qual estado a aplicação grava ao final. Sem essa referência, uma regressão pode parecer corrigida porque a interface exibiu uma mensagem, mesmo que o usuário não tenha concluído a validação.
Registre o comportamento observado, não apenas o que o código deveria fazer:
- qual ação do usuário inicia a verificação;
- se o ambiente entrega um token de Origin Trial na resposta conforme a integração documentada;
- qual resultado a aplicação interpreta como verificação concluída;
- em que casos a aplicação solicita confirmação tradicional por e-mail;
- qual evidência confirma que a conta mudou para o estado esperado.
Inclua o fluxo de cadastro e, se ele compartilhar a mesma lógica, o de recuperação de conta. Não misture os dois em um único caso de teste: uma alteração de token pode afetar a criação de contas sem afetar a recuperação, ou o contrário.
A documentação para implementar o verificador ajuda a conferir a separação entre a resposta do processo de verificação e o tratamento feito pelo site. Use-a para revisar sua integração; não deduza que uma resposta válida equivale à entrega de um e-mail.
Renove pelo processo oficial e publique a configuração atualizada
Se a conferência indicar que o token pertence ao grupo afetado, siga o procedimento de registro e renovação apresentado nas páginas oficiais naquele momento. Não copie um token de outro ambiente nem infira sua validade a partir de uma data que não esteja associada ao registro da sua origem. A elegibilidade e as etapas aplicáveis dependem das instruções oficiais vigentes.
Depois de obter a configuração atualizada, faça o redeploy do ambiente que atende à origem correspondente. A orientação oficial exige renovar o token antigo e implantá-lo novamente; salvar o valor apenas no painel ou no repositório não demonstra que a resposta recebida pelo navegador já mudou. Confira a documentação de troubleshooting de Origin Trials se o navegador continuar indicando falha.
Na validação pós-implantação:
- confira a origem e o ambiente usados pelo teste;
- confirme que a resposta efetiva do site contém a configuração atualizada segundo a integração documentada;
- repita o caso em um navegador e contexto compatíveis com o público que você pretende testar;
- inspecione logs e erros de console sem registrar tokens ou endereços pessoais desnecessariamente;
- compare o resultado com o registro feito antes da renovação.
Depois de renovar o token, o site precisa de novo deploy?
Sim. Para os tokens antigos abrangidos pelo aviso, a orientação oficial é renovar e fazer o redeploy. A alteração só deve ser considerada validada quando o ambiente servido já usa a configuração atualizada e o caso de teste confirma o comportamento esperado. Um token renovado que ainda não chegou à resposta do ambiente não prova que a implantação foi concluída.
Se você publica por etapas, verifique cada destino separadamente. Um deploy para pré-produção não atualiza automaticamente produção, e uma configuração de desenvolvimento não comprova o comportamento de uma origem pública. Registre qual versão foi publicada em cada ambiente, sem reutilizar evidências de um ambiente para aprovar outro.
Compare as rotas pela evidência que cada uma produz
A tabela a seguir separa as rotas que precisam de validação. O objetivo não é escolher uma delas e ignorar as demais: a verificação experimental e a confirmação por mensagem respondem a perguntas diferentes.
| Rota ou condição | O que você valida | Evidência necessária | O que não comprova |
|---|---|---|---|
| Token ativo e caminho da API disponível | O tratamento da verificação pelo navegador e pela aplicação | Resultado recebido pela aplicação e estado final da conta | Que um e-mail foi enviado ou recebido |
| Token ausente ou indisponível | A decisão da aplicação de entrar no fluxo tradicional | Solicitação de confirmação apresentada e evento de envio registrado | Que a mensagem chegou à caixa de entrada |
| Falha na verificação | O tratamento de erro e a continuidade do cadastro ou da recuperação | Falha observável, transição para o fluxo previsto e estado da conta | Que a interface exibiu a mensagem correta, sem concluir o processo |
| Confirmação tradicional por e-mail | O recebimento e o uso do link da aplicação | Mensagem real recebida, destino correto e mudança do estado da conta | Que a API funcionou no caso de token ativo |
Essa separação evita declarar “verificação aprovada” com base em um único sinal. A aplicação pode receber um resultado de verificação, mas ainda ter um erro ao persistir a conta. Também pode registrar a tentativa de envio de uma mensagem sem que ela chegue ao endereço de teste.
Teste a ausência do token e o fallback tradicional
Quando a API não retorna um token, como confirmar que o fallback funciona?
Não dependa apenas do texto exibido na página. No ambiente de teste autorizado, execute um caso em que o token não esteja disponível e confirme que a aplicação realmente seleciona o fluxo tradicional. A documentação de Email Verification descreve o fallback para a confirmação existente quando não há token ou quando a etapa de verificação falha. Sua aplicação ainda precisa implementar e demonstrar esse caminho.
Siga uma sequência que permita localizar a falha:
- [ ] Prepare uma conta de teste e registre o estado inicial.
- [ ] Use uma configuração controlada em que a rota experimental não esteja disponível, sem interferir em usuários reais.
- [ ] Inicie o cadastro ou a ação de recuperação pela interface normal.
- [ ] Confirme nos eventos da aplicação que a condição de fallback foi acionada, não apenas que apareceu uma mensagem na tela.
- [ ] Verifique que a solicitação da mensagem foi criada para o ambiente esperado.
- [ ] Abra a caixa de teste, confirme o recebimento e confira se o link aponta para a origem correta.
- [ ] Use o link e verifique no estado da conta se a ação foi concluída.
- [ ] Repita com uma falha de verificação controlada, quando a implementação permitir testar esse cenário com segurança.
O resultado útil é uma cadeia de evidências: condição sem token, decisão de fallback, tentativa de envio, recebimento real, uso do link e estado final. Se qualquer etapa faltar, registre exatamente onde o fluxo parou. “O servidor aceitou a solicitação” e “a caixa recebeu a mensagem” não são a mesma afirmação.
Para não expor dados pessoais, use endereços de teste dedicados e contas fictícias nos ambientes de desenvolvimento e pré-produção. Não encaminhe mensagens de teste a colegas sem necessidade e não coloque tokens, links de confirmação ou dados de usuários em capturas de tela compartilhadas. Se a mensagem inclui um endereço ou identificador pessoal, minimize o conteúdo armazenado nos logs.
Se a API confirmar o endereço, ainda é necessário testar o e-mail?
Sim, se o seu produto mantém o e-mail tradicional como fallback. A verificação pelo navegador pode confirmar controle do endereço dentro do fluxo experimental, mas não prova entrega de mensagem. Teste a caixa de recebimento e a conclusão pelo link separadamente. Essa distinção também importa para recuperação de conta, notificações e qualquer fluxo que dependa de mensagem enviada pela própria aplicação.
Use um endereço de teste que você controla e que seja apropriado para o ambiente. Verifique o conteúdo recebido, o ambiente indicado no link e o resultado após a ação. Se você optar por um endereço temporário para uma validação pontual, confira antes as condições atuais de disponibilidade e retenção do serviço escolhido. Não presuma que um endereço temporário continuará acessível para uma recuperação posterior; para contas importantes ou testes que exigem resposta e histórico, prefira uma caixa duradoura sob controle da equipe.
No caso do EmailSaw, trate a caixa temporária como uma opção de teste, não como componente da API nem como garantia de entrega. Consulte as informações do serviço sobre disponibilidade do endereço e retenção antes de usá-lo. A validação de entrega deve se basear no recebimento observado no endereço escolhido, não em uma promessa de desempenho.
Feche a regressão com evidências separadas
Antes da publicação, mantenha um registro curto por ambiente. Evite resumir todos os resultados como “e-mail validado”; isso esconde se você testou o token, o fallback ou a caixa de entrada.
- [ ] Token: registre a origem, o ambiente, o estado conferido e se a configuração atualizada chegou à resposta servida.
- [ ] Rota experimental: registre o caso autorizado em que o token está disponível e o resultado processado pela aplicação.
- [ ] Fallback: registre o caso sem token ou com falha e a decisão tomada pelo sistema.
- [ ] Mensagem: registre se o endereço controlado recebeu a confirmação e se o link apontava ao ambiente correto.
- [ ] Conta: registre o estado inicial e o estado final depois da ação, sem incluir dados pessoais além do necessário.
- [ ] Publicação: confirme que a configuração implantada corresponde ao ambiente que passou pela regressão.
Aprovar uma linha não aprova as outras. Por exemplo, a API pode passar enquanto o envio de e-mail está quebrado; o e-mail pode chegar enquanto a aplicação não atualiza o estado da conta. Mantenha os critérios de aceite distintos para que uma mudança de token não masque um defeito antigo do fluxo tradicional.
Revise a situação oficial do Origin Trial e a implantação antes de liberar a alteração. Se a documentação mudar, se o registro de token for renovado ou se a aplicação alterar o fallback, execute novamente os casos afetados. A data de 17 de novembro de 2026 se refere aos tokens antigos especificados pela documentação, não a uma garantia sobre futuras políticas do teste.
Para um teste pontual de cadastro, um endereço temporário pode evitar expor sua caixa principal e ajuda a manter as mensagens de QA fora do correio de trabalho. Se você escolher o EmailSaw, confira primeiro as regras atuais de uso e retenção e confirme o recebimento real; mantenha uma caixa duradoura para contas que exijam recuperação futura. O endereço de teste serve para observar o fallback da sua aplicação — não substitui a verificação do Chrome nem prova, sozinho, que o fluxo completo foi aprovado.
Escolha por quanto tempo precisa de contato antes de abrir uma caixa de entrada
O EmailSaw oferece e-mail temporário e encaminhamento por alias para separar testes rápidos de contatos que precisam continuar ativos.