Ir para o conteúdo

Solução de Problemas

Problemas comuns e como corrigi-los. Para cada problema, comece com a primeira correção sugerida — é a causa mais provável.

O Widget não aparece no meu site

  1. Verifique o painel — Abra a URL do seu dashboard diretamente. Se não carregar, o servidor pode estar fora do ar — entre em contato com seu gerente de conta.
  2. Verifique o data-bot-id — O ID do bot no seu código de incorporação deve corresponder ao slug real do seu bot. Verifique em Dashboard → Embed.
  3. Verifique o data-backend-url — Deve incluir o protocolo (https://) e o domínio correto.
  4. Verifique o console do navegador — Abra o DevTools (F12) → Console para procurar erros de JavaScript.

O Widget aparece, mas o bot não responde

  1. Verifique o indicador de integridade do LLM — Se estiver vermelho, o OpenRouter está desconectado. Vá em Settings → AI Engine e reconecte.
  2. Verifique se um modelo está selecionado — Um modelo de IA deve ser escolhido no menu suspenso.
  3. Verifique a base de conhecimento — Se estiver vazia, o bot pode responder de forma genérica ou não responder. Adicione conteúdo em Knowledge Base.

O histórico do chat não persiste ao recarregar a página

  1. LocalStorage deve estar ativado — O widget armazena os dados da sessão no localStorage do navegador. O modo privado/incógnito pode bloquear isso.
  2. O Bot ID deve ser consistente — Se o data-bot-id for diferente entre as páginas, o widget as tratará como bots separados com históricos separados.

Domínio personalizado não funciona

  1. Aguarde a propagação do DNS — As alterações podem levar de 5 a 30 minutos.
  2. Verifique o registro A — Verifique o painel de controle do seu provedor de DNS para confirmar se o registro A aponta para o IP do seu servidor.
  3. Tente renovar o SSL — Vá em Settings → Custom Domain → Renew SSL.
  4. Usuários Cloudflare — Certifique-se de que o modo SSL está configurado como Full (Strict).
  5. Entre em contato com seu gerente de conta se o problema persistir após a propagação do DNS.

As configurações não salvam

  1. Verifique o indicador de integridade do DB — Ele deve estar verde no topo da página.
  2. Atualize a página — As configurações são armazenadas em cache; uma atualização força uma nova leitura.
  3. Entre em contato com seu gerente de conta se o indicador do DB estiver vermelho.

O Dashboard carrega, mas não mostra dados

  1. Verifique os indicadores de integridade — Se o DB ou VEC estiverem vermelhos, um serviço de backend pode precisar de atenção.
  2. Atualize a página — Os dados podem não ter sido carregados na primeira visita.
  3. Entre em contato com seu gerente de conta se os indicadores permanecerem vermelhos.

Teste de integração falhou

  1. Verifique as credenciais — Chaves de API, senhas SMTP e URLs de Webhook devem estar atualizadas.
  2. Verifique os logs de atividade (Activity Logs) — Filtre pelo módulo de Integrações para mensagens de erro detalhadas.
  3. Teste o serviço externo — Confirme se o endpoint do webhook, o servidor SMTP ou a API estão acessíveis.

O Bot responde de forma genérica (ignora a base de conhecimento)

  1. Verifique os Sync Jobs — Arquivos/URLs podem ainda estar em processamento. Aguarde o status Completed.
  2. Atualize a base de conhecimento — Vá em Knowledge Base e clique em Refresh.
  3. Revise o prompt de sistema — Instruções conflitantes em Settings → Model Behavior podem anular a recuperação da base de conhecimento.
  4. Adicione FAQs — Para perguntas críticas, adicione um FAQ com a resposta exata. FAQs têm prioridade.

Mensagens de WhatsApp não chegam

  1. Verifique o status do serviço de WhatsApp — Vá em Settings → WhatsApp e verifique se o serviço está Running.
  2. Verifique o health check da API — O indicador de status deve estar verde.
  3. Verifique a sessão do código QR — Se desconectado, escaneie o código QR novamente.
  4. Entre em contato com seu gerente de conta se o serviço não iniciar.

O desempenho está lento

  1. Mude para um modelo de IA mais rápido — Gemini Flash ou Claude Haiku para menor latência. Veja AI Models.
  2. Reduza o máximo de tokens — Diminua o limite de comprimento da resposta em Settings → Model Behavior.
  3. Base de conhecimento enxuta — Remova documentos obsoletos para acelerar a busca.
  4. Adicione FAQs — Perguntas comuns respondidas por FAQs ignoram completamente o modelo de IA.
  5. Entre em contato com seu gerente de conta se a lentidão persistir — o servidor pode precisar de um upgrade de recursos.

Ainda precisa de ajuda?

  • Verifique os Activity Logs no dashboard para mensagens de erro.
  • Entre em contato com seu gerente de conta com uma descrição do problema e quaisquer mensagens de erro que você encontrar.