Chat web
Un botón de chat que pegas en tu web. Tus clientes con la sesión iniciada preguntan por sus propios datos y el asistente responde con tus tools y su propio acceso.
En esta página
El chat web es un botón flotante que abre un asistente en tu propia web. Usa las tools que habilitaste en el canal Web, con la credencial del cliente que pregunta en tu sistema. Todo es de solo lectura: el asistente consulta datos y nunca cambia nada.
Pegas una etiqueta <script>. No tocas tu backend.
Actívalo
Abre el paso Chat web de tu integración. Antes de activarlo necesitas:
- La integración en producción.
- El dominio verificado.
- Al menos un origen permitido.
- Al menos una tool habilitada en el canal Web. Mira Canales.
Solo propietarios y administradores pueden cambiar estos ajustes.
| Ajuste | Notas |
|---|---|
| Orígenes permitidos | Las webs donde se puede incrustar el chat. Hasta 10. |
| Modelo | El modelo de Claude que responde. |
| Notas para el asistente | Tono y glosario de tu empresa, hasta 1.000 caracteres. Nunca cambian las reglas del asistente. |
| Chat web activado | Al apagarlo el chat deja de atender a tus clientes. |
Instalación
El paso Chat web te muestra tu fragmento con un botón Copiar. Pégalo en las páginas de tu web donde quieras el chat:
<script src="https://connect.grostify.com/widget/v1.js" data-tenant="acme" async></script>data-tenant es tu slug. El script dibuja un botón redondo abajo a la derecha. El chat se abre en un panel cuando el cliente hace clic. No lee nada de tu página y no guarda nada propio.
Orígenes permitidos
El chat solo se abre en los orígenes que listes. Cada uno tiene que:
- Empezar por
https://. - No llevar ruta, query ni fragmento, por ejemplo
https://app.acme.comy nohttps://app.acme.com/inicio. - Tener un host bajo el dominio registrable de tu dominio verificado. Si verificaste
api.acme.com, valenhttps://acme.comyhttps://app.acme.com.
Connect lo comprueba al guardar y otra vez en cada petición. Puedes listar hasta 10 orígenes.
Cerrar sesión: logout()
El script añade una función a tu página, GrostifyConnect.logout(). Devuelve una promesa. Llámala en tu propio cierre de sesión y espérala antes de redirigir:
try { await GrostifyConnect.logout()} catch { // La sesión del chat puede seguir abierta: reintenta o avisa al cliente.}await signOutOfMyApp()window.location.href = "/login"Eso cierra la sesión del chat en ese navegador, para que la siguiente persona de un ordenador compartido no encuentre la cuenta del cliente anterior. Si no la llamas, la sesión sigue abierta hasta que caduque.
La promesa se rechaza si no se pudo cerrar la sesión: sin red, o con una respuesta que no es un 204. En ese caso la sesión del chat puede seguir abierta. Reintenta la llamada o avisa al cliente antes de dejarle salir, sobre todo en un ordenador compartido. El chat, si está abierto, se recarga de todas formas.
Cómo se conecta el cliente
La primera vez el chat muestra una explicación corta y un botón Conectar mi cuenta de Acme:
- Se abre una ventana con una página de Connect que muestra tu dominio verificado.
- El cliente inicia sesión en tu login, o pega su API key personal, como en autenticación de usuarios.
- La ventana se cierra y el chat queda listo. El chat siempre muestra "Conectado como" con su usuario y un botón Desconectar.
La sesión se guarda en ese navegador y dura 7 días sin uso y 30 como máximo. Después el cliente conecta otra vez. Cada cliente aparece en Usuarios conectados con el canal Web.
Límites
| Límite | Valor |
|---|---|
| Preguntas por cliente | 50 al día |
| Largo de una pregunta | 1.000 caracteres |
| Largo de una respuesta | 4.000 caracteres |
| Preguntas a la vez | Una por conversación. La siguiente espera a la respuesta. |
El chat tiene además un límite de uso mensual. Al alcanzarlo, avisa a los clientes de que el asistente no está disponible ahora, y vuelve a funcionar el mes que viene.
Conversaciones
Una conversación se cierra a los 30 minutos sin mensajes. El texto de las conversaciones se borra a los 30 días. Tu empresa ve métricas, no texto: el paso Chat web muestra el número de preguntas del mes y las sesiones activas con el usuario de tu sistema, cuándo empezó y su último uso. Propietarios y administradores pueden Revocar una sesión, y ese cliente tiene que conectar otra vez.
El asistente usa Claude, de Anthropic. Las preguntas del cliente y los resultados de las tools se envían a Anthropic para responderlas. Las credenciales nunca se envían.
Seguridad
- La sesión vive en una cookie particionada,
HttpOnlyySecure, propia de tu sitio. El JavaScript de tu web nunca la ve y Connect solo guarda su hash. - El chat corre en un iframe servido por Connect. Solo los orígenes que listes pueden incrustarlo.
- Tu página nunca manda texto ni contexto al asistente. El único mensaje entre la página y el chat es "cerrar".
- Los enlaces de las respuestas solo se mantienen si apuntan a tu dominio verificado.
- Cada llamada a tu API lleva la credencial del propio cliente, así que el asistente solo ve lo que ese cliente ya puede ver. Mira Seguridad y privacidad.
Problemas frecuentes
| Problema | Qué hacer |
|---|---|
| El navegador bloqueó la ventana de inicio de sesión | Permite las ventanas emergentes en tu sitio y pulsa Abrir la ventana otra vez en el chat. |
| El chat se abre vacío o no se abre | El origen no está en la lista o el canal no está listo. Revisa el origen, que la integración esté en producción, que el chat esté activado, que haya una tool en el canal Web y que Claude esté configurado en el servidor. |
| "Tu sesión terminó" | La sesión caducó, la revocaste o el cliente cerró sesión. Conecta su cuenta otra vez. |
| "Llegaste al límite de preguntas de hoy" | El cliente ya hizo 50 preguntas hoy. Vuelve mañana. |
| "El asistente no está disponible ahora" | El chat llegó a su límite de uso del mes. Se renueva el mes que viene. Escribe a connect@grostify.com si necesitas más. |
| El cliente sigue conectado tras cerrar sesión en tu web | Llama a GrostifyConnect.logout() y espéralo antes de redirigir. |