Manual de Instruções

Guia completo para usar o sistema de prospecção automatizada TMT

Sistema de CRM Automatizado - Prospecção inteligente via Google Maps + WhatsApp + Funil de Vendas
Índice

Visão Geral do Sistema

Prospecção Automatizada

Busca empresas no Google Maps por segmento e localização

WhatsApp Integrado

Verifica e envia mensagens automaticamente

Fluxo do Sistema
1. Busca no Google Maps → Encontra empresas por segmento/localização
2. Extração de Dados → Nome, telefone, endereço, avaliações
3. Verificação WhatsApp → Confirma se o número tem WhatsApp
4. Envio de Mensagem → Dispara mensagem personalizada
5. Criação no CRM → Adiciona lead ao funil de vendas

Configuração Inicial

Importante: Configure todas as APIs antes de iniciar a prospecção.

Passo 1: Configurar SerpAPI (Google Maps)

1. Acesse serpapi.com
2. Crie uma conta gratuita
3. Copie sua API Key
4. Cole em Configurações → Credenciais → SerpAPI

Passo 2: Configurar Z-API (WhatsApp)

1. Acesse z-api.io
2. Crie uma instância do WhatsApp
3. Obtenha: Token, Client Token e Instance ID
4. Configure em Configurações → Credenciais → Z-API

Passo 3: Primeiro Acesso

Login Padrão

Email: admin@tmt.com
Senha: password

Altere a senha após o primeiro login
Banco de Dados

Execute o arquivo database/schema.sql no MySQL para criar as tabelas necessárias.

Como Fazer Prospecção

1
Acesse a Prospecção

No menu lateral, clique em Prospecção

2
Defina os Parâmetros
  • Segmento: Ex: "clínicas médicas", "escritórios advocacia"
  • Localização: Ex: "São Paulo, SP", "Rio de Janeiro, RJ"
  • Limite: Quantidade de empresas (máx. 100)
3
Execute a Prospecção

Clique em "Iniciar Prospecção" e aguarde o processamento.

Dicas de Segmentação
  • Específico: "clínicas dermatologia" em vez de "clínicas"
  • Local: Use cidade + estado para melhor precisão
  • Nicho: Segmente por especialidade ou tamanho

Integração WhatsApp

Como Funciona

Verificação Automática: O sistema verifica se cada telefone tem WhatsApp ativo
Envio Inteligente: Mensagens são enviadas apenas para números válidos
Template Personalizado: Mensagem adaptada com nome da empresa

Configurar Mensagem Template

Acesse Configurações → Mensagem Template e personalize:

Exemplo de Template
Olá, tudo bem? 😊
Aqui é da *TMT Segurança e Medicina do Trabalho*.
Somos especializados em documentos obrigatórios (PGR, PCMSO, LTCAT) para empresas como a {NOME_EMPRESA}.
Vi a sua empresa no Google e gostaria de saber se já está com a parte de Saúde e Segurança do Trabalho em dia.
Posso te enviar mais informações?
Atenção: Respeite as políticas do WhatsApp. Evite spam e mensagens em massa excessivas.

Funil de Vendas

Etapas Padrão do Funil

1. Lead Captado (Google Meu Negócio)
Empresa encontrada e dados extraídos
2. WhatsApp enviado – aguardando resposta
Mensagem inicial disparada
3. Interessado – qualificação
Cliente demonstrou interesse
4. Contato comercial agendado
Reunião ou ligação marcada
5. Proposta enviada
Orçamento ou proposta apresentada
6. Negociação
Discussão de valores e condições
7. Fechado – ganho
Negócio concluído com sucesso
8. Fechado – perdido
Negócio não concretizado

Gerenciar Leads

  • Visualização: Acesse Funil de Vendas no menu
  • Movimentação: Arraste leads entre etapas
  • Detalhes: Clique no lead para ver histórico completo
  • Filtros: Filtre por responsável, data ou status

Relatórios e Métricas

Dashboard Principal
  • Total de empresas prospectadas
  • Leads interessados
  • Aguardando resposta
  • Negócios fechados
Relatórios Detalhados
  • Performance por campanha
  • Taxa de conversão por etapa
  • ROI de prospecção
  • Análise temporal

APIs e Integrações

SerpAPI

Função: Busca no Google Maps

Limite: 100 buscas/mês (gratuito)

Acessar
Z-API

Função: WhatsApp Business

Limite: Varia por plano

Acessar
OpenAI

Função: Análise inteligente (opcional)

Uso: Qualificação de leads

Acessar

Solução de Problemas

Possíveis causas:
  • SerpAPI key inválida ou expirada
  • Segmento muito específico
  • Localização incorreta
Soluções:
  • Verifique a API key em Configurações
  • Use termos mais genéricos
  • Confirme o formato: "Cidade, UF"

Verificações:
  • Z-API configurado corretamente
  • Instância conectada e ativa
  • Tokens válidos
  • WhatsApp não bloqueado
Teste:

Use a página de teste do WhatsApp para verificar a conexão.

Verificar:
  • MySQL rodando
  • Credenciais em config/config.php
  • Banco 'prospeccaotmt' criado
  • Tabelas importadas (schema.sql)
Precisa de Ajuda?

Consulte os logs em /logs/ para detalhes técnicos ou entre em contato com o suporte técnico.