O widget de chat não aparece no site: como diagnosticar e corrigir

Abrir em

Ver como Markdown

Abrir no ChatGPT Abrir no Claude

Vitor

Última atualização em Oct 14, 2026

Se o widget de chat da Papo (https://papo.global/) não aparece no seu site, o diagnóstico começa verificando se o snippet de código está inserido corretamente antes da tag </body>, se há conflitos com plugins de cache ou otimização, e se a caixa de entrada do site permanece ativa no painel da Papo. Este guia reúne os passos para identificar e corrigir a falha rapidamente.

O widget de chat é o ponto de contato que transforma visitantes em conversas. Quando ele some, você perde oportunidades de atendimento. A boa notícia é que a maioria das falhas tem causas simples e soluções rápidas.

Causa Provável	Verificação Rápida	Solução Proposta
Snippet ausente ou mal posicionado	Inspecione o código-fonte da página (Ctrl+U) e procure pelo script do widget.	Reinsira o snippet exatamente antes do fechamento `</body>`, conforme gerado no painel.
Conflito com plugin de cache ou otimização	Teste o site em uma janela anônima/privada ou desative temporariamente plugins de cache.	Exclua o script do widget das regras de minificação/cache ou limpe o cache após inserir o snippet.
Caixa de entrada do site removida ou sem agentes	Acesse Configurações → Caixas de entrada e verifique se a caixa do tipo "Site" está listada e com agentes associados.	Recrie a caixa de entrada e associe pelo menos um agente; copie o novo snippet e atualize o site.
Script bloqueado por extensões de navegador	Abra o site em outro navegador ou sem extensões ativas.	Oriente os visitantes a desativarem bloqueadores de script para o domínio, ou revise configurações de segurança (CSP) do site.
Conflito com outro widget ou script	Verifique o console do navegador (F12) em busca de erros de JavaScript.	Corrija conflitos ajustando a ordem de carregamento ou isolando scripts.

Como diagnosticar a ausência do widget

Confirme que o snippet está no código-fonte
Abra a página do site, clique com o botão direito e selecione "Exibir código-fonte" (ou use Ctrl+U). Procure pelo script que começa com algo como <script src="... app.papo.global ...">. Se ele não aparecer, o snippet não foi adicionado ou foi removido.
Teste em uma janela anônima/privada
Muitas vezes, o navegador armazena uma versão em cache da página sem o widget. Abrir uma janela anônima ignora o cache local e carrega a versão mais recente do site. Se o widget aparecer nesse modo, o problema é cache e não o script em si.
Verifique o console do navegador
Pressione F12 para abrir as ferramentas do desenvolvedor e vá até a aba "Console". Erros em vermelho podem indicar que o script do widget está sendo bloqueado por políticas de segurança ou conflitando com outros scripts da página.
Confira se a caixa de entrada está ativa no painel Papo
Vá até Configurações → Caixas de entrada. Se a caixa criada para o site (tipo "Site") não estiver listada, ela pode ter sido excluída acidentalmente. Se estiver, verifique se ao menos um agente está associado — uma caixa sem agentes não carrega o widget corretamente.

Como corrigir os problemas mais comuns

Reinstalar o snippet corretamente

Se o código estiver ausente ou posicionado de forma errada, refaça o processo:

No painel Papo, em Configurações → Caixas de entrada, clique em Adicionar caixa e selecione Site.
Dê um nome à caixa e informe a URL do site.
Copie o script gerado e cole-o no HTML de todas as páginas onde o chat deve aparecer, imediatamente antes do fechamento </body>.
Associe ao menos um agente à caixa e salve.

Substituir o snippet antigo pelo novo garante que nenhum caractere tenha sido perdido em edições manuais.

Lidar com cache e plugins de otimização

Plugins de cache, minificação de JavaScript ou lazy loading podem impedir o script do widget de ser executado. Se você usa uma plataforma como WordPress, limpe todo o cache do site (servidor e plugin) após adicionar o snippet. Se possível, exclua o script do widget das regras de minificação ou combine-o apenas com scripts essenciais. Testar com todos os plugins de otimização desativados ajuda a isolar a causa.

Recriar a caixa de entrada e reconectar

Quando a caixa original foi removida ou o histórico de configuração se perdeu, o caminho mais seguro é criar uma nova. O processo é o mesmo da instalação inicial: crie a caixa do tipo Site, copie o novo snippet e substitua no código do site. Depois, associe os agentes e verifique se o widget carrega em uma janela anônima. O snippet antigo deixa de funcionar automaticamente nesse caso.

Para quem este guia é útil

Empresas que acabaram de instalar o widget e não o veem aparecer.
Operações que mudaram o tema ou fizeram atualizações no site e notaram o sumiço do chat.
Equipes que herdaram um site com o snippet já inserido e precisam diagnosticar por que o widget não carrega.
Quem quer evitar perda de leads por um canal de atendimento invisível.

Perguntas frequentes (FAQ)

O widget só não aparece para mim, mas meus clientes veem. Por quê?

Provavelmente é cache do seu navegador ou uma extensão bloqueando scripts no seu dispositivo. Teste em uma janela anônima ou em outro aparelho. Se o widget aparecer, o problema está local e não afeta os visitantes.

Instalei o snippet, mas o widget não aparece em páginas específicas. O que fazer?

Confira se o código foi colado no template que alimenta todas as páginas (por exemplo, o footer.php no WordPress) e não apenas em uma página isolada. Se houver regras condicionais de exibição no tema, talvez seja necessário ajustá-las para incluir o domínio correto.

Preciso recriar a caixa de entrada para corrigir o widget?

Nem sempre. Se a caixa ainda existe e possui agentes associados, apenas reinstalar o snippet costuma resolver. Recriar a caixa é a alternativa quando ela foi excluída ou quando o script original se perdeu e você não consegue recuperá-lo.

Meu site usa WordPress, há algo específico que devo verificar?

Sim. Plugins de cache (como WP Rocket, W3 Total Cache) e ferramentas de minificação podem bloquear o script do widget. Limpe o cache, desative temporariamente esses plugins para testar e, se necessário, exclua o script do widget das otimizações. Leia também o guia completo sobre a instalação no WordPress.

O widget aparecia e sumiu de repente. O que pode ter acontecido?

Alterações no tema do site, atualizações de plugins ou uma migração de servidor podem remover o snippet. Também é possível que a caixa de entrada do site tenha sido excluída do painel Papo. Verifique ambas as possibilidades: código-fonte e lista de caixas de entrada.

Como testar se o snippet está funcionando sem publicar no site oficial?

Você pode adicionar o script a uma página de teste em um ambiente de homologação ou em uma página oculta do próprio site. Enquanto a URL informada na caixa de entrada corresponder ao domínio onde o script está inserido, o widget carregará normalmente para você validar.