Cómo añadir el chatbot de IA de Asyntai a October CMS
Guía paso a paso para sitios web de October CMS
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 a la plantilla de layout (Recomendado)
La forma recomendada de agregar el chatbot es editando su layout predeterminado en el backend de October CMS:
- Inicia sesión en su backend de October CMS
- Ve a CMS > Layouts en el menú principal
- Abra su layout predeterminado (normalmente
default.htm) - Encuentra el cierre de la etiqueta
</body>y el{% scripts %}placeholder - Agregue su código de inserción de Asyntai justo antes
{% scripts %}y</body>:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body> - Haga clic en "Save" para aplicar sus cambios
Consejo: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.
Alternative Method 1: Using {% put scripts %} Block
Puede usar el marcador de posición de scripts de October CMS para inyectar el chatbot desde una página o partial:
- Abra cualquier página o partial en el editor del CMS
- Agregue el siguiente código usando el
{% put scripts %}bloque:{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %} - Reemplace
YOUR_WIDGET_IDcon su ID de widget real del panel de control - Haga clic en "Save"
Nota: For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.
Método alternativo 2: Usar componente PHP
Si prefieres un enfoque programático, puede agregar el script del chatbot a través de un componente personalizado:
- Cree o modifique un componente en su plugin de October CMS
- En el método
onRun()del componente, use el métodoaddJs():public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); } - Reemplaza
YOUR_WIDGET_IDcon su ID de widget real - Registra el componente en las páginas donde deseas que aparezca el chatbot
Consejo: Usar un componente le da control programático sobre cuándo y dónde se carga el chatbot. Puede agregar lógica condicional dentro de onRun() para controlar la carga según roles de usuario, tipos de página u otros criterios.
Método alternativo 3: Usar un Partial
Puede crear un partial reutilizable para el widget del chatbot:
- Ve a CMS > Partials en el backend de October CMS
- Haga clic en "+ Add" para crear un nuevo partial
- Nómbralo
asyntai-widget.htm - Añada su código de inserción de Asyntai al partial:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Haga clic en "Save"
- Abra su plantilla de layout e incluya el partial antes de
</body>:{% partial 'asyntai-widget' %} - Guarde el layout
Consejo: Usar un partial facilita activar o desactivar el chatbot en todo su sitio simplemente agregando o eliminando la inclusión del partial en su layout.
Paso 3: Verificar la instalación
Después de guardar sus cambios, visite su sitio web de October CMS 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 haber guardado todos los cambios en el backend del CMS. Limpie la caché del navegador o visualice en una ventana de incógnito. Si su sitio usa caché, vacíe la caché de October CMS ejecutando php artisan cache:clear desde la línea de comandos, o use la opción Settings > System > Clear Cache en el backend.
Selección de layout: Asegúrese de que las páginas donde deseas que aparezca el chatbot estén usando el layout correcto. Puede verificar qué layout usa una página abriéndola en CMS > Pages y mirando el menú desplegable Layout en la configuración de la página.
Weebly