Solução de problemas de conavegação

Botão ausente, falta de consentimento, timeout, controle remoto, anotações, áudio, permissões, dados visíveis e desempenho: causas e soluções.

Jun 26, 2026

Veja este passo no vídeo · Problemas comuns

O que é e quando ajuda

Este guia reúne os problemas mais comuns da conavegação e como resolvê-los, agrupados por sintoma. Serve tanto para agentes quanto para administradores.

O botão de conavegação não aparece

O botão Iniciar conavegação (ao lado do botão de chamada no cabeçalho do chat) só aparece quando as três condições são atendidas:

  1. A conversa é de Webchat. WhatsApp, Instagram, SMS, etc. não têm DOM para compartilhar, então o botão não é exibido.
  2. A organização tem o add-on de Conavegação ativo (Faturamento → Co-browse).
  3. Seu usuário tem a permissão Co-browse habilitada pelo admin (Configurações → Membros do espaço, coluna Co-browse).

Se faltar o add-on ou a permissão, em alguns casos você verá o ícone esmaecido com um tooltip explicando ("peça ao admin para ativar o add-on" / "seu admin não te deu permissão para conavegar").

O cliente não dá consentimento

Ao iniciar, o agente vê "Aguardando consentimento do cliente…". O cliente recebe o banner "Pedido de compartilhar tela" com Aceitar / Recusar.

  • Se o cliente tocar Recusar, você verá "O cliente recusou o pedido" e a sessão não inicia. Peça de novo pelo chat.
  • Se não responder, o pedido fica pendente. Toque em Cancelar e tente de novo.
  • O banner não aparece do lado do cliente? Ele precisa ter o Webchat aberto numa aba ativa; numa aba em segundo plano o widget pode não carregar o bundle.

A sessão é encerrada por tempo ("timeout")

As sessões têm um limite de duração definido pelo plano do add-on. Perto do fim, os dois lados veem um aviso ("Faltam X segundos"). Ao expirar, o agente vê "Sessão encerrada por limite de tempo". Inicie novamente se precisar de mais tempo.

O controle remoto não responde

Seus cliques, rolagem e digitação são espelhados ao cliente (você verá o aviso "Seus cliques, rolagem e digitação são espelhados ao cliente").

  • Se nada acontece do lado do cliente, verifique se o modo Pausar está ativo: em pausa o DOM congela. Toque em Retomar.
  • Alguns elementos do site do cliente (iframes de terceiros, menus nativos do SO) não podem ser controlados remotamente.
  • Uma conexão ruim mostra "Reconectando…"; aguarde alguns segundos para restabelecer.

As anotações não aparecem

Na barra de ferramentas você tem Desenhar, Destacar e Limpar marcas.

  • Ative Desenhar e arraste sobre a área; solte para enviar o traço.
  • Destacar cria um halo pulsante no ponto que você tocar.
  • Limpar marcas apaga tudo o que foi desenhado. Se as marcas não aparecem, confirme que a sessão está em streaming e não em pausa.

O áudio (chamada de voz) falha

Na sessão você pode tocar Ligar para uma chamada de voz pelo navegador.

  • "Não foi possível acessar o microfone. Verifique as permissões do navegador": o cliente (ou você) bloqueou o microfone. Habilite nas permissões do site e tente de novo.
  • "Seu navegador não suporta chamadas de voz": use um navegador moderno (Chrome, Edge, Safari recentes).
  • Para encerrar a chamada sem encerrar a sessão, toque em Desligar.

Permissões: um agente não consegue conavegar

Peça ao admin para ir em Configurações → Membros do espaço e marcar a caixa Co-browse desse agente. A permissão também é validada no servidor, então sem ela a ação é bloqueada mesmo se forçada.

Aparecem dados sensíveis que não deveriam

Senhas e cartões são ocultados sozinhos, mas um campo "sob medida" pode escapar. Oculte-o com o atributo data-rrweb-mask="true" ou com window.OmnifoxCobrowse.mask('#campo'). Veja o artigo de masking avançado.

Está lento ou travado

  • A conavegação transmite o DOM ao vivo; em páginas muito pesadas ou com conexão fraca pode haver atraso.
  • Use Pausar enquanto o cliente não precisa te mostrar nada, para aliviar o stream.
  • Feche abas ou apps que consomem banda dos dois lados.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp