Propietarios: API pública del widget y masking avanzado

Usa window.OmnifoxCobrowse.mask() y el atributo data-rrweb-mask para ocultar campos sensibles a medida en la co-navegación.

Jun 26, 2026

Mira este paso en el video · Lo que escribe el cliente queda oculto

Qué es y cuándo te sirve

La co-navegación de Omnifox enmascara por defecto las contraseñas y los datos de tarjeta antes de que el agente vea nada. Pero si tu sitio tiene campos sensibles "a medida" (un componente de pago propio, un input de cédula dibujado con <div contenteditable>, un selector custom), el detector automático puede no reconocerlos. Para esos casos el widget expone una API pública que vive en window.OmnifoxCobrowse, pensada para los propietarios del sitio.

Importante: el enmascarado se hace en el navegador del cliente, antes de enviar el DOM. Un campo marcado nunca viaja al agente.

Requisitos

  • Add-on de Co-navegación activo en tu organización (Facturación → Co-browse).
  • El widget de Webchat instalado en tu sitio (el bundle cobrowse.js se carga solo cuando empieza una sesión).

La API pública

Cuando hay una sesión activa, window.OmnifoxCobrowse ofrece:

  1. OmnifoxCobrowse.mask(selectorOrElement) — marca como oculto un elemento (o todos los que matcheen un selector CSS). Devuelve cuántos elementos marcó.
  2. OmnifoxCobrowse.getState() — devuelve el estado actual (idle, awaiting_consent, connecting, streaming, ended). Útil para depurar.
  3. OmnifoxCobrowse.start(params) y OmnifoxCobrowse.end(reason?) — los usa el widget internamente; normalmente no los llamas tú.

Pasos para enmascarar campos propios

  1. Identifica el selector CSS de tu campo sensible (por ejemplo #tarjeta-custom o .input-cvv).
  2. Llama a la API en cuanto el campo exista en el DOM:
if (window.OmnifoxCobrowse) {
  window.OmnifoxCobrowse.mask('#tarjeta-custom');
  window.OmnifoxCobrowse.mask('.input-cvv');
}
  1. Si tu app es una SPA y el campo aparece después, vuelve a llamar mask() tras renderizarlo. La llamada es idempotente: marcar dos veces no rompe nada.

Alternativa sin código: el atributo data-rrweb-mask

Si prefieres no tocar JavaScript, agrega el atributo data-rrweb-mask="true" directamente en el HTML del elemento. Oculta tanto el valor escrito como el texto renderizado (ideal para un <span> que muestre un número de tarjeta ya cargado). El widget también respeta la clase, y el detector automático tagea con ese mismo atributo.

Verificación

  1. Inicia una sesión de prueba desde la Bandeja de entrada (botón Iniciar co-navegación).
  2. En la vista del agente, escribe en tus campos custom: deben verse como un bloque redactado, no el contenido real.
  3. En la consola del navegador del cliente, window.OmnifoxCobrowse.getState() debe devolver streaming.

Si no funciona

  • window.OmnifoxCobrowse es undefined: el bundle aún no se cargó. Solo existe durante una sesión; envuelve tus llamadas en if (window.OmnifoxCobrowse).
  • El campo sigue visible: revisa que el selector matchee (pruébalo con document.querySelectorAll('#tu-selector')). Si el elemento se recrea, re-aplica mask().
  • Quieres ocultar un contenedor entero: marca el contenedor; el enmascarado aplica al subárbol renderizado.

Tips

  • Para formularios de pago de terceros embebidos en un <iframe>, el contenido del iframe no se transmite, así que ya está protegido.
  • Combina la API con palabras clave: si nombras tus inputs con términos como tarjeta o cvv, el detector los oculta solo.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp