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 tus 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). La pestaña tiene dos partes:

  • Test - tu chatbot funcionando en vivo, para que puedas probarlo antes de que lo vean los visitantes. El interruptor del encabezado de la sección lo muestra como un Always-open frame (marco siempre abierto) o como un Widget, y la opción Share a test link (Compartir enlace de prueba) te proporciona enlaces para enviárselo a otras personas (consulta Enviar un enlace a tu chatbot).
  • Deploy - donde eliges la plataforma del sitio web o el canal de mensajería y sigues sus instrucciones.

Pestaña Test & Deploy destacada

Elegir tu plataforma

En Where do you want to add the chatbot? (¿Dónde quieres añadir el chatbot?), la sección Deploy (Desplegar) muestra los destinos compatibles en dos grupos: Website (Sitio web), para colocar el chatbot en las páginas que controlas, y Messaging channels (Canales de mensajería), para conectarlo a una cuenta de mensajería existente. Haz clic en la opción donde quieras 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 código HTML
  • WordPress - a través del plugin oficial de ChatLab o insertando el código manualmente
  • Wix - a través de Settings > Custom Code (Configuración > Código personalizado)
  • Webflow - a través de Site settings > Custom code (Ajustes del sitio > Código personalizado), con el acceso a código personalizado habilitado en tu sitio o espacio de trabajo
  • PrestaShop - a través del módulo de ChatLab para PrestaShop o insertando el código manualmente
  • Shopify - a través del archivo theme.liquid
  • WooCommerce - a través del plugin de WordPress o insertando el código manualmente
  • Shoper - a través de la aplicación de ChatLab de la Shoper App Store o insertando el código manualmente
  • Abicart - a través de Store design > Themes > Site header (Diseño de la tienda > Temas > Encabezado del sitio)
  • Ecwid - a través de Website > Overview > Custom JavaScript code (Sitio web > Visión general > Código JavaScript personalizado)
  • CS-Cart - a través de Design > Layouts > Custom HTML code (Diseño > Diseños > Código HTML personalizado)

Canales de mensajería:

Los canales de mensajería no usan el código embed que aparece abajo. Se conectan a una cuenta de tu propiedad, 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 tienen artículos de ayuda dedicados, aparece el enlace View full instructions (Ver instrucciones completas) en la parte inferior.

Añadir mediante HTML Code

La opción 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 resaltada

  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 el ú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 en el contenido de tu página. El chatbot está siempre visible y puede estar rodeado por otros elementos de la página.

Pestaña Iframe resaltada

  1. Haz clic en la pestaña Iframe
  2. Haz clic en Copy to clipboard (Copiar al portapapeles) 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, PrestaShop, WooCommerce y Shoper

Para estas cuatro plataformas ChatLab ofrece su propio plugin, módulo o app. Una vez conectado a tu chatbot, lo añade a tu sitio web de forma automática, sin necesidad de copiar código. En el caso de las tiendas online, también conecta la tienda para que el chatbot pueda buscar productos y consultar 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 destacado

Plugin Installation (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 o Get the app in the Shoper App Store para Shoper. El botón de PrestaShop no abre una página de marketplace: descarga el módulo en tu ordenador como un único archivo ZIP (chatlab.zip), que subirás a tu tienda en el paso siguiente.
  2. Instala el plugin, módulo o app de ChatLab en el panel de administración de tu sitio web. Para PrestaShop, ve a Modules > Module Manager > Upload a module (Módulos > Administrador de módulos > Subir un módulo) en el back office de PrestaShop y selecciona el archivo ZIP descargado. La guía paso a paso completa para PrestaShop está en Cómo añadir un chatbot a PrestaShop.
  3. Abre ChatLab allí, inicia sesión con tu cuenta de ChatLab y selecciona este chatbot cuando se te solicite. En PrestaShop, haz clic en Configure (Configurar) en el módulo instalado y luego en Connect my store (Conectar mi tienda). En 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. Abre tu web 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 (Implementación). 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 destacado

  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 (Complementos e integraciones > Aplicaciones).
  2. Abre la app de ChatLab en tu panel de Shoper. El panel de ChatLab se abrirá en una nueva ventana.
  3. Establece tu contraseña o inicia sesión con tu cuenta de ChatLab y conecta la tienda a este chatbot cuando se te solicite.
  4. Tu tienda se conectará automáticamente y el chatbot aparecerá en tu escaparate web.

Para añadir solo el widget de chat sin la app, cambia a Manual Installation, copia el código y, en la administración de Shoper, ve a Add-ons and integrations > Custom integrations (Complementos e integraciones > Integraciones personalizadas), pega el código en el campo Page header (Encabezado de página) y guarda los cambios. Actualiza tu tienda para comprobar que el chatbot aparece. Para ver la guía completa, consulta Integración con Shoper.

Manual Installation

Cambia a Manual Installation, copia el código y pégalo en el encabezado 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 tus cambios y prueba el chat. Instala el chatbot solo una vez, utilizando el plugin/app o el código manual, nunca ambos.

Añadir mediante otras plataformas

Para Wix, Webflow, Shopify, Abicart, Ecwid y CS-Cart, no hace falta instalar ningún plugin: tú mismo pegas el código en tu sitio web. Selecciona la plataforma en la sección Deploy (Implementar) 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

Plataforma Shopify con instrucciones paso a paso

Guías completas para estas plataformas:

Cumplimiento del RGPD

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

Content Security Policy (CSP)

Si tu sitio web utiliza cabeceras de Content Security Policy (política de seguridad de contenido), debes permitir 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 genera la interfaz del chat. Incorpora los siguientes orígenes de ChatLab a 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;

Por defecto, el widget inyecta algunos estilos en línea (inline). Tu política también debe autorizar el script de configuración en línea, por ejemplo mediante un nonce o hash CSP. Permite en img-src los orígenes de imágenes utilizados por tu bot y por las tarjetas de producto; el audio y otras funciones activadas 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 activar el modo CSP Safe Mode. Esto carga la hoja de estilos 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 o funciones activadas cumplan con tu política.

Para activarlo, 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 modo CSP Safe Mode activado, prueba una directiva 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 de 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