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.
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
F12e va para a aba Console.
Passos para diagnosticar
-
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>. -
Verifique se o seu site usa HTTPS. O
loader.jse servido por HTTPS e os navegadores bloqueiam mixed content: se a sua pagina carrega porhttp://, o script nao roda. Migre o site para HTTPS. -
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 bloqueandoomnifox.io. Adicionehttps://omnifox.ioascript-srceconnect-src. - Bloqueadores de anuncios/privacidade podem travar o widget; teste com eles desativados.
-
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. -
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 nobody. - 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
Artigos relacionados
-
Códigos de erro do WhatsApp (Meta): o que significam e o que fazer
Tabela com os códigos de erro da Meta mais comuns ao enviar pelo WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) e como resolver cada um.
-
Como conectar o Telegram
Conecte um bot do Telegram à sua caixa de entrada do Omnifox em minutos usando o BotFather.
-
Comentários do Instagram e do Facebook: responder e moderar pelo Omnifox
Veja e responda os comentários das suas publicações e anúncios do Facebook e do Instagram, em público ou no privado, e configure respostas automáticas.
-
Enviar e receber vídeos em cada canal: formatos e tamanhos máximos
Quais vídeos você pode enviar e receber pelo WhatsApp, Instagram, Messenger, Telegram, chat do site e e-mail, com os tamanhos máximos reais e o que fazer com um vídeo pesado.
-
Conectar o WhatsApp escaneando um código QR
Vincule seu WhatsApp ao Omnifox em um minuto, como no WhatsApp Web. Ideal para testar: tem limites, não permite campanhas e não é a API oficial.