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.
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.jscarrega sob demanda quando uma sessão começa).
A API pública
Enquanto há uma sessão ativa, window.OmnifoxCobrowse oferece:
OmnifoxCobrowse.mask(selectorOrElement)— marca um elemento (ou todos que combinem com um seletor CSS) como oculto. Retorna quantos elementos marcou.OmnifoxCobrowse.getState()— retorna o estado atual (idle,awaiting_consent,connecting,streaming,ended). Útil para depurar.OmnifoxCobrowse.start(params)/OmnifoxCobrowse.end(reason?)— usados internamente pelo widget; normalmente você não os chama.
Passos para ocultar seus próprios campos
- Identifique o seletor CSS do campo sensível (por exemplo
#cartao-customou.input-cvv). - Chame a API assim que o campo existir no DOM:
if (window.OmnifoxCobrowse) {
window.OmnifoxCobrowse.mask('#cartao-custom');
window.OmnifoxCobrowse.mask('.input-cvv');
}
- 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
- Inicie uma sessão de teste pela Caixa de entrada (botão Iniciar conavegação).
- Na visão do agente, digite nos seus campos custom: devem aparecer como um bloco oculto, não o conteúdo real.
- No console do navegador do cliente,
window.OmnifoxCobrowse.getState()deve retornarstreaming.
Se não funcionar
window.OmnifoxCobrowseéundefined: o bundle ainda não carregou. Ele só existe durante uma sessão — envolva suas chamadas emif (window.OmnifoxCobrowse).- O campo continua visível: verifique se o seletor combina (teste com
document.querySelectorAll('#seu-seletor')). Se o elemento é recriado, reapliquemask(). - 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
cartaooucvvfaz o detector ocultá-los sozinho.
Artigos relacionados
Artigos relacionados
-
O que é Co-browse e como ativá-lo
O Co-browse permite ver a tela do cliente em tempo real para orientá-lo melhor. Aprenda a ativá-lo.
-
Co-browse: níveis e preços do complemento
O Co-browse é contratado à parte em qualquer plano: Standard 50 USD/mês (3 sessões simultâneas), Pro 90 (6), Business 150 (10) e Enterprise sob medida.
-
Guia completo do co-browse
O co-browse a fundo, em 32 capítulos: radar, visitantes identificados, consentimento, controle remoto, mascaramento, marcações, chamada de voz, troca de página e como a sessão termina, tudo real.
-
Como iniciar uma sessão de Co-browse com um cliente
Passo a passo para convidar o cliente a compartilhar a tela e orientá-lo em tempo real.
-
Pré-requisitos para usar o Co-browse
Antes de iniciar sua primeira sessão de Co-browse, verifique o add-on, as permissões e as condições do canal Webchat.