GMaps Leads Extractor

1. Instalar a extensão

Baixe o arquivo .zip da extensão (link no e-mail de acesso ou na área de downloads) e descompacte em uma pasta que você não vá apagar.
No Google Chrome, abra chrome://extensions.
Ligue o Modo do desenvolvedor (canto superior direito).
Clique em Carregar sem compactação e escolha a pasta GMaps-Leads-Extractor.
Clique no ícone de quebra-cabeça da barra do Chrome e fixe o GMaps Leads Extractor.

Atualizações Quando sair uma versão nova, aparece um aviso no topo do painel da extensão. Baixe o novo arquivo, substitua os arquivos da pasta e clique em Recarregar (ícone de seta) no card da extensão em chrome://extensions. Seus leads e configurações são mantidos.

2. Ativar a licença

Tela de ativação da licença — Abra o **Google Maps** e clique no ícone da extensão: o painel abre ao lado do mapa.

Na primeira vez, entre com o **e-mail e a senha da sua licença** — você recebeu os dois por e-mail quando a licença foi criada — e clique em **Ativar extensão**.

Esqueceu a senha? Clique em **Esqueceu a senha?**, informe o e-mail e siga o link que chegar.

Cada navegador conta como um dispositivo. Se a licença for ativada em mais navegadores do que o permitido, o mais antigo é desconectado. Para liberar a vaga, clique em **Sair** no rodapé do painel.

3. Extrair leads do Google Maps

Painel pronto para extrair — No Google Maps, faça a busca que quiser — por exemplo `pizzaria em Belém` ou `dentista Zona Sul São Paulo`.

Espere a lista de resultados aparecer à esquerda do mapa.

No painel da extensão, clique em **Iniciar Extração**.

A extensão rola a lista sozinha e captura cada empresa: nome, categoria, telefone, site, e-mail (quando houver), redes sociais, endereço, nota e quantidade de avaliações.

Para parar antes do fim, clique em **Parar Extração**. Para continuar de onde parou, use **Retomar Extração**.

Mantenha a aba do Google Maps visível durante a extração. Se você trocar de aba ou minimizar a janela, o Chrome pode pausar a rolagem e a extração fica mais lenta.

O limite de leads por extração é definido em Configurações (campo Máximo de leads). Contatos repetidos (mesmo telefone) são marcados como duplicados e não entram na contagem.

4. Resultados, filtros e score

Painel com leads capturados — No topo aparece o total de **leads capturados**, quantos têm **telefone** e quantos têm **site**.

Os **filtros** acima da lista mostram: todos, só com telefone, só com site ou sem contato.

O número no canto de cada lead é o **score (0 a 100)**: ele sobe quando a empresa tem telefone, site, boa nota e muitas avaliações. Verde = lead mais completo; amarelo = médio; vermelho = poucos dados.

Os botões de cada lead abrem o site, o e-mail, as redes sociais e o **WhatsApp** (só para celulares), já com a mensagem pré-definida.

5. Exportar, copiar e salvar

Abaixo do botão principal ficam as ações da extração atual:

Botão	O que faz
Exportar para Excel	Baixa uma planilha `.xlsx` com todos os leads e colunas.
Copiar Leads	Copia os leads em formato de tabela, pronto para colar no Google Planilhas.
Salvar no Histórico	Guarda esta extração no histórico do painel (até 10 sessões).
Enviar para Webhook	Envia os leads para a URL de webhook configurada (n8n, Make, Zapier, seu CRM…).
Limpar dados	Apaga os leads da tela para começar uma nova busca.

Histórico de extrações — Em **Histórico** (topo do painel) ficam as extrações salvas. Em cada uma você pode **restaurar** os leads na tela, **baixar** em Excel ou **excluir**.

6. Configurações do painel

Configurações do painel lateral — Clique em **Config** no topo do painel:

**Máximo de leads**: quantos leads cada extração captura no máximo.

**URL do Webhook**: para onde o botão "Enviar para Webhook" manda os leads.

**Mensagem WhatsApp pré-definida**: texto que abre no WhatsApp ao clicar no botão verde de um lead. Use `{nome}` para inserir o nome da empresa.

7. GMaps CRM: base de contatos

Clique no card GMaps CRM no painel da extensão para abrir o CRM em uma aba do Chrome.

Gestão de Leads no GMaps CRM — Base de contatos com score, categoria, estágio, redes sociais e status do WhatsApp.

Botão	O que faz
Importar da Extração	Traz para o CRM os leads capturados no painel lateral.
Importar XLS / Baixar Modelo	Importa contatos de uma planilha (baixe o modelo para ver as colunas).
Verificar WhatsApp	Confere, pela sua conexão de WhatsApp, quais números têm WhatsApp. Só os verificados entram nas campanhas.
⋮ (Ações)	Editar o lead, anotar o histórico de conversa ou excluir.

