melgarafael/DeskcommCRM

DeskcommCRM – Open‑source AI‑powered sales OS for WhatsApp

What it is – DeskcommCRM is a self‑hosted Customer Relationship Management (CRM) system that embeds generative‑AI agents directly into the sales workflow. The agents can answer, qualify and move leads on WhatsApp, run RAG‑based knowledge retrieval per tenant, and hand‑off to human operators when needed. All data stay on your own VPS; there is no SaaS lock‑in, no recurring fees, and the code is released under the MIT license.

Core capabilities

• AI agents in the inbox – each tenant gets its own LLM (OpenRouter, Anthropic or OpenAI) that can converse, extract intent, tag leads, and trigger automations.
• RAG per tenant – embeddings stored in Supabase’s vector extension let the agent retrieve company‑specific knowledge during a chat.
• WhatsApp integration – supports both QR‑code‑based WAHA (multi‑number, anti‑ban throttling) and Meta Cloud API for production‑grade messaging.
• Automation engine – rule builder (WHEN/IF/THEN) that can call webhooks, send WhatsApp messages, move leads, add tags, etc. Events are queued in a DB table and processed by a cron worker.
• Multi‑tenant & LGPD‑by‑design – Row‑Level Security isolates each organization, audit logs are append‑only, and personal data can be anonymised instead of deleted.
• One‑click deployment – a Docker‑based installer (hostgator-setup-kit) provisions Supabase, creates secrets, builds the app image and configures HTTPS with a single command. Updating is also one‑click from the UI or via update.sh.
• Full UI – Next.js 16 app router with pages for Inbox, Radar (stale leads), Kanban funnel, Agent management, Webhooks, Analytics, Security (MFA), and more.

Installation flow (quick version)

1. Obtain a VPS with Docker (recommended HostGator partnership) and a domain pointing to it.
2. Create a free Supabase project (or let the installer do it) and get an OpenAI/Anthropic/OpenRouter key.
3. Run the installer:

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

   The script is idempotent, generates all secrets, applies the Supabase schema, creates the first admin user, sets up HTTPS and a cron that drives automations and updates.
4. Open https://your‑domain and log in with the admin credentials created during install. Scan the QR code to link your WhatsApp number.

Updating – From the UI a “New version” badge appears; clicking it backs up the database, pulls the latest tagged release, reapplies the schema and restarts the containers. A CLI alternative (bash hostgator-setup-kit/update.sh) does the same.

Tech stack

Layer	Choice
Front‑end	Next.js 16 (App Router) + React 19 + TypeScript 6 (strict)
Styling	Tailwind CSS + shadcn/ui
Database & Auth	Supabase (Postgres + RLS + vector extension, Supabase Auth)
Real‑time	Supabase Realtime
Storage	Supabase Storage (private bucket for WhatsApp media)
Messaging	WAHA Plus (NOWEB) + Meta Cloud API
Queues	DB‑driven event_log table + cron workers
Rate limiting	Upstash Redis (sliding‑window)
AI integration	Vercel AI SDK v7 – OpenRouter / Anthropic / OpenAI / Google
Validation	Zod
Observability	Sentry (optional, opt‑in)
Containerisation	Docker Compose (single‑command install)

Typical use cases

• Small‑to‑medium businesses that sell primarily via WhatsApp (e‑commerce, clinics, real‑estate, agencies, info‑products).
• Teams that want AI‑assisted lead qualification and follow‑up without giving up data sovereignty.
• Companies needing custom vocabularies and pipelines per niche – the core can be re‑labelled per tenant.
• Organizations that require audit‑ready logs, role‑based access control and compliance with Brazil’s LGPD.

Community & contribution – The repo includes extensive docs (VISION.md, ARCHITECTURE.md, CONTRIBUTING.md), a CI pipeline, and a set of “assistant guides” that let AI coding assistants (Claude, Cursor, etc.) run installation or configuration commands in natural language. Contributions are welcomed via pull requests; the CI checks that every UI route exists and that tenant isolation works.

License – MIT.

---

All information above is taken directly from the repository’s README and linked documentation.