Setup Guide — Máquina de Prospecção IA

1

🚀

Provisionar Serviços Pendente

PostgreSQL · Redis · RabbitMQ · n8n · Evolution API

▼

Todos os serviços da Máquina de Prospecção rodam como sidecars no codrsync. Certifique-se de que os 5 serviços abaixo estejam Online antes de continuar.

🐘

PostgreSQL

Banco de leads e histórico

⚡

Redis

Cache e filas de estado

🐇

RabbitMQ

Fila de mensagens

⚙️

n8n

Automação de workflows

💬

Evolution API

Gateway WhatsApp

Como provisionar: Acesse o painel de serviços do codrsync → aba "Services" → clique em "Add Service" → selecione cada serviço da lista acima e confirme.

PostgreSQL provisionado e rodando

Verifique o status verde no painel de serviços

Redis provisionado e rodando

Porta 6379 disponível na rede interna

RabbitMQ provisionado e rodando

Interface de gestão em :15672

n8n provisionado e acessível

URL pública disponível no painel

Evolution API provisionada e acessível

Endpoint REST disponível para conexão WhatsApp

Resultado Esperado Todos os 5 serviços aparecem com status ● Online no painel codrsync Services. n8n e Evolution API têm URLs públicas HTTPS.

🚀 Abrir Painel de Serviços

Marque como concluído quando todos os serviços estiverem Online

2

📱

Conectar WhatsApp Pendente

Escanear QR Code via Evolution API

▼

A Máquina de Prospecção envia e recebe mensagens via WhatsApp. Você precisa conectar um número escaneando o QR Code na Evolution API.

⚠️ Atenção: Use um número de WhatsApp Business dedicado para automação. Evite usar seu número pessoal — contas suspeitas de automação podem ser banidas pelo WhatsApp.

Acesse o Evolution API Manager e crie uma instância

Clique em "Create Instance" → dê um nome (ex: belight-prospeccao)

Clique em "Connect" para gerar o QR Code

O QR Code expira em 60 segundos — tenha o WhatsApp pronto

Escaneie o QR Code com o WhatsApp Business

WhatsApp → Configurações → Aparelhos Conectados → Conectar um aparelho

Confirme o status "Connected" na instância

O ícone da instância deve mudar para verde

Copie o API Key da instância e salve no Step 4

Você precisará dela nas credenciais dos workflows

Resultado Esperado Instância mostra status ● Connected na Evolution API. O número WhatsApp Business aparece conectado no aplicativo do celular.

💬 Abrir Evolution API 📋 Copiar URL

Marque como concluído quando o WhatsApp estiver conectado

3

⚙️

Importar Workflows n8n Pendente

5 módulos: Ingestão · Disparo · SDR · BANT · Handover

▼

O sistema tem 5 workflows n8n que cobrem todo o funil de prospecção. Importe-os um a um na interface do n8n usando os arquivos JSON do workspace.

Como importar: No n8n → clique no ícone de menu (≡) → "Workflows" → botão "+" → "Import from File" → selecione o arquivo JSON abaixo.

Módulo 1 — Ingestão de Leads

Modulo_1/Template_Modulo_1_Ingestao.json

Captura e qualifica leads de fontes externas (LinkedIn, formulários, CSV)

Módulo 2 — Disparo de Mensagens

Modulo_2/Template_Modulo_2_Disparo.json

Envia mensagens personalizadas via WhatsApp com rate-limiting inteligente

Módulo 3 — SDR com IA

Modulo_3/Template_Modulo_3_SDR.json

Agente de IA que responde leads, tira dúvidas e aquece a conversa

Módulo 4 — Qualificação BANT

Modulo_4/Template_Modulo_4_BANT.json

Qualifica leads com metodologia BANT (Budget, Authority, Need, Timeline)

Módulo 5 — Handover para Vendas

Modulo_5/Template_Modulo_5_Handover.json

Transfere leads qualificados para o CRM e notifica a equipe de vendas

Módulo 1 (Ingestão) importado no n8n

Módulo 2 (Disparo) importado no n8n

Módulo 3 (SDR IA) importado no n8n

Módulo 4 (BANT) importado no n8n

Módulo 5 (Handover) importado no n8n

Resultado Esperado 5 workflows aparecem na lista do n8n em estado Inactive. Eles serão ativados no Step 6 após configurar as credenciais.

⚙️ Abrir n8n 📋 Copiar URL n8n

Marque como concluído quando todos os 5 módulos estiverem importados

4

🔑

Configurar Credenciais Pendente

API Keys e connection strings no n8n Credentials Vault

