Volver al panel

Documentación

Aprende a usar Asyntai

Cómo añadir el chatbot de IA de Asyntai a Moodle

Guía paso a paso para sitios web de Moodle LMS

Obtener código de inserción

Paso 1: Obtén su código de inserción

Primero, ve a tu Panel de control de Asyntai y desplázate hasta la sección "Código de inserción". Copia tu 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:

  1. Inicia sesión en su sitio Moodle como administrador
  2. Ve a Site administration
  3. Navegue a Appearance → Additional HTML
  4. Desplácese hasta la sección "Before BODY is closed"
  5. Pegue su código de inserción de Asyntai en el área de texto
  6. Haga clic en "Save changes"

Consejo: Agregar el código en "Before BODY is closed" lo coloca 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:

  1. Ve a Site administration → Appearance → Themes
  2. Haga clic en Theme settings para su tema activo (por ejemplo, Boost)
  3. Busque la sección "Raw SCSS", "Additional HTML" o "Custom JavaScript"
  4. Si hay un campo de JavaScript, pega tu código de incrustación de Asyntai ahí
  5. Haga clic en "Save changes"
  6. 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:

  1. Cree la estructura de carpetas: local/asyntaichatbot/ en su instalación de Moodle
  2. Cree version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. Cree lib.php:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. 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);
        }
      };
    });
  5. Reemplaza YOUR_WIDGET_ID con su ID de widget real
  6. Ve a Site administration → Notifications para instalar el plugin
  7. Purga las cachés después de la instalación

Importante: El método de plugin local requiere acceso a la línea de comandos para crear archivos. Para la mayoría de los usuarios, el método de Additional HTML es más simple y suficiente.

Alternativa: Editar la plantilla del pie de página del tema

También puedes editar directamente la plantilla del pie de página de tu tema:

  1. Navegue a la carpeta de su tema: theme/YOUR_THEME/
  2. Encuentra los archivos de layout (por ejemplo, layout/columns2.php o templates/columns2.mustache)
  3. Busca la etiqueta de cierre </body> o la sección del pie de página
  4. Agrega tu código de incrustación de Asyntai justo antes de </body>
  5. Guarde el archivo
  6. 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 más permanente.

Paso 3: Verificar la instalación

Después de guardar sus cambios y purgar las cachés, visite su sitio Moodle en una nueva pestaña del navegador o en una ventana de incógnito. Debería ver el botón del widget de chat en la esquina inferior derecha. Haga clic en él para asegurarse de que se abra y funcione correctamente.

¿No ves el widget? Asegúrese de purgar todas las cachés de Moodle: ve a Site administration → Development → Purge all caches. También intenta limpiar la caché del navegador o ver la página en una ventana de incógnito. Si estás usando un plugin de caché o un proxy inverso, vacía esas cachés también.