Centro de ayuda
Añadir el chatbot a tu sitio web

Cómo añadir un chatbot a tu sitio web

Última actualización:

Añadir ChatLab a tu sitio web permite que los visitantes interactúen con tu chatbot de IA directamente en tu página. Esta guía explica cómo obtener el código de inserción y añadirlo a tu sitio web.

Antes de empezar

Crea y entrena tu chatbot antes de compartirlo con los clientes. Para la instalación, también necesitas permisos para editar y publicar el sitio web. Consulta Cómo crear tu primer chatbot.

Cómo abrir la pestaña Test & Deploy

Selecciona tu chatbot en el panel principal y, a continuación, haz clic en la pestaña Test & Deploy (Probar e implementar). También puedes hacer clic en el botón verde Test chatbot (Probar chatbot) dentro de la pestaña Overview (Información general) del chatbot. La pestaña consta de dos partes:

  • Test (izquierda): tu chatbot ejecutándose en vivo en un escenario que simula tu sitio web, para que puedas probarlo antes de que lo vean los visitantes. En el modo Widget, la ventana de chat se ubica en la esquina inferior derecha en su tamaño real, con el icono de chat debajo, exactamente como lo verán los visitantes. El interruptor Widget / Frame en la esquina superior derecha del escenario cambia a Frame (Marco), el chat siempre abierto que genera el código iframe.
  • Deploy (derecha): donde eliges la plataforma web o el canal de mensajería y sigues sus instrucciones. Debajo, Share a test link (Compartir enlace de prueba) te proporciona enlaces para enviárselos a otras personas (consulta Cómo enviar un enlace a tu chatbot).

Pestaña Test & Deploy resaltada

Tu sitio web detrás del chatbot

Cuando tu chatbot se entrena con un único sitio web, el escenario muestra una captura de pantalla de ese sitio detrás de la ventana de chat, para que compruebes cómo luce el chatbot en tus propias páginas. La captura se toma una sola vez al abrir la pestaña por primera vez (mientras se genera, el escenario muestra el contorno de una página y el chatbot ya funciona) y se conserva; solo se toma una nueva cuando cambias la dirección. Los chatbots entrenados con varios sitios web, o solo con archivos y texto, muestran en su lugar un contorno de página neutro.

Haz clic en la dirección del sitio web en la parte superior del escenario para gestionar el fondo:

  • Website address (Dirección del sitio web) con Save (Guardar): muestra una página diferente, por ejemplo, la página de un producto. Try again (Reintentar) vuelve a intentar una captura que haya fallado.
  • Hide background / Show background (Ocultar fondo / Mostrar fondo): activa o desactiva la captura de pantalla sin eliminarla.
  • Remove background (Eliminar fondo): elimina la captura de pantalla. El escenario mostrará el contorno neutro hasta que vuelvas a introducir una dirección.

El fondo es únicamente una vista previa dentro del panel de administración. No realiza ningún cambio en tu sitio web.

Cómo elegir tu plataforma

En Where do you want to add the chatbot? (¿Dónde quieres añadir el chatbot?), la sección Deploy (Implementar) muestra los destinos compatibles organizados en tres grupos: Website (Sitio web), para colocar el chatbot en páginas que tú controlas, Online store platforms (Plataformas de tiendas online; haz clic en el encabezado para desplegarlo) y Messaging channels (Canales de mensajería), para conectarlo a una cuenta de conversación existente. Haz clic en la opción que coincida con el lugar donde quieres que aparezca el chatbot para ver instrucciones personalizadas.

Lista de plataformas destacada en la sección Deploy

Plataformas compatibles:

  • HTML Code - funciona con cualquier sitio web donde puedas editar el HTML
  • WordPress - mediante el plugin oficial de ChatLab o insertando el código manualmente
  • Wix - mediante Settings > Custom Code (Ajustes > Código personalizado)
  • Webflow - mediante Site settings > Custom code (Ajustes del sitio > Código personalizado), con el acceso a código personalizado habilitado para tu sitio o espacio de trabajo
  • PrestaShop - mediante el módulo de ChatLab para PrestaShop o insertando el código manualmente
  • Shopify - mediante la aplicación de ChatLab desde la Shopify App Store (un embed de app en tu tema) o insertando el código manualmente en el archivo theme.liquid
  • WooCommerce - mediante el plugin de WordPress o insertando el código manualmente
  • Shoper - mediante la aplicación de ChatLab desde la Shoper App Store o insertando el código manualmente
  • Abicart - mediante Store design > Themes > Site header (Diseño de la tienda > Temas > Encabezado del sitio)
  • Ecwid - mediante Website > Overview > Custom JavaScript code (Sitio web > Información general > Código JavaScript personalizado)
  • CS-Cart - mediante el complemento de ChatLab o insertando el código manualmente en Design > Layouts > Custom HTML code (Diseño > Diseños > Código HTML personalizado)
  • BigCommerce - se añade automáticamente cuando se conecta la tienda, o mediante Storefront > Script Manager (Escaparate > Administrador de scripts)

