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 codigo de incorporacao Asyntai na area 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. If there's a JavaScript field, paste your Asyntai embed code there
  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. Find the closing </body> tag or the footer section
  4. Add your Asyntai embed code just before </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.