CRM com IA — repositório e prompt de instalação (Claude Code / Codex) | IA Club
Guia e prompt para instalar sozinho, com Claude Code ou Codex, o CRM open source com WhatsApp, Kanban e agente de IA que a Alle testou e usa.
Por IA Club
Kanban de vendas, WhatsApp conectado e um agente de IA atendendo — rodando no seu próprio servidor
📋 ÍNDICE
1. O QUE É ESTE CRM
Um sistema de vendas open source (licença MIT) com Kanban, caixa de entrada de WhatsApp em tempo real e agente de IA que atende, qualifica e move o lead no funil sozinho.
Testei aqui: importei leads reais do meu HubSpot e conectei meu próprio número de WhatsApp. Funcionou.
Não é um SaaS fechado com mensalidade. É um repositório aberto — instala no seu computador ou num servidor seu, e os dados ficam com você.
Repositório: https://github.com/IACLUBCOMUNIDADE/crm-ia-club
2. O QUE ELE FAZ DE VERDADE
-
CAIXA DE ENTRADA DO WHATSAPP — todas as conversas em tempo real, com histórico
-
KANBAN DE VENDAS — funil visual, arrasta o card e o negócio avança
-
AGENTE DE IA — responde, qualifica o lead e te chama quando o assunto exige atenção humana
-
AUTOMAÇÕES SEM CÓDIGO — chegou lead → manda mensagem → move de etapa
-
CAPTAÇÃO DE LEADS — conecta landing page, formulário, ManyChat ou Zapier direto no funil
-
LGPD NATIVA — exportação, anonimização, trilha de auditoria
-
MARCA PRÓPRIA — troca nome e logo por configuração, sem mexer em código
3. QUANTO CUSTA
Sem mensalidade de software. Você paga só a estrutura:
-
Servidor (VPS): ~R$ 40 a 70 por mês
-
Conexão de WhatsApp: grátis para testar; a versão paga (mais estável) é US$ 19 por mês
-
Uso da IA: por consumo, conforme o volume de atendimento
Total realista para operar: R$ 150 a 250 por mês.
4. COMO INSTALAR — CLAUDE CODE OU CODEX
Você não precisa saber programar. Claude Code e Codex são assistentes de IA que trabalham no terminal do seu computador — eles instalam o sistema por você e só te perguntam o que só você pode responder.
🔧 PASSO A PASSO:
-
Baixe o repositório: botão verde "Code" em github.com/IACLUBCOMUNIDADE/crm-ia-club, ou git clone se preferir.
-
Abra o Claude Code ou o Codex dentro da pasta que você baixou.
-
Cole o prompt completo da seção abaixo.
-
Responda as perguntas que aparecerem (seu e-mail, o nicho do seu negócio, etc.).
-
Em cerca de 30 a 60 minutos, o CRM está rodando no seu computador, pronto para testar com seus dados.
5. O PROMPT (COPIE E COLE)
Você vai implantar o DeskcommCRM (repositório github.com/IACLUBCOMUNIDADE/crm-ia-club)
LOCALMENTE nesta máquina para eu testar com meus dados reais. Trabalhe de forma
autônoma e me avise quando precisar de algo que só eu posso fazer. Siga este
roteiro, que já foi validado — ele evita as armadilhas conhecidas:
1. FERRAMENTAS: garanta node 22+, pnpm, supabase CLI e um runtime Docker.
- macOS sem Docker Desktop: use colima (brew install colima docker) e
colima start --cpu 4 --memory 6.
- Windows: use WSL2 + Docker.
- Confira espaço em disco antes (mínimo 15 GB livres).
2. BANCO: suba o Supabase local (supabase start na raiz do repo).
ATENÇÃO — NÃO use as migrations de supabase/migrations (quebram em banco
novo). O caminho certo é o do instalador oficial:
a) crie as extensões: vector, citext e pg_trgm no schema public;
b) aplique supabase/baseline.sql com ON_ERROR_STOP=1 via psql no
container do Postgres local.
Sucesso = ~94 tabelas no schema public.
3. CONFIGURAÇÃO: crie .env.local com:
- chaves do supabase local (URL, anon, service_role, DB_URL do supabase status)
- segredos gerados localmente (INTERNAL_SECRET e as 4 chaves de criptografia
do .env.example, via openssl rand)
- SENTRY_DSN=off (privacidade: sem telemetria)
- AGENT_DISPATCH_CONSUMER=native e EVENT_LOG_WORKER_ENABLED=false
- APP_NAME com o nome do MEU negócio (pergunte para mim)
4. USUÁRIO: crie meu login admin com scripts/create-test-user.ts usando o MEU
email (pergunte). A senha me entregue no final. O 2FA eu configuro no
primeiro acesso com meu app autenticador.
5. SUBA O APP: pnpm dev e confirme /api/v1/health com supabase ok.
6. WHATSAPP (opcional agora, recomendado): suba o WAHA grátis em Docker.
- Mac Apple Silicon: imagem devlikeapro/waha:arm; Intel/VPS: devlikeapro/waha.
- Use o motor GOWS (WHATSAPP_DEFAULT_ENGINE=GOWS) — motores alternativos
têm bugs conhecidos de conexão/renovação de QR nesta versão.
- WAHA_API_KEY em texto puro (na versão grátis o hash SHA512 não vale).
- Webhook: http://host.docker.internal:3000/api/v1/webhooks/waha
- Me mostre a tela Conexões para eu escanear o QR (o código vence em ~1 min;
se vencer, gere outro).
- AVISO que você deve me dar: conexão não-oficial tem risco de banimento;
ideal usar número dedicado, nunca disparar em massa.
7. MOTOR DE AUTOMAÇÕES: rode em background um loop que chama a cada 60s a
rota /api/v1/cron/event-log-drain com Authorization: Bearer INTERNAL_SECRET
— sem isso, automações e agente não executam.
8. MEU FUNIL: pergunte meu nicho e crie um pipeline com estágios e vocabulário
do meu negócio + uma fonte de captação (webhook) apontando pra ele. Me
entregue a URL de captação e teste com um POST de exemplo.
9. AGENTE DE IA: edite o agente padrão com um system_prompt sobre o MEU
negócio (pergunte: o que vendo, para quem, tom de voz, o que o agente NUNCA
pode fazer). Regras mínimas: não inventar preço, transferir para humano em
cobrança/reclamação, respeitar quem pede para parar. A chave da Anthropic
EU colo na tela Agentes IA → Credenciais (nunca peça para eu te enviar).
10. ENTREGA FINAL: me passe um resumo com — endereço do CRM, meu login, o que
está ligado, o que falta (chaves que só eu colo), e como ligar/desligar
tudo. Crie scripts de ligar/desligar para eu não depender de terminal.
6. LIMITES E RISCOS QUE VOCÊ PRECISA SABER
-
A conexão de WhatsApp usa uma tecnologia não-oficial — existe risco real de banimento do número. Use um número dedicado, nunca o principal do negócio, e nunca dispare mensagens em massa.
-
Rodando no seu computador, o CRM só funciona enquanto ele está ligado. Para operar 24 horas por dia, o próximo passo é o deploy num servidor (VPS) — o guia está no mesmo repositório.
-
É preciso ter uma conta gratuita na Supabase e uma chave de IA (Anthropic) para o agente responder.
-
Sempre teste antes de usar com clientes reais. Mantenha um humano supervisionando o agente no início.
7. PRÓXIMO PASSO
Testou e funcionou? O caminho para implementar isso de verdade no seu negócio — funil certo, automações do seu nicho, agente treinado com o seu conteúdo — é o que a gente constrói junto dentro do IA Club.
👉
Repositório aberto, testado e mantido pela comunidade. Dúvidas técnicas: issues do projeto no GitHub. Dúvidas de aplicação no seu negócio: traga pro IA Club.