Como ativar a alternância automática para vários idiomas

Last Updated dezembro 10, 2025

Breve Visão Geral

O método de alternância automática é a maneira recomendada de implementar o WalkMe Multi-Language em seu site ou plataforma. Esse método envolve a detecção de uma variável de idioma pelo WalkMe em seu site para determinar em qual idioma o texto do WalkMe deve aparecer.

As etapas a seguir guiam você pela implementação da alternância automática.

Você sabia disso?

A partir de novembro de 2024, você pode selecionar facilmente como deseja que o WalkMe identifique o idioma do site por meio da guia Vários idiomas nas configurações do sistema da Central de administração.

Como funciona

1. Encontre sua variável de idioma

Em sites externos, você deve implementar a função JavaScript walkme_get_language em seu site, e essa função retornará o(s) identificador(es) personalizado(s) de idioma especificado(s) em admin.walkme.com durante a configuração inicial do idioma.

Para implementar a função walkme_get_language, primeiro você deve ter uma variável de idioma no nível da janela que detecte o idioma do usuário final. Pergunte à sua equipe de TI o seguinte:

  • Nome da variável de idioma
  • Saídas de variáveis de idioma
Observação

  • O identificador personalizado só pode conter caracteres alfanuméricos (letras e números) e hífens
  • Consulte o seguinte artigo para obter mais informações: Multilíngue

2. Crie seu código multilíngue

  1. Copie o seguinte código para um editor de texto:
    • Observação: O texto destacado deve ser substituído pelos seus próprios valores
    • <script type="text/javascript">
      window.walkme_get_language = function (){
      if (window.langCode)
      {
      if (window.langCode == 'EN') {
      return '';
      }
      else if (window.langCode == 'FR') {
      return 'FR';
      }
      else {
      return '';
      }
      }
      }
      </script>
      
  2. Altere o nome da variável de idioma (no exemplo acima é ) para o nome da variável de idioma criado pela equipe de TI
    • Usaremos como nome da variável da nossa equipe de TI ao longo deste exemplo
    • O resultado é o seguinte:
      <script type="text/javascript">
      window.walkme_get_language = function (){
      if (window.langvar)
  3. Defina o idioma padrão:
    Onde o exemplo acima diz o seguinte:

if (window.langCode == 'PT') {
return '';
}

altere-o para isto:

if (window.langvar == 'PT') {
return '';
  • Altere a saída da variável para qualquer idioma definido como padrão (neste exemplo, Inglês (EN) é o idioma padrão)
  • A função de retorno deve ficar em branco para o idioma padrão ou ser o Language Custom Identifier encontrado na guia ACCOUNT do insights.walkme.com
  • Adicionar idiomas alternativos:
    • Repita o processo acima (para EN, neste caso) com cada idioma alternativo para o qual você deseja traduzir
    • Para o nosso exemplo, adicionaremos 'FR' como idioma alternativo - ele ficará assim:
      else if (window.langvar == 'FR') {
      retorno 'FR';
      }
      else {
      return '';
      }
      
  • O resultado final deve ser parecido com este:

    <script type="text/javascript">
    window.walkme_get_language = function (){
    if (window.langvar)
    {
    if (window.langvar == 'EN') {
    return '';
    }
    else if (window.langvar == 'FR') {
    return 'FR';
    }
    else {
    return ''
    }
    }
    }
    </script>
    

    3. Adicione o código multilíngue ao seu site

    1. Copie o código concluído
    2. Abra a tag principal do seu site
    3. Cole o código multilíngue em cada página

    Para funcionar corretamente, o código Multi-Language deve ser colocado na tag de cabeçalho de cada página na qual o WalkMe aparecerá.

    Notas técnicas

    • Se uma opção manual tiver sido adicionada ao menu WalkMe, a seleção manual substituirá a opção automática e não funcionará
    • Para aplicações normais, não de página única
      • A função de idioma deve ser declarada antes do trecho do WalkMe em cada página
      • Não defina walkme_get_language() na página de login
    • Para aplicativos de página única
      • Use o WalkMeAPI.changeLanguage() na janela principal

    Was this article helpful?

    Thanks for your feedback!

    Faça parte de algo maior.

    Interaja com colegas, tire dúvidas e compartilhe ideias.

    Explore nossa comunidade
    ×