Chat web

Objetivo

Añade un widget de chat con IA a tu sitio web. Desde el módulo Web Chat creas y personalizas uno o varios widgets, copias el fragmento de inserción para tu sitio y asignas cada widget a un agente de IA. Las conversaciones de los visitantes se supervisan luego en el buzón compartido, donde puedes tomar el control de la IA, responder y cerrarlas.

Acceso

Sidebar -> Messaging -> Web Chat Rutas:

• /app/{tenant}/webchat (crear y gestionar widgets, obtener el código de inserción)
• /app/{tenant}/conversations?channel=web_chat (conversaciones de Web Chat en el buzón unificado)
• /app/{tenant}/conversations/{id} (una conversación concreta)

El botón View conversations en la página de Web Chat abre el buzón unificado filtrado a Web Chat. La gestión de widgets vive en esta página; las conversaciones viven en el buzón compartido, no aquí.

Roles

• owner, admin, agent
• Eliminar una conversación está restringido a owner y admin.

Requisitos previos

• Al menos un agent activo con el canal Web Chat habilitado (se configura en el módulo Agents). Sin uno, el flujo de creación te pide configurarlo primero.
• Un email verificado. Un espacio de trabajo sin verificar no puede crear un widget.
• El cupo de widgets de chat web de tu plan. Los espacios nuevos incluyen un widget; para más se requiere un plan superior.

Crear un widget

1. En la página de Web Chat, haz clic en Create Widget (o en la tarjeta Create Your First Widget).
2. Completa el modal de creación (Create Web Chat Widget). Un Live Preview en la parte superior refleja tus cambios a medida que escribes.
3. Haz clic en Create Widget para guardar.

Notas:

• El modo Team solo está disponible cuando tu plan incluye Teams y el agente elegido es un coordinador con al menos un especialista aprobado. En otro caso el widget responde con un agente solo.
• Si el agente vinculado a un widget queda inactivo o pierde el canal Web Chat, el editor lo advierte y te pide elegir un agente activo antes de guardar.

Gestionar widgets

Cada widget aparece como una tarjeta con su nombre, el agente vinculado, una insignia Active / Inactive y una vista previa de su título, posición, color e idioma. Acciones de la tarjeta:

• Get Embed Code — abre los fragmentos de instalación (más abajo).
• Edit — reabre el mismo modal, titulado "Edit Widget".
• El menú de acciones (⋮) añade Delete Widget.

Cuando tienes más de un widget, aparecen sobre la cuadrícula un cuadro de búsqueda (Search) y un control de orden (Sort: Name A–Z, Name Z–A, Active first).

Eliminar un widget pide confirmación. Las conversaciones existentes se conservan, pero los nuevos visitantes ya no pueden iniciar chats con ese widget.

Obtener el código de inserción

Abre Get Embed Code en cualquier widget para copiar un fragmento de instalación. El modal ofrece tres caminos:

Cada fragmento ya contiene el ID de tu widget y siempre apunta a la URL de producción, así que funciona desde cualquier sitio. Tras pegar el fragmento y desplegar, el botón flotante de chat aparece en tus páginas.

También puedes controlar el widget desde JavaScript:

• window.HeliosChat.api.open() abre el chat.
• window.HeliosChat.api.close() cierra el chat.
• window.HeliosChat.api.sendMessage('Hi') envía un mensaje.

Límites de plan y marca

• El número de widgets que puedes crear depende de tu plan. Alcanzar el límite abre un diálogo de mejora en lugar del formulario de creación.
• Quitar la marca "Powered by HeliosVision" requiere el plan Growth, Business o Enterprise. En otros planes el interruptor permanece activado.

Conversaciones

Las conversaciones de Web Chat se supervisan en el buzón compartido. Abre una conversación para ver el nombre y el email del visitante (o "Anonymous Visitor" cuando no se recogió ninguno), el hilo de mensajes y los controles siguientes.

Notas:

• El panel se actualiza automáticamente cada pocos segundos; tu respuesta aparece de inmediato al enviarla.
• Una burbuja de mensaje se marca con RAG cuando el agente usó tus documentos y con SQL cuando consultó tus tablas de datos.
• Los adjuntos entrantes se muestran en línea: las imágenes como miniaturas, las notas de voz y los documentos como fichas etiquetadas.
• Generate Insights usa IA. Si tu espacio de trabajo depende de tu propia clave de OpenAI y falta o es inválida, se te pide añadirla o corregirla en Settings -> API Keys.
• Estas conversaciones también aparecen en el buzón unificado completo junto con el resto de canales.

Buenas prácticas

• Configura un agente con el canal Web Chat antes de crear un widget, para que el widget tenga quien responda.
• Usa Allowed Domains para evitar que un widget se cargue en sitios que no controlas.
• Activa Collect visitor email cuando quieras una vía para dar seguimiento tras el chat.
• Toma el control de la IA cuando una conversación se escale y devuélvela una vez resuelta.

Notas comunes

• Si un widget muestra la advertencia "previously linked agent is inactive", activa el agente (o habilita su canal Web Chat) en el módulo Agents y luego reasígnalo.
• Eliminar un widget no borra las conversaciones pasadas; solo detiene los nuevos chats.
• Los límites de marca y de número de widgets los impone tu plan; mejóralo para ampliarlos.

Relacionados

• Widget de Chat Web (Incrustar)
• Conversaciones
• Agentes
• Equipos