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 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:

  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 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:

  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. If there's a JavaScript field, paste your Asyntai embed code there
  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 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:

  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. Find the closing </body> tag or the footer section
  4. Add your Asyntai embed code just before </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 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.