8. Kanban (funil de vendas)

Quadro Kanban — Leads organizados por etapa: Leads, Campanha, Atendimento e Fechado.

Arraste os cards entre as colunas conforme a negociação avança. Você pode renomear colunas, criar novas em Adicionar Coluna e voltar ao padrão em Restaurar Padrão. Campanhas e a prospecção por IA podem mover os leads de coluna automaticamente depois do envio.

9. Conectar o WhatsApp (UAZAPI)

Configurações do CRM — Conexões de WhatsApp, chaves de IA, backup e manutenção.

No CRM, abra Configurações.
Em Conexões UAZAPI, clique em Adicionar e informe a URL e o token da sua instância UAZAPI. Você pode cadastrar mais de um número: as campanhas alternam entre eles.
Clique em Salvar Configurações de Conexões. O status no canto inferior esquerdo passa para Conectado.
Para usar IA, cole a chave do Google Gemini e/ou da OpenAI e clique em Salvar IA.

Backup Use Exportar de vez em quando para guardar seus contatos e configurações em um arquivo. Ao trocar de computador, é só usar Importar.

10. Campanha de mensagens

Seleção: marque os contatos (só aparecem os com WhatsApp verificado). Dá para filtrar por categoria.
Mensagem: dê um nome à campanha, escolha o tipo (texto, imagem, vídeo ou áudio) e escreva o texto. Use as variáveis {nome}, {site}, {email}, {insta} e {face}. Se quiser, adicione até 3 botões interativos.
Envio: defina o intervalo entre mensagens (em segundos) e a pausa a cada X envios. Ative Usar IA para variar texto para cada pessoa receber uma versão diferente da mensagem, e Mover para Coluna para levar os contatos a uma etapa do Kanban depois do envio.
Faça um Envio de teste para o seu número e, se estiver tudo certo, clique em Iniciar Automação.

Use intervalos longos. Comece com 60 a 120 segundos entre mensagens e pausas a cada 10 envios. Intervalos curtos e volumes altos aumentam muito o risco de bloqueio do número.

11. Prospecção por IA

Descreva sua empresa ou serviço, escolha o provedor de IA (Gemini ou OpenAI) e clique em Gerar Amostra de Mensagem para ver como fica. A IA usa os dados de cada lead (nome, categoria, avaliações, site) para escrever uma mensagem única. Selecione os leads, ajuste o intervalo, faça um teste e clique em Iniciar Prospecção IA.

12. Métricas e histórico

Dashboard de métricas — Saúde da base, funil de vendas e resumo de performance.

Métricas mostra quantos leads foram verificados, quantos têm histórico de conversa e como o funil está distribuído no Kanban. Em Histórico ficam todas as campanhas já enviadas, com o resultado de cada uma.

13. Boas práticas

Busque de forma específica (categoria + bairro/cidade). Buscas amplas trazem leads menos qualificados.
Priorize os leads com score alto: têm mais dados e costumam responder mais.
Verifique o WhatsApp antes de qualquer campanha, para não gastar envios em números sem WhatsApp.
Personalize com {nome} e use a variação por IA: mensagens iguais para todo mundo são sinalizadas.
Vá devagar: poucos envios por dia em números novos e aumento gradual ao longo das semanas.
Respeite quem pedir para não receber mais mensagens e remova o contato na hora.

Responsabilidade pelo uso Disparos em massa para quem não autorizou podem violar os Termos do WhatsApp e a LGPD. O uso da ferramenta e das mensagens enviadas é de responsabilidade de quem envia.

14. Solução de problemas

Problema	O que fazer
O painel não abre ao clicar no ícone	Abra uma aba do Google Maps e clique de novo. Se continuar, recarregue a extensão em `chrome://extensions`.
"E-mail ou senha incorretos"	Confira o e-mail da licença e use Esqueceu a senha? para criar uma senha nova.
Pede para ativar de novo	A licença foi ativada em outro navegador além do limite, venceu ou foi desativada. Entre de novo; se não funcionar, fale com o suporte.
A extração para no meio	Deixe a aba do Maps visível e use Retomar Extração. Confira também o Máximo de leads.
Poucos leads com telefone	Algumas categorias não divulgam telefone no Maps. Tente outra busca ou outro bairro.
Nenhum contato aparece na Campanha	Só entram contatos com WhatsApp verificado: na Base de Contatos, clique em Verificar WhatsApp.
Status "Desconectado" no CRM	Confira a URL e o token da UAZAPI em Configurações e se a instância está conectada no celular.