Autoria Virtual Agent conversas para localização

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 1 min. de leitura
  • Use métodos de localização em seus scripts Virtual Agent para garantir que o conteúdo possa ser traduzido. Os métodos de localização são projetados para mostrar o texto original quando nenhuma tradução for encontrada. Esses métodos podem ser aplicados ao seu código antes de criar traduções.

    Método de localização para conteúdo de mensagem

    O método gs.getMessageLang verifica a tabela Mensagem [sys_ui_message] em busca de uma versão traduzida do texto no idioma selecionado para o usuário atual. Se uma versão traduzida não for encontrada, o idioma padrão (inglês) será retornado.

    Este código fornece uma saudação que adiciona dinamicamente o valor da variável first_name.

    (function execute() {
            return 'Hi there ' + vaInputs.first_name;
    })()

    O exemplo a seguir mostra esse mesmo código reescrito para localização.

    (function execute() {
             return gs.getMessageLang('Hi there {0}', vaContext.getRequesterLang()), [vaInputs.first_name]);
    })()

    O segundo exemplo usa o método gs.getMessageLang. O texto é o mesmo do exemplo anterior, mas o formato foi alterado. O número entre colchetes atua como um espaço reservado para a variável, que é listada em uma matriz após a vírgula: [vaInputs.first_name]. O método gs.getMessageLang pesquisa um registro na tabela Mensagem com um valor de chave correspondente a Hi there {0} e um valor de idioma correspondente ao idioma do solicitante. O método retorna a versão traduzida do texto, que é armazenada no campo Mensagem do registro.

    Nota:
    Os valores de idioma usam códigos de idioma de dois caracteres padrão ISO. Para obter mais informações, consulte os códigos de idioma ISO 639.1.
    Figura 1. Exemplo de registro de tradução na tabela Mensagem
    Um registro de tradução na tabela Mensagem exibe a coluna Chave, o idioma, a mensagem traduzida e a data em que o registro foi atualizado.
    Nota:
    O conteúdo é traduzido somente para tópicos publicados. O conteúdo não aparece traduzido ao visualizar tópicos não publicados.