Simple Agent
Criar meu agente
Docstroubleshooting

Widget não carrega

Diagnóstico passo a passo para quando o widget Simple Agent não aparece no seu site.

Se o widget não está aparecendo após instalar o snippet, siga este diagnóstico em ordem.

1. Confirme que o snippet está no HTML

Abra o código-fonte da página (Ctrl+U / Cmd+U) e busque por simple-agent.me/widget/loader.js.

Se não encontrar, o snippet não foi adicionado corretamente. Confirme que está colado antes de </body>, não no <head> ou dentro de um componente que não renderiza no servidor.

2. Verifique o Console do browser

Abra DevTools → aba Console e recarregue a página. Procure erros relacionados ao Simple Agent:

Erro: net::ERR_BLOCKED_BY_CLIENT

O widget está sendo bloqueado por ad blocker (uBlock Origin, Brave Shields, etc.). Isso é esperado para alguns usuários — o widget usa Shadow DOM para minimizar esse problema, mas bloqueadores agressivos ainda podem bloquear.

Solução para testes: Desative o ad blocker temporariamente. Solução para produção: Isso afeta ~10-15% dos usuários. Não há solução completa — o Simple Agent minimiza o impacto usando o domínio widget.simple-agent.me que tem baixa taxa de bloqueio.

Erro: Refused to load script from 'https://simple-agent.me/widget/loader.js' because it violates CSP

Seu site tem um Content Security Policy que bloqueia scripts externos.

Solução: Adicione ao seu CSP:

script-src 'self' https://simple-agent.me https://simple-agent.me;
connect-src 'self' https://simple-agent.me/api;
frame-src 'self' https://simple-agent.me;

Erro: data-agent-id is required

O atributo data-agent-id está ausente ou vazio no snippet.

Solução: Copie o snippet diretamente do dashboard do agent — ele já inclui o ID correto.

3. Verifique o Network

DevTools → Network → filtre por widget. Confirme que o script está sendo carregado com status 200.

Se 404: o data-agent-id está incorreto. Copie novamente do dashboard.

Se 403: seu domínio não está na lista de domínios autorizados do agent.

Solução para 403:

  1. Dashboard → agent → Segurança
  2. Em Domínios permitidos, adicione seudominio.com (sem https://)
  3. Salve e recarregue

4. Verifique conflitos de CSS

O widget usa Shadow DOM para isolar seus estilos, mas em alguns casos CSS global (* { display: none }, z-index: -1 em body) pode afetar o container.

Teste rápido: Abra o console e execute:

document.querySelector('#cbk-host')

Se retornar null: o script não terminou de carregar. Aguarde 3-5 segundos e tente novamente.

Se retornar o elemento mas o widget não aparecer: inspecione o elemento e verifique se display está como none ou se z-index está sendo sobrescrito.

5. WordPress / plugins de cache

Se você usa um plugin de cache (WP Rocket, W3 Total Cache, etc.), o snippet pode estar em cache numa versão antiga sem o data-agent-id.

Solução: Limpe o cache do plugin e recarregue a página.

6. Widget aparece mas em posição errada

Se o widget aparece mas está fora da tela ou sobreposto a outros elementos:

  • Verifique se algum elemento pai tem overflow: hidden que corte o widget
  • O widget usa position: fixed — confirme que não há transform ou filter num elemento pai (isso quebra position: fixed)
  • Para mudar a posição: adicione data-position="bottom-left" ao snippet

Ainda não funcionou?

Se nenhum dos passos acima resolveu, abra um ticket com:

  1. URL da página onde o widget deveria aparecer
  2. Screenshot do console com erros
  3. Navegador e versão
  4. Se usa SPA (React/Vue/Angular)

Suporte → · Chat não responde → · Embed & Integração →