Como funciona
Incorporar um bot criado no Toolzz Bots ao Toolzz LXP ajuda a automatizar atendimentos e melhorar a experiência dos usuários dentro da plataforma de aprendizado. Com isso, é possível responder dúvidas frequentes, orientar alunos em tarefas específicas, oferecer suporte em tempo real e facilitar a navegação pelos conteúdos.
Atualmente, existem duas formas de incorporar um bot no LXP:
Incorporação nativa pelo Toolzz LXP
A nova forma de integração foi criada para tornar o processo muito mais simples e rápido. Toda a configuração é feita diretamente dentro do Toolzz LXP, sem necessidade de ferramentas externas ou conhecimentos técnicos avançados.
Incorporação via Google Tag Manager (GTM)
Essa é a forma mais técnica e avançada de incorporação, utilizada anteriormente como padrão. Apesar de exigir um processo maior de configuração via Google Tag Manager, ela também continua disponível e funcionando normalmente.
Passo a passo
1.Incorporação nativa pelo Toolzz LXP
Agora ficou mais fácil incorporar seus bots dentro do Toolzz LXP de forma nativa e sem necessidade de utilizar Google Tag Manager (GTM) ou inserir scripts manualmente.
Na área de Embed do bot, você encontrará um passo a passo completo para realizar a integração diretamente pelo próprio Toolzz LXP, em um processo totalmente no-code e intuitivo.
.gif)
A configuração é feita dentro do LXP, permitindo:
-
Conectar a conta do Toolzz Bots;
-
Selecionar quais bots serão incorporados;
-
Definir permissões e regras de acesso por perfil de usuário;
-
Gerenciar a exibição dos bots dentro do ambiente da plataforma;
Com isso, a incorporação dos bots se torna mais simples, organizada e fácil de administrar. Clique aqui e acesse o tutorial completo.

2.Incorporação via Google Tag Manager (GTM)
Para incorporar um bot no Toolzz LXP através do Google Tag Manager, você precisará seguir algumas etapas. Este artigo vai te mostrar como fazer isso em três partes: primeiro, configurando o embed do Google Tag Manager no Toolzz Bots; depois, criando uma conta, um contêiner e uma tag no Google Tag Manager para obter o ID necessário; e, por fim, integrando esse código na plataforma Toolzz LMS/LXP para que o bot funcione corretamente.
1º passo: com seu bot já configurado e publicado, acesse a página "Embed".

2º passo: clique em "Google Tag Manager" e escolha o modelo de layout que vai utilizar.
Recomendamos que use o layout "Bubble" no Toolzz LMS/LXP.

3º passo: faça as configurações do seu bot.
-
Ative a opção "Visualizar mensagem" para que junto com o ícone de chat do bot seja mostrada uma mensagem e o avatar do bot. Você pode personalizar estes itens inserindo uma URL de imagem e editando a mensagem inicial.
-
Defina se a janela do chat aparecerá em tela cheia ou configure as dimensões da janela do bot.
-
Clique em "Tema" para personalizar o tamanho, a cor e imagem do ícone do bot.
-
Caso você tenha ativado a opção "Visualizar mensagem", também poderá personalizar as cores dos itens "Background", "Cor do texto", "Fechar fundo do botão" e "Fechar cor do ícone".
💡Dica
Você pode ver todas as mudanças realizadas na parte de "Preview".
4º passo: copie o código gerado e guarde. Você vai precisar dele para configurações no Google Tag Manager.
Como criar uma conta e um contêiner no Gooogle Tag Manager?
1º passo: após fazer o login através do link tagmanager.google.com, clique em "Criar uma conta".
2º passo: preencha os formulários.
-
Em "Configuração da conta" dê um nome para sua conta e escolha o país;
-
Em "Configuração do contêiner":
-
No campo "Nome do contêiner" insira a URL da sua instituição Toolzz LMS/LXP. A URL não pode conter https:// e nem as partes que indicam caminhos para a página da plataforma. Por exemplo, na URL https://mariaclaracx.app.toolzz.com.br/manager/gestao/painel/administrador, utilize apenas "mariaclaracx.app.toolzz.com.br".
-
Em "Plataforma segmentada" selecione a opção "Web".
-
Para finalizar, clique em "Criar"e a aceite os termos da plataforma.

Se você já possui uma conta, basta encontra-lá na página de contas, clicar no ícone de três pontos referente a ela e escolher a opção "Criar contêiner".

Em caso de dúvidas, consulte o artigo Criar uma conta e um contêiner da própria Google.
Como criar e publicar uma tag no Google Tag Manager?
As Tags personalizadas do Google Tag Manager (GTM) são como ferramentas que você cria para fazer coisas específicas no seu site. Você pode escrever o código que faz o que você quer e usar uma tag personalizada para adicioná-lo ao seu site. Esses códigos podem ser HTML ou JavaScript, que são linguagens usadas para criar e controlar partes de um site. Em resumo, é uma maneira de personalizar e adicionar funcionalidades extras ao seu site.
1º passo: na página inicial do gerenciador de tags, clique em "Nova Tag", dê um nome de identificação para ela e depois clique em "Configuração da Tag".

2º passo: escolha a opção "HTML personalizado". No campo de texto, cole o código que você copiou após fazer as configurações do módulo "Google Tag Manager" no Toolzz Bots.
Clique no checkbox da opção "Suporte para document.write"

3º passo: role a página e clique em "Acionamento".
Basicamente, os acionadores dizem ao Google Tag Manager em que momento ou em qual situação uma tag deve ser executada como, por exemplo, quando alguém visita uma página específica, clica em um botão, ou envia um formulário. Sem um acionador, a tag não saberia quando entrar em ação.
Neste artigo vamos ensinar como definir o acionamento para todas as páginas. Para isso, clique no ícone de olho da opção "All pages" para selecionar a opção e depois no botão "Adicionar".
Caso tenha dúvidas, ou queira fazer configurações avançadas de acionadores, consulte os artigos Sobre os acionadores e Tipos de acionador.

4º passo: para finalizar esta etapa, clique em "Salvar".

5º passo: com a tag criada, clique no botão "Enviar", localizado no canto superior direito da tela.

6º passo: dê um nome para identificar esta versão e depois clique no botão "Publicar".

7º passo: retorne ao espaço de trabalho e copie o ID Google Tag Manager gerado. Você vai precisar dele para fazer as configurações no Toolzz LMS/LXP.

Em caso de dúvidas, consulte o artigo Adicione tags no Gerenciador de tags do Google e Verifique e publique tags da própria Google.
Como inserir o código do Google Tag Manager no Toolzz LXP?
1º passo: acesse o menu lateral clicando no ícone com três traços, localizado no canto superior esquerdo da tela. Clique na opção "Configurações" e depois escolha o item "Integrações".

2º passo: role a página para baixo até localizar o campo "Google Analytics/Tag Manager".
Cole o seu código ID Google Tag Manager no campo "ID Google Tag Manager", retirado da página do Google Tag Manager, clique em "Salvar dados" e depois clique em "OK" na mensagem de confirmação.

Pronto! Agora você já sabe como incorporar um bot no Toolzz LXP.