Repolode
melgarafael

melgarafael/DeskcommCRM

Self-hosted, MIT-licensed sales CRM with native AI agents and WhatsApp integration via WAHA or Meta Cloud API, built on Next.js and Supabase.

Open-source alternative to:KommoIntercomOctadesk

Stars
5,249
Forks
1,506
Open issues
361
Last commit
4 hours ago

What is it?

DeskcommCRM is a self-hosted sales CRM aimed at businesses that sell through WhatsApp chat, such as clinics, real estate agencies, info-product sellers and e-commerce stores. It runs on Next.js 16 with Supabase for Postgres, auth, storage and realtime, and is installed on a VPS with Docker through a single install script that also sets up HTTPS, the database schema and background cron jobs.

WhatsApp can be connected either by QR code through WAHA, supporting multiple numbers, or through the official Meta Cloud API with approved templates. AI agents use per-tenant retrieval-augmented generation, can run skills during conversations, hand off to a human, and expose the CRM through MCP. Each tenant's data is isolated with row-level security, and the project includes LGPD-oriented features such as anonymization and audit logs.

The project provides a kanban pipeline with configurable stage vocabulary, a shared inbox, a follow-up system for cooled-off leads, and a webhook-based automation builder with QUANDO/SE/ENTÃO rules. Updates can be applied from the admin screen or with an update script that backs up the database first.

Key features

  • 01Native AI agents with per-tenant RAG, skills, and human handoff
  • 02WhatsApp connection via WAHA QR code or the official Meta Cloud API
  • 03Multi-tenant isolation using Postgres row-level security
  • 04Kanban pipeline with configurable stage vocabulary per business niche
  • 05Webhook intake and QUANDO/SE/ENTÃO automation rules
  • 06One-command VPS installation and in-app updates with automatic database backup

Use cases

  • Running a WhatsApp-based sales team with a shared inbox and AI first responses
  • Qualifying and following up leads from landing pages and forms via webhooks
  • Operating a self-hosted CRM for clients who need data kept on their own server

Quick start

  1. 1

    Connect to your VPS over SSH

    ssh -p PORTA root@SEU_IP
  2. 2

    Clone the repository on the VPS

    git clone https://github.com/melgarafael/DeskcommCRM.git
  3. 3

    Enter the project folder and run the installer

    cd DeskcommCRM && bash hostgator-setup-kit/install.sh

Things to know

  • Designed for a self-hosted VPS with Docker, plus a Supabase account and an AI API key.
  • Needs a domain pointing to the server and a WhatsApp number connected by QR code.
  • Setup is oriented to Portuguese-language docs and HostGator, with an affiliate link in the README.

In collections

Topics

FAQ

What is DeskcommCRM?
Self-hosted, MIT-licensed sales CRM with native AI agents and WhatsApp integration via WAHA or Meta Cloud API, built on Next.js and Supabase. DeskcommCRM is a self-hosted sales CRM aimed at businesses that sell through WhatsApp chat, such as clinics, real estate agencies, info-product sellers and e-commerce stores. It runs on Next.js 16 with Supabase for Postgres, auth, storage and realtime, and is installed on a VPS with Docker through a single install script that also sets up HTTPS, the database schema and background cron jobs.
Is DeskcommCRM free to use? What license does it have?
DeskcommCRM is open source under the MIT license. Check the license terms before using it in commercial products.
Is DeskcommCRM still maintained?
Actively maintained. The last commit to DeskcommCRM was on Nov 7, 2026.
What can I use DeskcommCRM for?
Running a WhatsApp-based sales team with a shared inbox and AI first responses Qualifying and following up leads from landing pages and forms via webhooks Operating a self-hosted CRM for clients who need data kept on their own server
How do I install DeskcommCRM?
Connect to your VPS over SSH: ssh -p PORTA root@SEU_IP Clone the repository on the VPS: git clone https://github.com/melgarafael/DeskcommCRM.git Enter the project folder and run the installer: cd DeskcommCRM && bash hostgator-setup-kit/install.sh
Where can I get DeskcommCRM?
The source code and installation instructions are on GitHub: https://github.com/melgarafael/DeskcommCRM

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects