Como Adicionar o Chatbot de IA Asyntai ao Moodle
Guia passo a passo para sites Moodle LMS
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:
- Faça login no seu site Moodle como administrador
- Vá para Site administration
- Navegue até Appearance → Additional HTML
- Role para baixo até a seção "Before BODY is closed"
- Cole seu codigo de incorporacao Asyntai na area de texto
- 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:
- Vá para Site administration → Appearance → Themes
- Clique em Theme settings do seu tema ativo (ex.: Boost)
- Procure a seção "Raw SCSS", "Additional HTML" ou "Custom JavaScript"
- If there's a JavaScript field, paste your Asyntai embed code there
- Clique em "Save changes"
- 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:
- Crie a estrutura de pastas:
local/asyntaichatbot/na sua instalação do Moodle - Crie version.php:
<?php
defined('MOODLE_INTERNAL') || die();
$plugin->component = 'local_asyntaichatbot';
$plugin->version = 2024010100;
$plugin->requires = 2022041900; - Crie lib.php:
<?php
defined('MOODLE_INTERNAL') || die();
function local_asyntaichatbot_before_footer() {
global $PAGE;
$PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
} - 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);
}
};
}); - Substitua
YOUR_WIDGET_IDpelo seu ID de widget real - Vá para Site administration → Notifications para instalar o plugin
- 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:
- Navegue até a pasta do seu tema:
theme/YOUR_THEME/ - Encontre os arquivos de layout (ex.:
layout/columns2.phpoutemplates/columns2.mustache) - Find the closing
</body>tag or the footer section - Add your Asyntai embed code just before
</body> - Salve o arquivo
- 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.
Weebly