Pular para o conteúdo principal
ChattyBox Logo

Solução de problemas

Use esta página quando o widget estiver instalado, mas não se comportar conforme o esperado.

O widget não aparece​

Verifique primeiro o console do navegador. ChattyBox relata atributos obrigatórios ausentes.

Causas comuns:

  • O script não está presente na origem da página implementada.
  • O script foi adicionado ao modelo, layout, contêiner do gerenciador de tags ou área de código CMS errados.
  • O script está por trás de uma regra de consentimento ou acionador do gerenciador de tags que não foi acionado.
  • O mesmo shell do aplicativo remove o script durante a navegação do lado do cliente.
  • Uma política de segurança de conteúdo bloqueia https://chattybox.ai/widget.js.
  • CSS ou outro widget se sobrepõe ao inicializador.

Menor correção:

  1. Abra a página pública implantada em uma janela anônima.
  2. Fonte da página de pesquisa para chattybox.ai/widget.js.
  3. Confirme se o script aparece uma vez e inclui data-api-key e data-api-url.
  4. Mova o script para o rodapé global, layout do aplicativo, raiz Docusaurus ou gatilho GTM Todas as páginas se estiver ausente.

Faltando data-api-url​

O widget é encerrado mais cedo quando data-api-url está faltando.

Use o snippet completo do painel ou adicione o atributo obrigatório:

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="https://app.chattybox.ai"
  async
></script>

Se o seu painel mostrar um URL API diferente, use o valor do painel em vez do valor de exemplo.

Chave API inválida ou erros de origem​

Causas comuns:

  • A chave pública do widget foi copiada incorretamente.
  • A chave foi excluída, expirou ou criada para um projeto diferente.
  • Uma chave de preparação foi implantada na produção ou uma chave de produção foi implantada na preparação.
  • A chave permitiu origens e a origem do site atual não está incluída.
  • A página é carregada de http://localhost, um URL de visualização ou um domínio personalizado que não é permitido para essa chave.

Correções:

  1. Abra o projeto no painel ChattyBox.
  2. Copie um novo snippet da guia Incorporar.
  3. Se as origens permitidas estiverem configuradas, adicione a origem exata que atende a página, incluindo protocolo e nome do host.
  4. Reimplante ou republice o site e teste novamente em uma janela anônima.

Idioma errado​

O widget escolhe o idioma nesta ordem:

  1. data-locale no script do widget.
  2. O valor da página <html lang>.
  3. O idioma do navegador do visitante.
  4. Recuo inglês.

Correções:

  • Remova um valor data-locale incorreto se a página precisar detectar automaticamente o idioma.
  • Defina <html lang="de">, <html lang="fr"> ou o código do idioma correspondente nas páginas localizadas.
  • Adicione data-locale="de" somente quando uma página precisar forçar um idioma de UI de widget específico.
  • Raspe novamente todas as versões de idioma se as respostas citarem ou recuperarem conteúdo do idioma errado.

Sem citações ou respostas fracas​

ChattyBox respostas do conteúdo indexado. Citações faltantes ou respostas fracas geralmente significam que o conteúdo fonte necessário não foi recuperado ou não responde claramente à pergunta.

Correções:

  • Faça a mesma pergunta no chat de teste do painel e compare as páginas citadas.
  • Certifique-se de que a página de origem seja pública e incluída no rastreamento.
  • Adicione títulos claros, exemplos, perguntas frequentes e texto de resposta direto à página de origem.
  • Evite confiar em capturas de tela, vídeos, acordeões ocultos ou conteúdo iframe como única fonte.
  • Raspe novamente a página atualizada e teste novamente.

Páginas não copiadas ou com conteúdo desatualizado​

Causas comuns:

  • A página está faltando no mapa do site enviado.
  • O modo URL manual não incluiu a página.
  • A página redireciona, bloqueia rastreadores, requer autenticação ou é excluída pelas regras de robôs.
  • O conteúdo da página mudou após a última raspagem.
  • O conteúdo é renderizado de forma que o rastreador não consiga extrair texto útil.

Correções:

  1. Confirme se a página abre publicamente em uma janela privada do navegador.
  2. Use o modo mapa do site para ampla cobertura ou URLs manuais para um conjunto selecionado.
  3. Envie o URL canônico em vez de um URL de rastreamento, URL de redirecionamento ou URL de login.
  4. Raspe novamente após publicar alterações de conteúdo.
  5. Verifique o painel em busca de páginas com falha ou ignoradas.

Ainda preso​

Colete estes detalhes antes de entrar em contato com o suporte:

  • O URL da página pública onde o widget deve aparecer.
  • Uma captura de tela ou cópia de qualquer erro no console do navegador.
  • Se a página usa HTML, Next.js, Docusaurus, WordPress simples, um CMS ou Google Tag Manager simples.
  • Se o snippet inclui data-api-key e data-api-url.
  • Uma pergunta de teste que deve funcionar e a página de origem que a responde.