Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

Como Adicionar o Chatbot de IA Asyntai ao Moodle

Guia passo a passo para sites Moodle LMS

Obter Código de Incorporação

Passo 1: Obtenha Seu Código de Incorporação

Primeiro, acesse seu Dashboard Asyntai e role para baixo até a seção "Embed Code". Copie seu código de incorporação exclusivo que se parecerá com isto:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Nota: O código acima é apenas um exemplo. Você deve copiar seu próprio código de incorporação exclusivo do seu Dashboard, pois ele contém seu ID de widget pessoal.

Etapa 2: Usando HTML Adicional (Recomendado)

O Moodle possui um recurso integrado para adicionar HTML/JavaScript personalizado a todas as páginas:

  1. Faça login no seu site Moodle como administrador
  2. Vá para Site administration
  3. Navegue até Appearance → Additional HTML
  4. Role para baixo até a seção "Before BODY is closed"
  5. Cole seu código de incorporação Asyntai na área de texto
  6. Clique em "Save changes"

Dica: Adicionar o código em "Before BODY is closed" posiciona-o logo antes da tag de fechamento </body>, que é o posicionamento recomendado para widgets de chat e garante que carregue após o conteúdo principal da página.

Alternativa: Usando Configurações do Tema

Muitos temas do Moodle (incluindo o Boost e suas variantes) possuem suas próprias configurações para adicionar JavaScript personalizado:

  1. Vá para Site administration → Appearance → Themes
  2. Clique em Theme settings do seu tema ativo (ex.: Boost)
  3. Procure a seção "Raw SCSS", "Additional HTML" ou "Custom JavaScript"
  4. Se houver um campo de JavaScript, cole seu código de incorporação do Asyntai lá
  5. Clique em "Save changes"
  6. Limpe os caches: Site administration → Development → Purge caches

Nota: As configurações específicas do tema variam entre os temas. Se o seu tema não possui um campo de JavaScript, use o método de HTML Adicional acima.

Alternativa: Criando um Plugin Local

Para mais controle, você pode criar um plugin local simples:

  1. Crie a estrutura de pastas: local/asyntaichatbot/ na sua instalação do Moodle
  2. Crie version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. Crie lib.php:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. Crie a pasta amd/src/ e o arquivo loader.js:
    define([], function() {
      return {
        init: function() {
          var script = document.createElement('script');
          script.async = true;
          script.src = 'https://asyntai.com/static/js/chat-widget.js';
          script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
          document.body.appendChild(script);
        }
      };
    });
  5. Substitua YOUR_WIDGET_ID pelo seu ID de widget real
  6. Vá para Site administration → Notifications para instalar o plugin
  7. Limpe os caches após a instalação

Importante: O método de plugin local requer acesso por linha de comando para criar arquivos. Para a maioria dos usuários, o método de HTML Adicional é mais simples e suficiente.

Alternativa: Editar Template de Rodapé do Tema

Você também pode editar diretamente o template de rodapé do seu tema:

  1. Navegue até a pasta do seu tema: theme/YOUR_THEME/
  2. Encontre os arquivos de layout (ex.: layout/columns2.php ou templates/columns2.mustache)
  3. Encontre a tag de fechamento </body> ou a seção do rodapé
  4. Adicione seu código de incorporação Asyntai logo antes da tag de fechamento </body>
  5. Salve o arquivo
  6. Limpe os caches do Moodle

Importante: Editar arquivos de tema diretamente significa que as alterações podem ser perdidas ao atualizar seu tema. Use um tema filho ou o método de HTML Adicional para uma solução mais permanente.

Passo 3: Verifique a Instalação

Após salvar suas alterações e limpar os caches, visite seu site Moodle em uma nova aba do navegador ou em uma janela anônima. Você deverá ver o botão do widget de chat no canto inferior direito. Clique nele para verificar se abre e funciona corretamente.

Não está vendo o widget? Certifique-se de limpar todos os caches do Moodle: vá para Site administration → Development → Purge all caches. Também tente limpar o cache do navegador ou visualizar em uma janela anônima. Se estiver usando um plugin de cache ou proxy reverso, limpe esses caches também.