Volver al panel

Documentación

Aprende a usar Asyntai

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

Guía paso a paso para ExpressionEngine CMS

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: Añadir al diseño de la plantilla (Recomendado)

La forma más fácil de añadir el chatbot a todas las páginas es editando su plantilla de diseño principal en el panel de control de ExpressionEngine:

  1. En el panel de control de EE, vaya a Developer > Templates > Template Groups
  2. Abra su grupo de plantillas principal (generalmente "site") y edite la plantilla de diseño (o la plantilla que envuelve todas las páginas)
  3. Encuentra la etiqueta de cierre </body>
  4. Pegue su código de inserción de Asyntai justo antes de la etiqueta </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. Guarde la plantilla

Consejo: Añadir el script antes de la etiqueta de cierre </body> asegura que se cargue después del contenido de la página, lo cual es recomendado para widgets de chat y no ralentizará la carga de su página.

Método alternativo 1: Usando parciales de plantilla de EE

Los Template Partials de ExpressionEngine le permiten crear fragmentos reutilizables que pueden incluirse en las plantillas:

  1. Vaya a Developer > Templates > Template Partials
  2. Haga clic en "New" para crear un nuevo partial llamado _asyntai_widget
  3. Pegue su código de inserción de Asyntai en el contenido del parcial:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. Guarde el parcial
  5. Inclúyalo en su plantilla de diseño justo antes de la etiqueta de cierre </body>:
    {embed="_asyntai_widget"} </body>

Nota: Usar Template Partials mantiene su código organizado y facilita actualizar el código de inserción del chatbot en un solo lugar en todo su sitio.

Método alternativo 2: Usando el encabezado/pie de página HTML de EE

Algunas configuraciones de ExpressionEngine proporcionan una sección de pie de página global para añadir scripts:

  1. Vaya a Settings > Content & Design > Global Template Preferences
  2. Si su configuración de EE tiene una sección de pie de página global, pegue el código de inserción de Asyntai allí
  3. Si no hay sección de pie de página global disponible, edite su plantilla de diseño principal directamente y añada el código de inserción antes de la etiqueta de cierre </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. Guarde sus cambios

Método alternativo 3: Usando config.php

Para usuarios avanzados, puede inyectar el script del chatbot a través de la configuración de ExpressionEngine o creando un complemento personalizado:

  1. Acceda a los archivos de su proyecto ExpressionEngine a través de FTP, SSH o su editor de código
  2. Navegue al directorio system/user/config/ y abra config.php
  3. Para inyección de JavaScript personalizado, considere crear un complemento/extensión simple de EE que se conecte al hook template_post_parse para inyectar el script en el renderizado de la página:
    // In your custom extension public function template_post_parse($final_template, $is_partial, $site_id) { $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>'; $final_template = str_replace('</body>', $script . '</body>', $final_template); return $final_template; }
  4. Reemplace YOUR_WIDGET_ID con su ID de widget real del panel de control

Importante: El método de config.php y complemento está dirigido a usuarios avanzados familiarizados con el desarrollo de ExpressionEngine. Para la mayoría de usuarios, se recomienda el método de diseño de plantilla (Paso 2) o el método de Template Partials (Método Alternativo 1).

Paso 3: Verificar la instalación

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

¿No ves el widget? Asegúrese de haber guardado la plantilla y de que estés editando la plantilla de diseño correcta que usan sus páginas. Limpie la caché de su navegador o visualiza en una ventana de incógnito. Si la caché de plantillas de ExpressionEngine está habilitada, limpia la caché desde el panel de control en Developer > Utilities > Cache Manager.