El widget es una burbuja flotante que abre un chat con tu agente de IA. Se instala con una sola etiqueta <script> y no depende de ningún framework.

1. Publica un agente

En el panel, entra a Agentes, crea uno (soporte, ventas o reservas), escribe su instrucción y publícalo. Carga al menos una fuente de conocimiento en Conocimiento para que responda con información de tu negocio.

2. Copia tu snippet

En Configuración → Widget encontrarás tu clave pública (wk_live_...) y el snippet listo para pegar:

<script src="https://my.talkhero.app/api/widget.js" data-talkhero-key="wk_live_xxx" defer></script>

Pégalo antes de </body> en cada página donde quieras el chat. Puedes usar el mismo snippet en varios dominios.

3. Autoriza tus dominios

En la misma pantalla agrega los orígenes permitidos (por ejemplo https://tudominio.com). La API rechaza las peticiones del widget desde orígenes que no estén en la lista.

4. Verifica la instalación

El panel detecta la primera carga del widget y marca el paso "Instalar el widget" del onboarding como completado. Si no aparece, revisa que el dominio esté autorizado y que el snippet cargue desde api.talkhero.app.

Qué hace el widget por ti

Streaming de la respuesta token a token, con indicador de escritura.
Botón Hablar con una persona siempre visible: escala la conversación a tu bandeja.
Encuesta de satisfacción (1 a 5) cuando la conversación se resuelve.
Envía el contexto de la página (URL y título) en cada mensaje para que el agente sepa dónde está el usuario.
Recuerda la conversación en la pestaña (sessionStorage).
Accesible: navegación por teclado y aria-live para los mensajes.

Apariencia

Desde Configuración → Widget puedes ajustar color primario, posición, avatar, nombre visible y mensaje de bienvenida. El widget muestra la marca "con talkHero" salvo en el plan Corporate, que permite ocultarla.

Identificar a tus usuarios

Si el visitante ya inició sesión en tu sitio, puedes identificarlo de forma segura con una firma HMAC. Consulta Identify con HMAC.