Solucao de problemas: o Webchat nao aparece no site

Instalou o snippet do Webchat mas o balao de chat nao aparece? Veja as causas mais comuns: snippet no lugar errado, HTTPS, CSP e erros no console do navegador.

Jun 26, 2026

Veja este passo no vídeo · Solução de problemas

O widget de Webchat e o balao de chat que voce incorpora no seu site. Quando voce cola o snippet e o balao nao aparece, quase sempre e por um de cinco motivos. Este guia percorre eles em ordem, do mais comum ao mais raro.

Antes de comecar

  • Voce precisa de um canal de Webchat ja criado em Canais -> Conectar canal -> Webchat.
  • Abra a pagina onde o balao deveria aparecer em uma janela anonima (para descartar cache e extensoes).
  • Deixe o console do navegador a mao: no Chrome/Edge aperte F12 e va para a aba Console.

Passos para diagnosticar

  1. Confirme que o snippet esta completo e no lugar certo. No canal de Webchat abra a aba Instalar (embed) e copie o codigo de novo. Ele deve ser assim e colado logo antes da tag </body>:

    <script src="https://omnifox.io/widget/loader.js" data-widget-key="..." async></script>
    

    Um erro classico e cola-lo dentro de um comentario, dentro de outro <script>, ou depois de </body>.

  2. Verifique se o seu site usa HTTPS. O loader.js e servido por HTTPS e os navegadores bloqueiam mixed content: se a sua pagina carrega por http://, o script nao roda. Migre o site para HTTPS.

  3. Olhe o console do navegador. Recarregue com o console aberto e procure linhas em vermelho. Sinais uteis:

    • Failed to load resource ... loader.js -> a pagina nao consegue alcancar a Omnifox (firewall, bloqueador, ou o snippet aponta para a URL errada).
    • Erros de CSP (Content-Security-Policy ... refused to load) -> seu cabecalho CSP esta bloqueando omnifox.io. Adicione https://omnifox.io a script-src e connect-src.
    • Bloqueadores de anuncios/privacidade podem travar o widget; teste com eles desativados.
  4. Confira o data-widget-key. Se voce editou na mao e ele ficou incompleto, o loader nao encontra o canal. Copie o snippet inteiro de novo na aba Instalar e nao altere essa string.

  5. Descarte o cache. Se voce usa Cloudflare, um plugin de cache ou um CDN, limpe o cache do site e teste de novo em janela anonima.

Como verificar que funcionou

A aba Instalar do canal tem um registro "Instalado em" com os dominios onde o loader foi carregado. Na primeira vez que alguem abre uma pagina com o seu snippet, o dominio anfitriao aparece ali. Se voce ve o seu dominio com um horario recente, a instalacao esta correta. Se aparece "No installations detected yet", o snippet ainda nao rodou em nenhum navegador.

Se ainda nao funciona

  • Teste em outro navegador e no celular: se aparece em um e nao em outro, e extensao ou cache local.
  • Se voce usa um construtor de sites (Wix, Squarespace) ou um <iframe>, confirme que ele permite inserir scripts personalizados no body.
  • Verifique se o canal de Webchat esta ativo e nao pausado em Canais.

Dicas

  • Mantenha o snippet no template global (rodape do tema) para que carregue em todas as paginas, nao so em uma.
  • Depois de mudar cor, nome ou saudacao do widget nao e preciso reinstalar: o loader le a configuracao ao vivo.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp