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

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

Plataforma:

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 código a la plantilla de página maestra (Recomendado)

Para añadir el chatbot a todas las páginas de su sitio web Kentico a la vez, use el método de Master Page Template:

Inicia sesión en su Kentico Admin y navegue a la aplicación Page templates
Localiza y abra su Master page template (la plantilla usada en todas las páginas)
Haz clic en la pestaña Encabezado en el editor de plantillas
En la sección de encabezado, pegue su código de inserción de Asyntai
Alternativamente, añada el código al diseño de la plantilla antes de la etiqueta de cierre </head>
Haga clic en Save para aplicar los cambios
Limpia la caché de tu sitio y verifica los cambios en el sitio en vivo

Consejo: Usar la Master Page Template asegura que el chatbot aparezca en cada página que herede de esta plantilla. Este es el método más eficiente para el despliegue en todo el sitio en Kentico.

Método alternativo 1: Encabezado de plantilla de página

Si quiere añadir el chatbot solo a plantillas de página específicas:

Ve a la aplicación Page templates en Kentico Admin
Seleccione la plantilla de página específica que quiere editar
Haga clic en la pestaña Header
Añada su código de inserción de Asyntai usando una etiqueta script:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Haga clic en Save
Todas las páginas que usen esta plantilla ahora incluirán el chatbot

Nota: Este método es útil cuando deseas añadir el chatbot a secciones específicas de su sitio que comparten la misma plantilla de página, en lugar de a todo el sitio.

Método alternativo 2: Web Part HEAD HTML

Para un control más granular en páginas específicas o para JavaScript heredable entre subpáginas:

Abra la página que deseas editar en el editor de páginas de Kentico
Añada un nuevo web part a la página (preferiblemente en una página padre para herencia)
Busque y seleccione el web part HEAD HTML
En la configuración del web part, pega tu código de incrustación de Asyntai
Configure el web part como heredable si deseas que las páginas hijas tengan el chatbot
Haga clic en OK para guardar el web part
Guarde y publique la página

Consejo: El web part HEAD HTML es perfecto para añadir código a una página padre que se propagará automáticamente a todas las páginas hijas, creando una instalación a nivel de sección.

Método alternativo 3: Archivos JavaScript personalizados (Avanzado)

Para desarrolladores que prefieren gestionar scripts como archivos:

En su proyecto Kentico, navegue al directorio ~/CMSScripts/Custom/
Crea un nuevo archivo JavaScript (ej., asyntai-widget.js)
Añada código para cargar dinámicamente su widget de Asyntai:

(function() {
    var script = document.createElement('script');
    script.src = 'https://asyntai.com/static/js/chat-widget.js';
    script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
    script.async = true;
    document.head.appendChild(script);
})();

Referencia este archivo en el encabezado de tu plantilla de página maestra:

<script src="~/CMSScripts/Custom/asyntai-widget.js"></script>

Importante: Este método avanzado requiere acceso al sistema de archivos y conocimiento de la estructura de directorios de Kentico. Asegúrese de tener los permisos adecuados y siempre pruebe en un entorno de pruebas primero.

Paso 3: Verificar la instalación

Después de guardar sus cambios y limpiar la caché, abra su sitio web 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? Asegurate de haber guardado todos los cambios y vaciado la cache de Kentico (Settings > System > Clear cache). Intenta ver su sitio en una ventana de incognito. Revise la consola del navegador (F12) en busca de errores de JavaScript que puedan impedir la carga del widget.