Cómo añadir el chatbot de IA de Asyntai a Moodle
Guía paso a paso para sitios web de Moodle LMS
Paso 1: Obtén su código de inserción
Primero, ve a su Panel de control de Asyntai y desplácese hasta la sección "Código de inserción". Copie su código de inserción único que se verá así:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Nota: El código anterior es solo un ejemplo. Debe copiar su propio código de inserción único desde su Panel de control ya que contiene su ID de widget personal.
Paso 2: Usar HTML adicional (Recomendado)
Moodle tiene una función integrada para agregar HTML/JavaScript personalizado a todas las páginas:
- Inicia sesión en su sitio Moodle como administrador
- Ve a Site administration
- Navegue a Appearance → Additional HTML
- Desplácese hasta la sección "Before BODY is closed"
- Pegue su código de inserción de Asyntai en el área de texto
- Haga clic en "Save changes"
Consejo: Agregar el código en "Before BODY is closed" lo coloque justo antes de la etiqueta de cierre </body>, que es la ubicación recomendada para widgets de chat y asegura que se cargue después del contenido principal de la página.
Alternativa: Usar la configuración del tema
Muchos temas de Moodle (incluyendo Boost y sus variantes) tienen sus propias configuraciones para agregar JavaScript personalizado:
- Ve a Site administration → Appearance → Themes
- Haga clic en Theme settings para su tema activo (por ejemplo, Boost)
- Busque la sección "Raw SCSS", "Additional HTML" o "Custom JavaScript"
- If there's a JavaScript field, paste your Asyntai embed code there
- Haga clic en "Save changes"
- Purga las caches: Site administration → Development → Purge caches
Nota: Las configuraciones específicas del tema varian entre temas. Si su tema no tiene un campo de JavaScript, use el método de Additional HTML descrito arriba.
Alternativa: Crear un plugin local
Para más control, puede crear un plugin local simple:
- Cree la estructura de carpetas:
local/asyntaichatbot/en su instalación de Moodle - Cree version.php:
<?php
defined('MOODLE_INTERNAL') || die();
$plugin->component = 'local_asyntaichatbot';
$plugin->version = 2024010100;
$plugin->requires = 2022041900; - Cree lib.php:
<?php
defined('MOODLE_INTERNAL') || die();
function local_asyntaichatbot_before_footer() {
global $PAGE;
$PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
} - Cree la carpeta amd/src/ y el archivo 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);
}
};
}); - Reemplaza
YOUR_WIDGET_IDcon su ID de widget real - Ve a Site administration → Notifications para instalar el plugin
- Purga las cachés después de la instalación
Importante: El método de plugin local requiere acceso a la linea de comandos para crear archivos. Para la mayoria de los usuarios, el método de Additional HTML es mas simple y suficiente.
Alternativa: Editar la plantilla del pie de página del tema
You can also edit your theme's footer template directly:
- Navegue a la carpeta de su tema:
theme/YOUR_THEME/ - Encuentra los archivos de layout (por ejemplo,
layout/columns2.phpotemplates/columns2.mustache) - Find the closing
</body>tag or the footer section - Add your Asyntai embed code just before
</body> - Guarde el archivo
- Purga las cachés de Moodle
Importante: Editar archivos del tema directamente significa que los cambios pueden perderse al actualizar su tema. Use un tema hijo o el método de Additional HTML para una solución mas permanente.
Paso 3: Verificar la instalación
Después de guardar sus cambios y purgar las caches, visite su sitio Moodle en una nueva pestana del navegador o en una ventana de incognito. Deberias ver el botón del widget de chat en la esquina inferior derecha. Haga clic en el para asegurarte de que se abra y funciona correctamente.
¿No ves el widget? Asegurate de purgar todas las caches de Moodle: ve a Site administration → Development → Purge all caches. También intenta limpiar la cache del navegador o ver la página en una ventana de incognito. Si estas usando un plugin de cache o un proxy inverso, vacia esas caches también.
Weebly