Volver al panel

Documentación

Aprende a usar Asyntai

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

Guía paso a paso para sitios web de Drupal

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: Usando el módulo de scripts de encabezado y pie de página (Recomendado)

La forma más fácil de añadir el chatbot es usando el módulo "Header and Footer Scripts":

  1. Inicie sesión en su panel de administración de Drupal
  2. Vaya a Extend y haga clic en \"Install new module\"
  3. Busque \"Header and Footer Scripts\" o descárguelo desde Drupal.org
  4. Instale y active el módulo
  5. Vaya a Configuration → Development → Header and Footer Scripts
  6. Haga clic en la pestaña "Footer"
  7. Pega tu código de incrustación de Asyntai en el área de texto de scripts del pie de página
  8. Haga clic en "Save configuration"

Consejo: Añadir el código a la sección del pie de página asegura que se cargue después del contenido de la página, lo cual es recomendado para widgets de chat.

Alternativa: Editar plantilla del tema

Puedes agregar el código directamente al archivo de plantilla de tu tema:

  1. Navegue a la carpeta de su tema: themes/your_theme/
  2. Abra el archivo html.html.twig (o cree uno si no existe)
  3. Encuentra la etiqueta de cierre </body>
  4. Pegue su código de inserción de Asyntai justo antes de la etiqueta </body>
  5. Guarde el archivo
  6. Limpie la caché de Drupal: Configuration → Performance → Clear all caches

Importante: Los cambios en los archivos del tema pueden sobrescribirse al actualizar su tema. Considere usar un tema hijo o el módulo Header and Footer Scripts para una solución más permanente.

Alternativa: Usando bibliotecas (Para desarrolladores)

Para desarrolladores que prefieren usar el sistema de bibliotecas de activos de Drupal:

  1. Cree o edite el archivo *.libraries.yml de su tema
  2. Añada una nueva entrada de biblioteca:
    asyntai-chatbot:
    js:
    https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } }
  3. Adjunta la biblioteca en el archivo *.info.yml de tu tema:
    libraries:
    - your_theme/asyntai-chatbot
  4. Limpie la caché de Drupal

Paso 3: Verificar la instalación

Después de guardar sus cambios y limpiar la caché, visite su sitio web 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 limpiar la caché de Drupal yendo a Configuration → Performance → Clear all caches. También intente limpiar la caché de su navegador o ver en una ventana de incógnito.