Arquitectura avanzada de Co-browse: presencia en vivo, sesiones y tokens, rrweb, proxy de archivos y watchdog
Cómo funciona Co-browse por dentro: presencia en vivo, ciclo de sesión y tokens de un solo uso, captura con rrweb, proxy de archivos y los watchdogs que cierran sesiones colgadas.
Mira este paso en el video · Privacidad y buenas prácticas
Este artículo es para administradores y equipos técnicos que quieren entender cómo funciona Co-browse por dentro: qué piezas intervienen cuando un agente ve la pantalla del cliente en vivo, cómo se autoriza cada sesión y qué mecanismos evitan que una sesión quede colgada. No necesitas esto para usar Co-browse en el día a día (para eso lee los artículos de inicio enlazados al final), pero te ayudará a diagnosticar problemas y a confiar en el aislamiento de datos.
Requisitos
- El add-on Co-browse activo en tu plan (se valida con
CobrowseGate). - El widget de Omnifox instalado en el sitio del cliente.
- Permisos de Inbox para el agente que inicia la sesión.
Las piezas y cómo encajan
- Presencia en vivo. Mientras el cliente tiene el widget cargado, Omnifox sabe que está "presente" en una página. Esa señal es la que habilita el botón Co-browse en la cabecera del chat (ChatHeader). Sin presencia activa no hay a quién pedirle pantalla.
- Solicitud de sesión. El agente pulsa Co-browse y se emite el evento
cobrowse.session.requestedpor el canal del widget. El widget carga de forma diferida (lazy-load) el bundle de captura solo cuando llega ese evento, para no pesar en sitios que nunca lo usan. - Sesión + token. El backend crea una sesión de Co-browse en la base del tenant, controla la concurrencia con Redis y emite un token de cliente de un solo uso (1-shot). Ese token autentica al widget contra el canal privado
private-cobrowse.{id}en Reverb; una vez usado, no sirve de nuevo. - Captura con rrweb. El widget usa rrweb para grabar el DOM y los cambios de la página, y los transmite como eventos
eventWithTime. Del lado del agente, el modal CobrowseSession los reproduce con elReplayerde rrweb en modoliveMode. - Acciones del agente. Los clics, scroll y escritura del agente se traducen a referencias xpath y se envían al cliente, sin exponer el bus del workspace (canal por sesión, no por workspace).
- Proxy de archivos. Si la página del cliente carga PDFs o documentos privados desde S3, Omnifox los sirve por
/file-proxy(same-origin) para evitar problemas de CORS, igual que/img-proxypara imágenes. - Watchdogs. Tareas programadas que corren cada minuto cierran sesiones por timeout o stale (sin actividad), liberando la concurrencia de Redis. Así una pestaña cerrada de golpe no deja la sesión "viva" para siempre.
Verificación
- Inicia una sesión de prueba con la org [email protected] y confirma que ves el DOM del cliente en el modal.
- Revisa que el canal usado sea
private-cobrowse.{id}(no un canal de workspace). - Cierra la pestaña del cliente y comprueba que, en menos de ~2 minutos, la sesión figure cerrada.
Si no funciona
- El botón Co-browse no aparece: revisa que el add-on esté activo en el plan (
CobrowseGate) y que el cliente tenga presencia en vivo. - El widget no conecta al canal: suele ser el token de un solo uso ya consumido (recarga la solicitud) o Reverb caído.
- El widget muestra versión vieja tras un deploy: Cloudflare cachea
/widget/*. Purga la zonaomnifox.iotras desplegarcobrowse.js. - PDFs o imágenes no cargan: verifica que pasen por
/file-proxye/img-proxy; un recurso directo a S3 fallará por CORS.
Tips
- El bundle del cliente vive aparte (
public/widget/cobrowse.js) y se compila con su propia config de Vite; no lo mezcles con el build de la app. - Co-browse en producción es la fuente autoritativa: haz pull antes de editar archivos de cobrowse, nunca sincronices dev→prod a ciegas.
Artículos relacionados
Artículos relacionados
-
Qué es Co-browse y cómo activarlo
Co-browse te deja ver la pantalla del cliente en tiempo real para guiarlo mejor. Aprende a activarlo.
-
Guía completa del co-browse (co-navegación)
El co-browse a fondo, en 32 capítulos: permisos, radar, consentimiento, control remoto, enmascarado, marcas, llamada de voz y tiempo límite, todo real.
-
Co-browse: niveles y precios del complemento
Co-browse se contrata aparte en cualquier plan: Standard 50 USD/mes (3 sesiones simultáneas), Pro 90 (6), Business 150 (10) y Enterprise a medida.
-
Cómo iniciar una sesión de Co-browse con un cliente
Paso a paso para invitar al cliente a compartir su pantalla y guiarlo en tiempo real.
-
Requisitos previos para usar Co-browse
Antes de iniciar tu primera sesión de Co-browse, revisa el add-on, los permisos y la condición del canal Webchat.