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.
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.jsse carga solo cuando empieza una sesión).
La API pública
Cuando hay una sesión activa, window.OmnifoxCobrowse ofrece:
OmnifoxCobrowse.mask(selectorOrElement)— marca como oculto un elemento (o todos los que matcheen un selector CSS). Devuelve cuántos elementos marcó.OmnifoxCobrowse.getState()— devuelve el estado actual (idle,awaiting_consent,connecting,streaming,ended). Útil para depurar.OmnifoxCobrowse.start(params)yOmnifoxCobrowse.end(reason?)— los usa el widget internamente; normalmente no los llamas tú.
Pasos para enmascarar campos propios
- Identifica el selector CSS de tu campo sensible (por ejemplo
#tarjeta-customo.input-cvv). - 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');
}
- 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
- Inicia una sesión de prueba desde la Bandeja de entrada (botón Iniciar co-navegación).
- En la vista del agente, escribe en tus campos custom: deben verse como un bloque redactado, no el contenido real.
- En la consola del navegador del cliente,
window.OmnifoxCobrowse.getState()debe devolverstreaming.
Si no funciona
window.OmnifoxCobrowseesundefined: el bundle aún no se cargó. Solo existe durante una sesión; envuelve tus llamadas enif (window.OmnifoxCobrowse).- El campo sigue visible: revisa que el selector matchee (pruébalo con
document.querySelectorAll('#tu-selector')). Si el elemento se recrea, re-aplicamask(). - 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
tarjetaocvv, el detector los oculta solo.
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.