Canales de mensajería:

Los canales de mensajería no utilizan el código de incrustación que se muestra a continuación. Se conectan a una cuenta que ya posees, por lo que no es necesario pegar ningún código en un sitio web.

Cada plataforma muestra instrucciones paso a paso específicas para esa integración. En el caso de las plataformas que cuentan con artículos de ayuda dedicados, aparece un enlace con el texto View full instructions (Ver instrucciones completas) en la parte inferior.

Añadir mediante HTML Code

La opción de HTML Code funciona con cualquier sitio web en el que tengas acceso al código fuente. Verás dos opciones de inserción: Widget e Iframe.

Modo Widget

La pestaña Widget muestra el código que añade un icono de chat a tu sitio web. Cuando los visitantes hacen clic en el icono, se abre una ventana emergente de chat.

Pestaña Widget destacada

  1. Haz clic en la pestaña Widget
  2. Haz clic en Copy to clipboard (Copiar al portapapeles) para copiar el código
  3. Localiza la sección <head> de tu sitio web
  4. Pega el código como último elemento dentro de la sección <head>
  5. Actualiza tu navegador para comprobar que aparece el icono del chatbot

Modo Iframe

La pestaña Iframe muestra el código que inserta el chatbot directamente dentro del contenido de tu página. El chatbot está siempre visible y puede estar rodeado por otros elementos de la página.

Pestaña Iframe destacada

  1. Haz clic en la pestaña Iframe
  2. Haz clic en Copy to clipboard para copiar el código
  3. Pega el código en cualquier lugar del HTML de tu sitio web donde quieras que aparezca el chatbot
  4. Ajusta los atributos width y height para adaptarlo a tu diseño

¿No tienes claro cuál elegir? Lee ¿Cuál es la diferencia entre widget e Iframe? para ver una comparación detallada.

Añadir mediante un plugin o app: WordPress, WooCommerce, PrestaShop, Shopify, Shoper y CS-Cart

Para estas seis plataformas, ChatLab ofrece su propio plugin, módulo, app o complemento. Una vez que lo conectas a tu chatbot, añade el chatbot a tu sitio por sí solo, por lo que no hace falta copiar ningún código. En las tiendas online también conecta la tienda, permitiendo que el chatbot busque tus productos y consulte el estado de los pedidos. Pegar el código manualmente sigue estando disponible como alternativa, pero solo muestra el widget de chat.

Al seleccionar una de estas plataformas, aparecen dos pestañas: Plugin Installation (Instalación mediante plugin, recomendada) y Manual Installation (Instalación manual).

Plataforma WordPress con el botón Get the plugin on WordPress.org resaltado

Shopify seleccionado bajo Online store platforms, con la pestaña Plugin Installation

Instalación mediante plugin (recomendada)

  1. Haz clic en el botón situado en la parte superior de la pestaña Plugin Installation: Get the plugin on WordPress.org para WordPress y WooCommerce, Download the ChatLab module (.zip) para PrestaShop, Get the app in the Shopify App Store para Shopify, Get the app in the Shoper App Store para Shoper, o Download the ChatLab add-on (.tgz) para CS-Cart. El botón de PrestaShop no abre la página de un marketplace - descarga el módulo en tu ordenador como un único archivo ZIP (chatlab.zip), que subirás a tu tienda en el siguiente paso.
  2. Instala el plugin, módulo, app o complemento de ChatLab en el panel de administración de tu sitio web. Para PrestaShop, ve a Modules > Module Manager > Upload a module en el panel de gestión de PrestaShop y selecciona el archivo ZIP descargado. La guía completa paso a paso de PrestaShop está en Cómo añadir el chatbot a PrestaShop. Para CS-Cart, abre Add-ons > Downloaded add-ons, elige Manual installation en el menú de engranaje y sube el archivo descargado.
  3. Abre ChatLab allí, inicia sesión con tu cuenta de ChatLab y elige este chatbot cuando te lo solicite. Para PrestaShop, haz clic en Configure dentro del módulo instalado y luego en Connect my store. Para CS-Cart, ve a Marketing > ChatLab AI Chatbot y haz clic en Continue. Para una tienda WooCommerce, mantén marcada la opción WooCommerce integration para que también se conecten los datos de la tienda.
  4. La conexión finaliza automáticamente y el chatbot aparece en tu sitio web. En Shopify, abre también Online Store > Themes > Customize > App embeds, activa ChatLab AI Chat y guarda los cambios. Abre tu sitio y envía un mensaje de prueba.

Cada plataforma dispone de una guía dedicada con cada paso y capturas de pantalla:

Shoper

Selecciona Shoper en la lista de plataformas de la sección Deploy. En la pestaña Plugin Installation, haz clic en Get the app in the Shoper App Store para abrir la app gratuita de ChatLab en la Shoper App Store.

