Navegação

Solução de Problemas

Problemas comuns e soluções para problemas de integração do AI Anywhere.

Leitura de 9 min

Se você estiver enfrentando problemas com o AI Anywhere, este guia cobre os problemas mais comuns e suas soluções. Comece por aqui antes de entrar em contato com o suporte.

Botão do Assistente Não Aparecendo

Você vê botões de ajuda duplicados ao lado da mesma área de texto.

Soluções Possíveis:

  • Limpe o cache do navegador: Atualize sua página forçadamente (Ctrl+Shift+R no Windows/Linux, Cmd+Shift+R no Mac) para garantir que você\
  • Verifique se o script está carregado: Abra as ferramentas de desenvolvedor do navegador (F12), vá para a aba Console e procure por erros de JavaScript. Certifique-se de que o script está carregando sem erros.
  • Verifique a colocação do snippet: Certifique-se de que a tag do script está na <head> seção, não na <body>. O script deve carregar antes do conteúdo da página.
  • Verifique as áreas de texto: O Assistente só aparece ao lado de <textarea> e <input type="text"> elementos. Certifique-se de que esses elementos existem na sua página.
  • Verifique o seletor: Verifique novamente se o seu seletor CSS está correto e se direciona para um elemento de área de texto real na sua página.
  • Desative bloqueadores de anúncios: Alguns bloqueadores de anúncios ou extensões de privacidade podem interferir com o script do Assistente. Teste em uma janela anônima/privada.

Erros de Política de Segurança de Conteúdo (CSP)

O console do seu navegador mostra violações de CSP que impedem o carregamento do script.

Solução: Adicione ai-anywhere.ai à sua Política de Segurança de Conteúdo\ script-src diretiva.
Content-Security-Policy: script-src 'self' https://ai-anywhere.ai;

Se estiver usando meta tags no HTML:

<meta http-equiv="Content-Security-Policy" 
      content="script-src 'self' https://ai-anywhere.ai;">

Botão do Assistente Não Respondendo

O botão do Assistente aparece, mas nada acontece quando clicado.

Soluções Possíveis:

  • Verifique o console do navegador: Abra as ferramentas de desenvolvedor (F12) e procure por mensagens de erro que possam indicar problemas de autenticação ou de rede.
  • Verifique as solicitações de rede: No separador Rede das ferramentas de desenvolvedor, verifique se as solicitações de API para AI Anywhere estão sendo bem-sucedidas (status 200) e não estão sendo bloqueadas.
  • Teste com um navegador diferente: Elimine problemas específicos do navegador testando no Chrome, Firefox ou Safari.
  • Desative as extensões do navegador: Algumas extensões podem interferir na execução do JavaScript. Teste com as extensões desativadas.

Vários Botões de Ajuda Aparecendo

Você vê botões de ajuda duplicados ao lado da mesma área de texto.

Causa: Isto geralmente acontece quando o trecho de código é incluído várias vezes na mesma página, ou quando frameworks JavaScript re-renderizam componentes.

Soluções:

  • Verifique se há trechos duplicados: Procure no seu HTML/modelos para garantir que a tag de script apareça apenas uma vez no <head> seção.
  • React/Vue/Angular: Garanta que o script seja carregado apenas uma vez usando useEffect (React) ou hooks montados, e adicione uma proteção para evitar recarregamento.
  • Use uma proteção de carregamento: Verifique se o script já existe antes de adicioná-lo:
    if (!document.querySelector('script[src*="ai-anywhere.ai"]')) { // Add script here }

Problemas de Desempenho ou Carregamento

O script de Ajuda está desacelerando o carregamento da sua página ou causando problemas de desempenho.

Soluções:

  • Use carregamento assíncrono: Adicione async atributo na tag de script (embora nosso script já carregue assíncronamente).
  • Adie o carregamento do script: Se sua página tiver muitos scripts, considere carregar o script de Ajuda com defer atributo para carregá-lo após a análise da página.
  • Verifique o tempo de rede: Use o separador Rede das DevTools do navegador para ver se o script está demorando mais do que o normal para baixar.
  • Otimize sua página: O script de Ajuda é leve (~50KB), mas se sua página já estiver lenta, otimize outros recursos primeiro.

Conflitos de Estilo

O botão do Assistente não combina com o design do seu site ou conflita com seu CSS.

Soluções:

  • Substitua com CSS: Use seletores mais específicos ou !important para substituir os estilos do Assistente:
    .ai-helper-button { background-color: #your-color !important; border-radius: 8px !important; }
  • Use a personalização de tema: Configure as cores e estilos dos botões nas configurações do seu Assistente para combinar com sua marca.
  • Verifique a especificidade do CSS: Certifique-se de que seus estilos personalizados tenham maior especificidade CSS do que os estilos padrão do Assistente.

Problemas de Compatibilidade com Navegadores

O Ajuda funciona em alguns navegadores, mas não em outros.

Navegadores Suportados: O AI Anywhere é compatível com todos os navegadores modernos, incluindo Chrome, Firefox, Safari, Edge e Opera. O Internet Explorer 11 e versões anteriores não são suportados.

Se os problemas persistirem:

  • Atualize seu navegador: Certifique-se de que está usando a versão mais recente do seu navegador.
  • Verifique se o JavaScript está ativado: Verifique se o JavaScript está ativado nas configurações do seu navegador.
  • Teste no modo anônimo: Elimine conflitos de extensões testando no modo privado/anônimo.
Ainda precisa de ajuda?

Se nenhuma dessas soluções resolver o seu problema, verifique o console do navegador para mensagens de erro específicas e entre em contato com nossa equipe de suporte com:

  • A mensagem de erro do console do seu navegador
  • Seu navegador e versão
  • O nome e o seletor do seu Assistente
  • Uma descrição do que você esperava versus o que aconteceu