Migrar para a Extensão de Novo Usuário

Last Updated dezembro 9, 2025

Breve Visão Geral

  • Em junho de 2024, o Google Chrome e o Microsoft Edge deixarão de oferecer suporte à versão atual da extensão do navegador, baixada pela loja de extensões.
  • Como resultado, o WalkMe criou uma nova versão da extensão (V 4.0.x.x) para esses navegadores que não depende da loja de extensões para implantar.

Novos Benefícios da Extensão

  • Melhor desempenho: lógica de carregamento aprimorada
  • Alternância de ambiente: alternar entre os ambientes de teste e produção na mesma janela do navegador
  • Independência: não há mais dependência da loja de extensões para obter a versão atualizada
  • Processo simplificado: a extensão deve ser implantada em massa

Notas técnicas

  • A nova extensão suporta apenas Chrome e Edge
    • Para implantar em outros navegadores, você usará a versão da loja da extensão
  • A nova extensão não contém um link para baixá-la localmente no navegador de um usuário individual para Chrome e Edge
  • A extensão precisará ser implantada em massa pela equipe de TI do cliente

Processo de migração

Os clientes que implantaram o WalkMe usando a loja de extensões Master Extension no Google Chrome e/ou Microsoft Edge antes de 1º de abril de 2022 precisarão migrar para a nova versão da extensão V4 para esses navegadores.

Observação

O processo de migração para a nova extensão dependerá de como você implantou sua extensão. extensão existente. Consulte o Gerente de Sucesso do Cliente ou o contato do WalkMe se quiser esclarecer se alguma ação de migração é necessária.

1. Instalação manual usando o URL de download da extensão

O que o WalkMe fará?

  • Nenhuma ação necessária

O que o departamento de TI do cliente fará?

  • Reimplantar usando o Guia de Implantação em Massa (MacOS ou Windows) ou o Instalador Tudo em Um (Windows)
  • Opção 1: Guia de Implantação em Massa
    • Windows e MacOS
      • Clique no link e siga as instruções para instalar a nova extensão
  • Opção 2: Instalador Tudo em Um
    • Acesse o Centro de Administração do WalkMe
    • Na página de Instalação, em Extensão WalkMe, clique em Abrir Assistente de Instalação
    • Selecione Windows MSI de 32 bits ou MSI de 62 bits, dependendo das suas necessidades
    • Selecione os navegadores Google Chrome e Edge Chromium
    • Desmarque todos os outros navegadores
    • Clique em Baixar

2. Extensão personalizada hospedada no WalkMe CDN

O que o WalkMe fará?

  • O WalkMe fornecerá um valor EXTENSION_UUID e UPDATE_XML para serem usados para testes no ambiente de teste.
  • Após a confirmação de que o ambiente de teste está funcionando, o WalkMe atualizará a extensão para você
    • Para atualizar, o WalkMe trocará o arquivo de extensão existente hospedado na nuvem para o novo arquivo de extensão. Isso acionará automaticamente a atualização nos navegadores do usuário final.

O que o departamento de TI do cliente fará?

Alguém com permissões de administrador precisará instalar a extensão no ambiente de teste para fins de teste.

  1. Crie um arquivo chamado chrome_install.bat
  2. Insira a seguinte linha no arquivo e salve
    • Reg add "HKEY_LOCAL_MACHINESOFTWAREPoliciesGoogleChromeExtensionInstallForcelist" /v "1" /t REG_SZ /d "EXTENSION_UUID;UPDATE_XML"
  3. Execute o arquivo em lote usando a permissão de administrador (clique com o botão direito do mouse no arquivo e clique em Executar como administrador)
Dica

Substitua EXTENSION_UUID e UPDATE_XML pelos valores fornecidos pelo WalkMe, certificando-se de deixar o ; separando-os.

  • Depois de confirmar que a extensão está funcionando no ambiente de teste, entre em contato com o WalkMe para que eles possam atualizar a extensão no ambiente de produção.
Observação

Você pode desinstalar a extensão no ambiente de teste. Para isso, vá para HKEY_LOCAL_MACHINE → SOFTWARE → Políticas → Google → Chrome → ExtensionInstallForceList e exclua o arquivo.

3. Extensão auto-hospedada

O que o WalkMe fará?

  • O WalkMe fornecerá ao cliente o arquivo CRX e a versão da extensão XML.

O que o departamento de TI do cliente fará?

  • Atualize os arquivos no CDN

4. Extensão implantada em massa por meio da loja de extensões usando o Instalador All in One (AIO) ou o Guia de Implantação em Massa

O que o WalkMe fará?

  • O WalkMe enviará a atualização da extensão V4 para a extensão da loja e atualizará automaticamente a extensão existente do cliente.

O que o departamento de TI do cliente fará?

  • Nenhuma ação necessária
  • Se o cliente quiser um ID de extensão exclusivo, ele precisará reimplantar

5. A TI usou a política normal_installed para instalar uma extensão existente

O que o departamento de TI do cliente fará?

  • Altere normal_installed para force_installed na política de extensão

Perguntas frequentes sobre migração

Pergunta: atualmente eu tenho uma extensão personalizada que é implantada em massa para a maioria dos meus usuários, mas também é baixada manualmente por um grupo menor de usuários. Quando atualizarmos a extensão, ela funcionará para ambos os grupos?

  • Resposta: a Extensão de Usuário WalkMe com a nova tecnologia de manifesto V3 deve ser instalada à força (implantada em massa) para injetar conteúdo WalkMe em sites com cabeçalhos CSP (por exemplo, Salesforce e Workday). Depois que atualizarmos a extensão, ela não funcionará para os usuários que a baixaram manualmente se estiverem usando o WalkMe em sites com cabeçalhos CSP.

Pergunta: existe um número de versão específico (ou mínimo) da extensão que podemos usar para determinar se temos a nova versão da extensão? É possível estar usando um novo número de versão da extensão, mas estar usando a extensão "antiga" errada?

  • Resposta: é possível, embora improvável, se você tiver uma extensão que não esteja vinculada a uma conta de vários sistemas e tenha instalações manuais.

Pergunta: todos os usuários que baixaram manualmente a extensão existente precisam desinstalar a extensão atual do navegador antes de implantar em massa a nova?

  • Resposta: como a extensão implantada em massa é a mesma extensão que os usuários baixaram manualmente (a extensão oficial WalkMe na loja Google), eles não precisam desinstalar.

Was this article helpful?

Thanks for your feedback!
×