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.
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.
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:
- WhatsApp Business - responde en una cuenta de WhatsApp Business, consulta WhatsApp for Business
- Facebook Messenger - responde a los mensajes de tu página de Facebook, consulta Integración con Facebook Messenger
- Instagram - responde a los mensajes directos de Instagram, consulta Integración con Instagram
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.
- Haz clic en la pestaña Widget
- Haz clic en Copy to clipboard (Copiar al portapapeles) para copiar el código
- Localiza la sección
<head>de tu sitio web - Pega el código como el último elemento dentro de la sección
<head> - 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.
- Haz clic en la pestaña Iframe
- Haz clic en Copy to clipboard (Copiar al portapapeles) para copiar el código
- Pega el código en cualquier lugar del HTML de tu sitio web donde quieras que aparezca el chatbot
- Ajusta los atributos
widthyheightpara 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).
Plugin Installation (recomendada)
- 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. - 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.
- 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.
- 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:
- WordPress - Cómo añadir tu chatbot a un sitio web de WordPress
- PrestaShop - Cómo añadir un chatbot a PrestaShop
- WooCommerce - Integración con WooCommerce
- Shoper - Integración con Shoper
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.
- 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).
- Abre la app de ChatLab en tu panel de Shoper. El panel de ChatLab se abrirá en una nueva ventana.
- Establece tu contraseña o inicia sesión con tu cuenta de ChatLab y conecta la tienda a este chatbot cuando se te solicite.
- 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:
- El código de inserción con las opciones Widget e Iframe
- Instrucciones paso a paso para pegar el código, específicas para cada plataforma
- Un enlace View full instructions (Ver instrucciones completas) a la guía completa de la plataforma
Guías completas para estas plataformas:
- Cómo añadir tu chatbot a un sitio web de Wix
- Cómo añadir tu chatbot a un sitio web de Webflow
- Integración con Shopify
- Integración con Abicart
- Integración con Ecwid
- Integración con CS-Cart
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;