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

  2. O que ele faz de verdade

  3. Quanto custa

  4. Como instalar — Claude Code ou Codex

  5. O prompt (copie e cole)

  6. Limites e riscos que você precisa saber

  7. Próximo passo


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


3. QUANTO CUSTA

Sem mensalidade de software. Você paga só a estrutura:

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:

  1. Baixe o repositório: botão verde "Code" em github.com/IACLUBCOMUNIDADE/crm-ia-club, ou git clone se preferir.

  2. Abra o Claude Code ou o Codex dentro da pasta que você baixou.

  3. Cole o prompt completo da seção abaixo.

  4. Responda as perguntas que aparecerem (seu e-mail, o nicho do seu negócio, etc.).

  5. 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


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.

👉

Link


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.