Proprietários: API pública do widget e masking avançado

Use window.OmnifoxCobrowse.mask() e o atributo data-rrweb-mask para ocultar campos sensíveis sob medida na conavegação.

Jun 26, 2026

Veja este passo no vídeo · O que o cliente digita fica oculto

O que é e quando serve

A conavegação do Omnifox oculta por padrão senhas e dados de cartão antes de o agente ver qualquer coisa. Mas se o seu site tem campos sensíveis "sob medida" (um componente de pagamento próprio, um campo de CPF feito com <div contenteditable>, um seletor custom), o detector automático pode não reconhecê-los. Para esses casos o widget expõe uma API pública em window.OmnifoxCobrowse, pensada para os proprietários do site.

Importante: o mascaramento acontece no navegador do cliente, antes de o DOM ser enviado. Um campo marcado nunca chega ao agente.

Requisitos

  • Add-on de Conavegação ativo na sua organização (Faturamento → Co-browse).
  • O widget de Webchat instalado no seu site (o bundle cobrowse.js carrega sob demanda quando uma sessão começa).

A API pública

Enquanto há uma sessão ativa, window.OmnifoxCobrowse oferece:

  1. OmnifoxCobrowse.mask(selectorOrElement) — marca um elemento (ou todos que combinem com um seletor CSS) como oculto. Retorna quantos elementos marcou.
  2. OmnifoxCobrowse.getState() — retorna o estado atual (idle, awaiting_consent, connecting, streaming, ended). Útil para depurar.
  3. OmnifoxCobrowse.start(params) / OmnifoxCobrowse.end(reason?) — usados internamente pelo widget; normalmente você não os chama.

Passos para ocultar seus próprios campos

  1. Identifique o seletor CSS do campo sensível (por exemplo #cartao-custom ou .input-cvv).
  2. Chame a API assim que o campo existir no DOM:
if (window.OmnifoxCobrowse) {
  window.OmnifoxCobrowse.mask('#cartao-custom');
  window.OmnifoxCobrowse.mask('.input-cvv');
}
  1. Se o seu app é uma SPA e o campo aparece depois, chame mask() de novo após renderizá-lo. A chamada é idempotente — marcar duas vezes não causa problema.

Alternativa sem código: o atributo data-rrweb-mask

Se preferir não mexer em JavaScript, adicione data-rrweb-mask="true" direto no HTML do elemento. Ele oculta tanto o valor digitado quanto o texto renderizado (ideal para um <span> que mostre um número de cartão já carregado). O widget respeita esse atributo, e o detector automático marca campos com ele mesmo.

Verificação

  1. Inicie uma sessão de teste pela Caixa de entrada (botão Iniciar conavegação).
  2. Na visão do agente, digite nos seus campos custom: devem aparecer como um bloco oculto, não o conteúdo real.
  3. No console do navegador do cliente, window.OmnifoxCobrowse.getState() deve retornar streaming.

Se não funcionar

  • window.OmnifoxCobrowse é undefined: o bundle ainda não carregou. Ele só existe durante uma sessão — envolva suas chamadas em if (window.OmnifoxCobrowse).
  • O campo continua visível: verifique se o seletor combina (teste com document.querySelectorAll('#seu-seletor')). Se o elemento é recriado, reaplique mask().
  • Quer ocultar um contêiner inteiro: marque o contêiner; o mascaramento aplica à subárvore renderizada.

Dicas

  • Formulários de pagamento de terceiros embutidos num <iframe> não são transmitidos, então já estão protegidos.
  • Combine a API com palavras-chave: nomear inputs com termos como cartao ou cvv faz o detector ocultá-los sozinho.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp