Volver al panel

Documentación

Aprende a usar Asyntai

Cómo añadir el chatbot de IA Asyntai a Craft CMS

Guía paso a paso para sitios web de Craft CMS

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: Editar su plantilla de diseño (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:

  1. Access your Craft CMS project files via FTP, SSH, or your code editor
  2. Navegue al directorio templates/
  3. Encuentra su archivo de diseño principal (comúnmente llamado _layout.twig, _layout.html, o ubicado en templates/_layouts/)
  4. Encuentra la etiqueta de cierre </body>
  5. Pegue su código de inserción de Asyntai justo antes de la etiqueta </body>
  6. Guarde el archivo

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.

Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)

Craft CMS provides a built-in Twig tag for registering JavaScript:

  1. Abra su plantilla de diseño principal
  2. Añada el siguiente código antes de la etiqueta de cierre </body>:
    {% js %} (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); })(); {% endjs %}
  3. Reemplaza YOUR_WIDGET_ID con su ID de widget real
  4. Guarde el archivo

Nota: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.

Alternativa: Crear un archivo de inclusión separado

Para una mejor organización, cree un archivo de inclusión dedicado:

  1. Cree un nuevo archivo: templates/_includes/chatbot.twig (o .html)
  2. Añada su código de inserción de Asyntai a este archivo:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  3. En su plantilla de diseño principal, incluye este archivo antes de </body>:
    {% include '_includes/chatbot' %}
  4. Guarde ambos archivos

Consejo: Usar un archivo de inclusión facilita habilitar/deshabilitar el chatbot en todo su sitio comentando una sola línea.

Alternativa: Carga condicional

Para cargar el chatbot solo en páginas o secciones específicas:

  1. En su plantilla de diseño o página, use condicionales Twig:
    {% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
  2. O verifique secciones específicas:
    {% if craft.app.request.segments[0] != 'admin' %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}

Paso 3: Verificar la instalación

Después de guardar sus cambios, visite su sitio web de Craft CMS 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 el archivo de 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 usas caché de plantillas, limpia la caché de Craft CMS desde el Panel de Control en Utilities > Clear Caches.

Ubicación de la plantilla: Las ubicaciones de plantillas de Craft CMS pueden variar según la configuración de su proyecto. Las ubicaciones comunes incluyen templates/_layout.twig, templates/_layouts/main.twig o templates/_base.twig. Revise sus plantillas existentes para encontrar dónde se define la etiqueta </body>.