Volver al panel

Documentación

Aprende a usar Asyntai

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

Guía paso a paso para sitios web de October 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 a la plantilla de layout (Recomendado)

La forma recomendada de agregar el chatbot es editando su layout predeterminado en el backend de October CMS:

  1. Inicia sesión en su backend de October CMS
  2. Ve a CMS > Layouts en el menú principal
  3. Abra su layout predeterminado (normalmente default.htm)
  4. Encuentra el cierre de la etiqueta </body> y el {% scripts %} placeholder
  5. 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>
  6. 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:

  1. Abra cualquier página o partial en el editor del CMS
  2. 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 %}
  3. Reemplace YOUR_WIDGET_ID con su ID de widget real del panel de control
  4. 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:

  1. Cree o modifique un componente en su plugin de October CMS
  2. En el método onRun() del componente, use el método addJs():
    public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
  3. Reemplaza YOUR_WIDGET_ID con su ID de widget real
  4. 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:

  1. Ve a CMS > Partials en el backend de October CMS
  2. Haga clic en "+ Add" para crear un nuevo partial
  3. Nómbralo asyntai-widget.htm
  4. 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>
  5. Haga clic en "Save"
  6. Abra su plantilla de layout e incluya el partial antes de </body>:
    {% partial 'asyntai-widget' %}
  7. 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.