Documentação

FAQ

Por que minha busca no Maps não retorna resultados?

Verifique se a chave do Google Maps está salva em Configurações e se os produtos Places API (New) e Maps JavaScript API estão habilitados no Console do Google Cloud. Confirme também que a quota mensal não foi atingida — o limite gratuito é de 2.500 buscas por mês. Em caso de erro de CORS ou "REQUEST_DENIED", a chave pode ter restrição de referenciador incompatível com o domínio da aplicação.

Como funciona o site_status?

O sistema tenta acessar o site do estabelecimento e classifica o resultado em um dos oito valores:

  • Não analisado — análise ainda não foi executada.
  • Sem site — nenhum domínio foi encontrado no perfil do Maps.
  • Fora do ar — domínio encontrado mas sem resposta HTTP.
  • Sem HTTPS — site responde mas só via HTTP.
  • Não é mobile — sem viewport responsivo detectado.
  • Construtor pronto — site gerado por Wix, Webflow ou similar.
  • Lento — tempo de resposta acima do limiar aceitável.
  • Aceitável — site online, HTTPS, responsivo e rápido.

O PDF de diagnóstico sai com quadradinhos no lugar de acentos.

O PDF é gerado com a gem Prawn usando a fonte DejaVu Sans, que suporta o conjunto de caracteres Latin-1 com acentos do português. Se os quadradinhos aparecerem, verifique se o arquivo de fonte foi incluído corretamente em vendor/assets/fonts/DejaVuSans.ttf e se o gerador de PDF referencia esse caminho. Em servidores sem acesso ao sistema de arquivos local (deploys em container), confirme que a pasta vendor/assets está incluída na imagem.

Posso usar a Sessão de prospecção sem configurar IA?

Sim. A Sessão de prospecção exibe os dados coletados pelo scraper (nome, telefone, site, status digital) independentemente de qualquer chave de IA. A análise de Raio-X e a geração de texto para mensagens personalizadas é que requerem um provedor configurado. Sem IA, use os templates de mensagem manuais disponíveis em cada lead.