README

🇧🇷 Português · 🇺🇸 English · 🇪🇸 Español


  
  


 🛠️ DeskcommCRM — o Sistema Operacional de Vendas com IA, open source, pro WhatsApp

Agentes de IA que atendem, qualificam e vendem no WhatsApp — dentro de um CRM open source rodando no seu servidor.
Sem mensalidade, sem feature travada, seus dados com você. A alternativa aberta a Kommo, Octadesk e Intercom.












⚡ Instalar · 📖 Curso visual · 🔄 Atualizar · 🧭 Visão · 🏗️ Arquitetura · 🤝 Contribuir · 🗺️ Roadmap





---

  ☁️ Rode este CRM em produção com 1 comando

 O DeskcommCRM foi desenvolvido em parceria com a HostGator: o hostgator-setup-kit/
 instala o CRM completo (app + WhatsApp + banco) numa VPS com um único comando, e o
 runbook de produção já assume esse ambiente.

 👉 Assinar a VPS HostGator com desconto da parceria —
 datacenter em São Paulo, ideal pro WhatsApp rodando 24/7. (link de parceiro — assinar por ele apoia o projeto e sai mais barato)

 Ainda não tem servidor? Rode isto no seu computador (macOS, Linux ou WSL). Ele diz
 qual plano contratar — com os números do runbook, não um "depende" — e te devolve o
 comando certo pro seu caso:

 bash
 curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/hostgator-setup-kit/comecar.sh | bash
 

 (prefere ler antes de executar? clone o repo e rode bash hostgator-setup-kit/comecar.sh —
 ele não instala nada sem você confirmar.)

---

 ⚡ Instalar na sua VPS (o caminho principal)

 1. Entre na sua VPS

Abra o Terminal no seu computador (no Windows, o PowerShell; no Mac ou Linux, o
Terminal) e conecte com o IP e a porta que a hospedagem te mandou por e-mail:

bash
ssh -p PORTA root@SEU_IP


Troque PORTA e SEU_IP pelos seus. Se a hospedagem não mencionou porta nenhuma, é a padrão
(22) e você pode omitir: ssh root@SEU_IP.

Ele pede a senha. Ao digitar, não aparece nada na tela — nem asteriscos. Isso não é
travamento: é o terminal escondendo a senha. Digite (ou cole) e dê Enter.

 Na primeira conexão ele pergunta Are you sure you want to continue connecting? — responda
 yes. É o servidor se apresentando pela primeira vez.

 2. Rode o instalador

Já dentro da VPS:

bash
git clone https://github.com/melgarafael/DeskcommCRM.git
cd DeskcommCRM
bash hostgator-setup-kit/install.sh


É isso. Você não instala Node, nem pnpm, nem compila nada — a imagem do app já vem pronta.
Se faltar Docker, o instalador pergunta e instala sozinho.

 O que você precisa ter em mãos

| Item | Onde conseguir |
|---|---|
| VPS com Docker | HostGator (parceria) — ou qualquer VPS com Docker. 4 GB de RAM recomendados |
| Domínio | Um registro A apontando pro IP da VPS (ex.: crm.suaempresa.com.br) |
| Banco | Conta grátis no supabase.com — 3 chaves + connection string do Session pooler. Se o projeto ficar fora do ar parado (522 ou PGRST002 por horas), o compute Nano do plano grátis pode não bastar: veja o runbook |
| IA | Uma chave de OpenRouter, Anthropic ou OpenAI — o instalador pergunta qual você quer |
| WhatsApp | Seu número, conectado por QR code no