▼

Configure as credenciais no n8n Credentials Vault. Acesse: n8n → Settings → Credentials → Add Credential. Salve os valores abaixo para referência.

🔒 Segurança: As credenciais salvas abaixo ficam apenas no seu browser via localStorage. Nunca compartilhe esta página com os valores preenchidos.

IA & LLM

OpenAI API Key

Anthropic API Key (opcional)

WhatsApp / Evolution API

Evolution API URL

Evolution API Key

Nome da Instância

Banco de Dados

PostgreSQL Host

PostgreSQL Password

Redis Host

Opcional — Enriquecimento de Leads

Apollo.io API Key

Hunter.io API Key

No n8n, crie as seguintes credentials:
• OpenAI API — tipo "OpenAI API"
• Evolution API — tipo "HTTP Header Auth" (header: apikey)
• PostgreSQL — tipo "Postgres"
• Redis — tipo "Redis"
Após criar, abra cada workflow e atribua a credential correta em cada node.

OpenAI credential criada e testada no n8n

Evolution API credential criada e testada

PostgreSQL credential criada e testada

Credentials atribuídas em todos os workflows

Resultado Esperado Todos os nodes dos 5 workflows mostram credenciais válidas (sem erros vermelhos). O botão "Test Credential" retorna sucesso para cada uma.

🔑 Abrir n8n Credentials

Marque como concluído quando todas as credentials estiverem configuradas

5

🔍

Testar Conexões Pendente

Verificação de saúde de todos os serviços

▼

Antes de ativar as automações, verifique se todos os serviços estão respondendo corretamente. Use os botões abaixo para testar cada serviço individualmente.

⚙️

n8n

Não testado

💬

Evolution API

Não testado

🐘

PostgreSQL

Verificar no n8n

⚡

Redis

Verificar no n8n

🐇

RabbitMQ

Verificar no painel

📱

Não testado

n8n responde na URL pública

Deve carregar a interface de login ou workspace

Evolution API responde na URL pública

Endpoint /instance/fetchInstances deve retornar JSON

WhatsApp instância status = Connected

GET /instance/connectionState/{instância} → "open"

Credentials n8n testadas com sucesso (todas as cores verdes)

Settings → Credentials → testar cada uma

Mensagem de teste enviada via WhatsApp com sucesso

Execute manualmente o Módulo 2 com um número de teste

Resultado Esperado Todos os serviços respondem. n8n e Evolution API carregam as interfaces. WhatsApp recebe mensagem de teste. Nenhum erro 500/timeout nas conexões.

Marque como concluído quando todas as conexões estiverem OK

6

🟢

Ativar Automações Pendente

Ligar os 5 workflows no n8n

▼

Com todos os serviços rodando e credenciais configuradas, é hora de ativar os workflows. A ordem de ativação importa — siga a sequência abaixo.

Ordem de ativação: Ative primeiro os módulos de base (Ingestão, Disparo) e depois os de IA (SDR, BANT, Handover). Isso garante que as filas de mensagens estejam prontas antes dos agentes de IA entrarem em ação.

1. Módulo Ingestão

Ative primeiro — define o ponto de entrada dos leads

2. Módulo Disparo

Ative segundo — processa a fila de envios WhatsApp

3. Módulo SDR IA

Ative terceiro — agente de IA entra na conversa

4. Módulo BANT

Ative quarto — qualificação de leads com IA

5. Módulo Handover

Ative por último — fecha o ciclo para a equipe de vendas

Abra cada workflow no n8n e clique no toggle "Active" (canto superior direito)

O toggle muda de cinza para verde quando ativo

Verifique que todos os 5 workflows aparecem como "Active" na lista

Workflows → lista → ícone verde ao lado do nome

Ingira o primeiro lead de teste manualmente

Execute o Módulo 1 manualmente com dados de teste para validar todo o fluxo

Confirme o lead aparece no dashboard (kanban de prospecção)

Deve aparecer na coluna "Ingestão" do pipeline

🎉 Máquina ativada! Quando todos os workflows estiverem ativos e o lead de teste percorrer o funil, a Máquina de Prospecção IA está operacional. Acompanhe o progresso em tempo real no dashboard.

Resultado Esperado 5 workflows com status ● Active no n8n. Lead de teste chega até o estágio de Handover. Dashboard mostra o lead no kanban.

⚙️ Gerenciar Workflows n8n 📊 Ver Dashboard

Marque como concluído quando todos os 5 workflows estiverem ativos

Setup da Máquina de Prospecção IA

Máquina Operacional!