Cómo añadir el chatbot de IA Asyntai a Craft CMS
Guía paso a paso para sitios web de Craft CMS
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:
- Access your Craft CMS project files via FTP, SSH, or your code editor
- Navegue al directorio
templates/ - Encuentra su archivo de diseño principal (comúnmente llamado
_layout.twig,_layout.html, o ubicado entemplates/_layouts/) - Encuentra la etiqueta de cierre
</body> - Pegue su código de inserción de Asyntai justo antes de la etiqueta
</body> - 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:
- Abra su plantilla de diseño principal
- 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 %} - Reemplaza
YOUR_WIDGET_IDcon su ID de widget real - 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:
- Cree un nuevo archivo:
templates/_includes/chatbot.twig(o.html) - 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> - En su plantilla de diseño principal, incluye este archivo antes de
</body>:{% include '_includes/chatbot' %} - 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:
- 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 %} - 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>.
Weebly