Plataforma Shoper con el botón Get the app in the Shoper App Store resaltado

  1. Instala la app gratuita ChatLab desde la Shoper App Store. También puedes encontrarla desde la administración de Shoper en Add-ons and integrations > Applications.
  2. Abre la app de ChatLab en el panel de administración de Shoper. El panel de ChatLab se abrirá en una nueva ventana.
  3. Configura tu contraseña o inicia sesión con tu cuenta de ChatLab, y conecta la tienda a este chatbot cuando te lo solicite.
  4. Tu tienda se conecta automáticamente y el chatbot aparece en tu tienda online.

Para añadir únicamente el widget de chat sin la app, cambia a Manual Installation, copia el código y, en el panel de Shoper, ve a Add-ons and integrations > Custom integrations, pega el código en el campo Page header y guarda. Actualiza tu tienda para comprobar que el chatbot aparece. Para ver el proceso completo paso a paso, consulta Integración con Shoper.

Instalación manual

Cambia a Manual Installation, copia el código y pégalo en la cabecera de tu sitio web siguiendo los pasos indicados para tu plataforma. En WordPress y WooCommerce esto se realiza con un plugin de inserción de código como Insert Headers and Footers. Publica los cambios y prueba el chat. Instala el chatbot una sola vez, utilizando el plugin o app, o el código manual, pero no ambos.

Añadir a través de otras plataformas

En Wix, Webflow y Abicart no hay ningún plugin para instalar: tú mismo pegas el código en tu sitio web. En Ecwid, la aplicación ChatLab del Ecwid App Market conecta la tienda con tu chatbot; si el widget de chat no aparece en tu escaparate, pega el código en Custom JavaScript code (código JavaScript personalizado) o en el sitio web donde esté insertada tu tienda. En BigCommerce, ChatLab añade el widget por ti cuando la tienda está conectada con acceso al contenido; de lo contrario, pegas el código en el Script Manager. Selecciona la plataforma en la sección Deploy (Desplegar) para ver:

  1. El código de inserción con las opciones Widget e Iframe
  2. Instrucciones paso a paso para pegar el código específicas para cada plataforma
  3. Un enlace View full instructions (Ver instrucciones completas) a la guía completa de la plataforma

Guías completas para estas plataformas:

Cumplimiento del RGPD

Si necesitas que tu chatbot solo se cargue después de que el usuario dé su consentimiento para las cookies, consulta Configuración de ChatLab para el cumplimiento del RGPD, que incluye guías de integración para CookieBot, Usercentrics y Google Tag Manager.

Content Security Policy (CSP)

Si tu sitio web utiliza encabezados de Content Security Policy (política de seguridad de contenido), debes autorizar los dominios de ChatLab para que el chatbot funcione. Las directivas necesarias dependen de si utilizas el modo Widget o el modo Iframe.

Modo Widget

El widget carga un script en tu página que crea la interfaz del chat. Incorpora los siguientes orígenes de ChatLab en tus directivas CSP existentes; no reemplaces la política para el resto de tu sitio web:

script-src https://script.chatlab.com;
style-src https://script.chatlab.com https://fonts.googleapis.com 'unsafe-inline';
connect-src https://api.chatlab.com wss://api.chatlab.com;
font-src https://fonts.gstatic.com;

De forma predeterminada, el widget inyecta algunos estilos en línea. Tu política también debe autorizar el script de configuración en línea, por ejemplo mediante un nonce o un hash de CSP. Permite los orígenes de imágenes utilizados por tu bot y por las fichas de producto en img-src; el audio y otras funciones habilitadas pueden requerir orígenes adicionales. Si utilizas un dominio de agencia, usa los dominios de tu fragmento generado.

CSP Safe Mode: cómo evitar unsafe-inline

Si la política de seguridad de tu sitio web no permite 'unsafe-inline' en style-src, puedes habilitar el CSP Safe Mode (Modo seguro CSP). Esto carga la hoja de estilo del contenedor del widget desde un archivo CSS externo. No autoriza tu script de configuración en línea ni garantiza que todos los estilos personalizados y funciones habilitadas cumplan con tu política.

Para habilitarlo, añade window.aichatbotCspSafe = true; antes de la etiqueta del script de ChatLab:

<script>
  window.aichatbotApiKey = "YOUR_API_KEY";
  window.aichatbotCspSafe = true;
</script>
<script src="https://script.chatlab.com/aichatbot.js" defer></script>

Con el CSP Safe Mode habilitado, prueba una política de hojas de estilo sin 'unsafe-inline'. Un punto de partida es:

script-src https://script.chatlab.com;
style-src https://script.chatlab.com https://fonts.googleapis.com;
connect-src https://api.chatlab.com wss://api.chatlab.com;
font-src https://fonts.gstatic.com;

Modo Iframe

La página principal debe permitir el origen en la URL del iframe copiado. Para el alojamiento estándar de ChatLab, añade esto a la política existente:

frame-src https://api.chatlab.com;

Artículos relacionados