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.

Jun 26, 2026

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

  1. 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.
  2. Solicitud de sesión. El agente pulsa Co-browse y se emite el evento cobrowse.session.requested por 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.
  3. 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.
  4. 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 el Replayer de rrweb en modo liveMode.
  5. 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).
  6. 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-proxy para imágenes.
  7. 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 zona omnifox.io tras desplegar cobrowse.js.
  • PDFs o imágenes no cargan: verifica que pasen por /file-proxy e /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

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp