Instalar en tu sitio web

Una vez indexado tu agente, añadirlo a tu sitio es una sola etiqueta de script. Encuentra tu fragmento en Widget → Script.

El fragmento de incrustación

Pega esto justo antes de la etiqueta de cierre </body> en cada página donde quieras mostrar el widget de chat:

<script
  src="https://botchata.net/api/widget.js"
  data-api-key="YOUR_KEY"
  data-api-url="https://botchata.net/api"
  defer
></script>

El widget carga de forma asíncrona (defer) y no ralentiza tu página. Se renderiza dentro de un Shadow DOM, por lo que no entra en conflicto con el CSS de tu sitio.

Instrucciones por plataforma

Plataforma	Dónde pegar
WordPress	Appearance → Theme File Editor → `footer.php`, antes de `</body>` (o un plugin de scripts de header/footer)
Shopify	Online Store → Themes → Edit code → `theme.liquid`, antes de `</body>`
Wix	Settings → Custom Code → Add Custom Code → «Body - end»
Squarespace	Settings → Advanced → Code Injection → Footer
Webflow	Project Settings → Custom Code → Footer Code
Tilda	Ajustes del sitio → Más → Código HTML para `<body>`
HTML propio	Directamente antes de `</body>` en tu plantilla

Añade el script a cada página (normalmente al pie/plantilla compartida), no solo a la página de inicio, para que el widget esté disponible en todas partes.

Verifica que está activo

Recarga tu sitio — la burbuja de chat debería aparecer en la esquina inferior derecha.

¿No la ves? Mira el código fuente (Ctrl+U) y confirma que la etiqueta de script está presente y que data-api-key no está vacío. Revisa la consola del navegador por errores y asegúrate de que el script no esté bloqueado por un bloqueador de contenido.

Pasar la identidad del visitante (opcional)

Si tu sitio ya sabe quién es el visitante (está logueado), pasa su nombre y email para que el bot le salude por su nombre y rellene los formularios de leads y reservas:

<script
  src="https://botchata.net/api/widget.js"
  data-api-key="YOUR_KEY"
  data-api-url="https://botchata.net/api"
  data-user-name="Juan Pérez"
  data-user-email="juan@example.com"
  defer
></script>

Renderiza estos atributos del lado del servidor desde tu sistema de autenticación. Los valores se pasan a la IA como contexto de visitante identificado.

Persistencia de sesión

El widget recuerda la conversación de cada visitante durante 48 horas (por navegador). Cuando vuelve o navega a otra página, la conversación previa y el historial de mensajes se restauran automáticamente.

Las sesiones se guardan en el localStorage del navegador, separadas por clave API — así que si ejecutas más de un bot en la misma página, sus conversaciones nunca se mezclan. El visitante siempre puede empezar de nuevo con el botón «Nueva conversación» del encabezado del widget.

Varios bots en una página

Puedes colocar más de un script de widget en la misma página (p. ej. un bot de ventas y uno de soporte), cada uno con su propia data-api-key. Funcionan de forma independiente y mantienen conversaciones separadas.

Borra la etiqueta de script de tu plantilla. El widget desaparece en la siguiente carga de página — no hay nada más que limpiar.