Ir al contenido

Construir

Qué es el widget y cómo funciona

Ver como Markdown

El widget es la burbuja de chat que tus visitantes ven en la esquina de tu web y que les permite hablar con el asistente de IA de tu agencia (y, si hace falta, con una persona de tu equipo). No es una página aparte ni una app que haya que instalar: es un pequeño fragmento de código que tú pegas una vez en tu web, y a partir de ahí el widget aparece en todas las páginas donde esté ese código.

En reposo se ve como una burbuja flotante en la esquina inferior de la pantalla. Al hacer clic se abre una ventana de chat con el saludo configurado por tu agencia y unas sugerencias de conversación.

Qué pasa por dentro (para el perfil más técnico)

Sección titulada «Qué pasa por dentro (para el perfil más técnico)»

El snippet que pegas en tu web carga de forma asíncrona un script pequeño (embed.js) alojado en el dominio de tu proveedor. Ese script no dibuja nada por sí mismo: crea un <iframe> aislado y le pasa la configuración (identificador del widget, idioma, dominio de origen y, opcionalmente, la URL del backend) como parámetros en la propia URL del iframe. Dentro de ese iframe corre la aplicación del chat, que habla con el backend de la plataforma de forma independiente del resto de tu web.

Esto tiene dos consecuencias prácticas: el widget no puede romper el CSS ni el JavaScript de tu web (vive en su propio documento aislado), y tu web tampoco puede acceder a los datos de la conversación (viven dentro del iframe).

La identidad del visitante es un token de sesión propio del widget — no usa cookies de tu web ni de terceros. Ese token se guarda en el navegador del visitante (localStorage) y la conversación se mantiene hasta 7 días; pasado ese tiempo, o si el dato se corrompe, el widget simplemente empieza una conversación nueva sin dar ningún error.

Nota — Estados que puede mostrar el widget

En línea (atención normal) · fuera de horario (con el mensaje que configures) · traspaso a un humano de tu equipo · sin conexión con reintento automático y botón «Reintentar» · error de configuración si falta algún dato del snippet. Los dos últimos se explican con detalle en el capítulo 5; el traspaso a un humano, justo debajo.

Si el visitante pulsa la sugerencia «Hablar con humano» o escribe explícitamente que quiere hablar con una persona (en español o en inglés — el sistema reconoce la petición aunque la escriba a su manera), el asistente deja de responder a partir de ese mensaje: la conversación pasa a esperar a un operador en el inbox de tu agencia (modo EN COLA, ver el Manual de usuario). El chat no muestra ningún aviso especial mientras espera — simplemente no llega una respuesta nueva del asistente — hasta que alguien de tu equipo toma el control desde el inbox; a partir de ahí, la cabecera del chat pasa a mostrar «Te atiende [nombre] del equipo» y las siguientes respuestas ya son suyas, no del asistente.

Lo mismo ocurre si tienes configurada una regla de escalación del agente con la acción «Derivar a humano» (por palabras clave o por turnos sin resolver, ver el Manual del administrador): el efecto en el widget es idéntico — el asistente calla y la conversación cae a la cola del inbox.