DeskcommCRM：自托管 WhatsApp AI 销售 CRM
给 WhatsApp 销售团队用的自托管 AI CRM，把对话、漏斗和 RAG 代理放在一处。
GitHub melgarafael/DeskcommCRM 更新 2026-09-12 分支 main 星标 1.3K 分叉 496
Next.js 16 WhatsApp 销售 WAHA Plus Supabase VPS 自托管

🧭 决策指南

为什么现在热： README 同时突出 WhatsApp AI 代理、自托管 VPS、MCP、LGPD 与替代 Kommo/Octadesk/Intercom；发布信息显示 2026-09-12 当日新增 152 星并登上 daily Trending，但材料不足以判断具体受关注原因。

适合，如果你

  • 你要在 VPS 上自托管 WhatsApp CRM，并让 AI 代理参与接待和销售。
    README「O que é」与「Stack」：CRM 运行在 VPS，WAHA Plus 和 Meta Cloud API 提供 WhatsApp，AI 代理可接待、筛选和销售。
  • 你的团队使用 Supabase，并需要 RLS、vector 和按租户隔离的 RAG。
    README「Stack」：数据库为 Supabase（Postgres + RLS + vector）；「O que é」提到 agents de IA com RAG por tenant。
  • 你希望用 OpenRouter、Anthropic、OpenAI 或 Google，并在界面中更换 AI 提供商。
    README「Stack」：Vercel AI SDK v7 支持这些提供商，安装器会询问选择，之后可通过界面更换。
  • 你需要 Inbox、Kanban、Follow-ups、Audit Log 和 196 个 API route handlers。
    README「O que você opera」列出相关页面；「Estrutura」注明 API REST 有 196 个 route handlers。

不适合，如果你

  • 你只想使用托管 SaaS，不愿维护 VPS、Docker、WAHA Plus 或 Supabase。
    README「Stack」明确托管方式为 VPS com Docker；安装说明围绕 self-host 和 VPS 展开。
  • 你需要依赖标准 Supabase migrations 从零初始化数据库。
    README「Desenvolvimento」明确说明 migrations 0001-0009 和 0013 是 stubs，`supabase db push` 会通过但留下空数据库，实际应使用 baseline.sql。
  • 你的业务不使用 WhatsApp，也不需要 CRM 中的 WAHA 或 Meta Cloud API。
    README 标题与核心描述聚焦 WhatsApp；「Stack」将 WAHA Plus 和 Meta Cloud API 列为渠道核心组件。

前置条件

  • 生产环境：VPS with Docker；README 还说明 HostGator/SP 是合作部署环境。
  • 开发环境：`nvm use`（Node 22）、`pnpm`、Docker，以及一个 Supabase 项目。
  • 新 Supabase 项目需启用 `vector`、`citext`、`pg_trgm` 扩展。
  • `docs/SETUP.md` 覆盖 Supabase、WAHA、AI providers、Upstash、Sentry、Resend、Nuvemshop 等集成，README 估计耗时约 60–90 分钟。

第一步命令（README 原文）

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

要注意

  • 不要只运行 `supabase db push`，README 明确说它可能留下空数据库。
    README「Desenvolvimento」：migrations 是 stubs，schema 位于 `supabase/baseline.sql`。
  • 未启用 `vector` 时，baseline 会报 `type public.vector does not exist`。
    README「Desenvolvimento」直接给出该错误及扩展创建命令。
  • 本地开发的 WAHA 是可选项，但 WhatsApp 集成仍涉及 WAHA Plus 或 Meta Cloud API。
    README「Desenvolvimento」标注 `docker compose up -d` 为 WAHA local（optional）；「Stack」列出两种 WhatsApp 渠道。
  • 安全漏洞不要公开提交 Issue，应使用 SECURITY.md 的私密漏洞报告。
    README「Reportando bugs」明确要求安全漏洞不要开 public issue。

替代方案

  • Kommo：当你要评估 README 明确列出的商业 CRM 替代方案，而不是部署 DeskcommCRM 的 VPS、Docker 和 WhatsApp 组件时。
    README「O que é」
  • Octadesk：当你更倾向 README 提到的现成商业产品，而不想自行维护 Supabase、WAHA Plus 和 workers 时。
    README「O que é」
  • Intercom：当你要比较成熟商业客户沟通平台，而不是使用 MIT License 的自托管 WhatsApp CRM 时。
    README「O que é」

材料未说明

  • 省略章节未给出 VPS 的最低 CPU、内存、磁盘和带宽要求。
  • 材料未说明 WAHA Plus、Meta Cloud API、Supabase、Upstash、Sentry 和 AI 提供商的实际费用或配额。
  • 材料未说明支持的 WhatsApp 账号规模、并发会话数或单租户容量上限。
  • 材料未说明 v1.19.0 相比前一版本的具体变更内容。
  • 材料未说明 10 位贡献者和 10 个最近提交对应的提交周期与长期维护计划。
  • 材料未说明 Trending 当日新增 152 颗星的直接来源；无法确认是 AI、WhatsApp、自托管、HostGator 合作还是其他因素造成。

💡 深度解析

6
不适合 我用 Node 22 参与贡献，开发环境是 Next.js 16、React 19 和 TypeScript 6；我能否按普通 Supabase migration 流程初始化 DeskcommCRM，还是必须使用项目的 baseline.sql？
适合读者： 维护 Next.js 16、Node 22 和 Supabase 的开源贡献者，需要在本地运行 WAHA、初始化数据库并修改 TypeScript 代码

不适合直接按普通 supabase db push 流程初始化；README 明确要求新项目先启用扩展，再执行 supabase/baseline.sql。

  • 开发环境要求 Node 22，并使用 pnpm；前端是 Next.js 16 App Router、React 19 和严格 TypeScript。
  • README 明确说 migrations 0001–0009 和 0013 是 SELECT 1; stub，migration 链不会从零建立真实 schema，supabase db push 可能“通过”但留下空数据库。
  • 新 Supabase 项目必须先启用 vector、citext 和 pg_trgm，否则 baseline 会出现 type public.vector does not exist。
  • WAHA 本地运行是可选项，README 给出的开发路径包含 Docker Compose、baseline 导入和 pnpm dev；这更适合能接受项目专用初始化流程的贡献者。
  • README「Desenvolvimento」：`nvm use # Node 22`、`npm install -g pnpm && pnpm install`
  • README「Desenvolvimento」：migrations 0001–0009 和 0013 是 stub；`supabase db push` 会留下空数据库
  • README「Desenvolvimento」：先启用 vector、citext、pg_trgm，再执行 `supabase/baseline.sql`
  • README「Desenvolvimento」：`docker compose up -d`、`pnpm dev`
git clone https://github.com/melgarafael/DeskcommCRM.git
材料未说明：README 未说明 baseline.sql 与后续版本升级之间的正式迁移流程。；README 未说明本地 WAHA、Supabase 项目和 Node 22 的最低 Docker 或操作系统版本。
适合 我不想被单一 AI 供应商锁定，需要在 OpenRouter、Anthropic、OpenAI 和 Google 之间切换，并查看代理执行记录、使用量和预算；DeskcommCRM 能满足这个约束吗？
适合读者： 希望控制 AI 供应商、模型费用和业务数据的自托管企业技术负责人，当前需要在 OpenRouter、Anthropic、OpenAI 和 Google 之间切换

适合，因为 AI 供应商和凭据是管理界面中的可配置项，并且项目把执行、使用量和预算作为 AI 代理管理的一部分。

  • README 的 AI 栈使用 Vercel AI SDK v7，列出 OpenRouter、Anthropic、OpenAI 和 Google；安装器会询问供应商，之后可通过界面更换。
  • AI Agent 页面包含 Providers、Credentials、Executions、Usage and budget，能够对应供应商配置、调用记录和成本控制需求。
  • 代理还支持 RAG、Memory、Skills、Cases、Alerts、Proposals 和人工转接，因此不只是一个固定模型的问答入口。
  • 仍需承担外部模型的延迟、上下文限制和调用费用；项目洞察也指出 RAG 噪声与持续推理成本需要单独评估。
  • README「Stack」：Vercel AI SDK v7 — OpenRouter、Anthropic、OpenAI 和 Google；安装器询问供应商，可通过界面更换
  • README「O que você opera」：Provedores、Credenciais、Execuções、Uso e orçamento
  • README「O que é」：AI 代理使用 RAG、推进销售阶段、触发自动化并转交人工
  • 项目洞察：AI 层采用可替换供应商设计，并提供使用量、预算和执行记录
cp .env.example .env.local  # guia completo em docs/SETUP.md
材料未说明：README 未列出各模型供应商的具体模型名称、默认模型或切换时的兼容性矩阵。；README 未说明预算超限时是阻止执行、降级模型，还是只记录告警。
适合 我们主要用 WhatsApp 销售，想让人工客服和 AI 在同一个 Inbox 协作，同时把 CRM、Follow-up 和客户数据部署在自己的 Docker VPS 上；DeskcommCRM 适合我们吗？
适合读者： 主要通过 WhatsApp 获客、希望把人工客服和 AI 放进同一收件箱，并准备在一台 Docker VPS 上自托管的中小企业负责人

适合，因为它正是面向 WhatsApp 销售、人工与 AI 协作及自托管部署设计的。

  • README 将 Inbox 定义为“conversas de WhatsApp, você e a IA lado a lado”，同时提供 Kanban、联系人、Follow-ups、Radar 和销售绩效页面。
  • WhatsApp 支持 WAHA Plus 的二维码模式，也支持 Meta Cloud API；README 明确把前者定位为快速开始、后者定位为规模化运营。
  • 安装包可把 app、WhatsApp 和数据库部署到 VPS，AI 可通过 OpenRouter、Anthropic、OpenAI 或 Google 配置。
  • 代价是企业需要自行负责 VPS、数据库、通道、AI 费用和安全运维；README 的完整集成配置约需 60–90 分钟。
  • README「O que você opera」：Inbox（conversas de WhatsApp, você e a IA lado a lado）
  • README「Stack」：WAHA Plus（engine NOWEB）+ Meta Cloud API；VPS com Docker
  • README：`docs/SETUP.md` 是所有集成教程，约 60–90 分钟
  • 项目洞察：将 WhatsApp 收件箱、CRM、AI 代理和自动跟进整合为可自托管销售操作系统
curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/hostgator-setup-kit/comecar.sh | bash
材料未说明：README 未给出在具体消息量、并发客服数或联系人规模下的 VPS 配置和性能上限。；README 未说明现有 WhatsApp 号码迁移到 Meta Cloud API 的具体流程。
视情况 我们目前用 WAHA Plus 的 QR 模式快速验证 WhatsApp 销售，下一步要扩大运营并降低非官方通道风险；DeskcommCRM 是否支持迁移到 Meta Cloud API？
适合读者： 已经使用 WAHA 二维码模式验证 WhatsApp 流程、现在准备转向 Meta Cloud API 官方渠道并扩大运营的销售平台主管

视情况：项目同时支持 WAHA Plus 和 Meta Cloud API，但从二维码模式切换到官方渠道仍需要重新核对号码、模板、Webhook 和消息规则。

  • README 的 Stack 同时列出 WAHA Plus (engine NOWEB) + Meta Cloud API，并把 QR 描述为快速开始、官方 Meta 渠道描述为规模化路径。
  • Connections 页面包含连接健康状态、重连和模板管理，说明产品层面已经考虑了通道运营。
  • 项目洞察提醒，WAHA 会受到会话断开、重新认证、WhatsApp 策略变化和非官方渠道风险影响；生产规模与合规场景应优先评估 Meta Cloud API。
  • 但 README 没有给出迁移脚本、号码迁移步骤或 Meta 资质审核清单，因此它支持两种接入，不等于自动完成迁移。
  • README「Stack」：WAHA Plus（engine NOWEB）+ Meta Cloud API；QR pra começar rápido; canal oficial pra escala
  • README「O que você opera」：Conexões（QR ou canal oficial da Meta, com saúde, reconexão e templates）
  • 项目洞察：WAHA 可能受到断线、重新认证、策略变化和非官方渠道风险影响
  • 项目洞察：生产规模和合规场景应优先评估 Meta Cloud API
curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/hostgator-setup-kit/comecar.sh | bash
材料未说明：README 未说明 WAHA 号码转换为 Meta Cloud API 号码的可行性及保留历史消息的方式。；README 未说明 Meta 模板审核、消息窗口和官方 API 费用如何映射到系统中的模板或预算页面。
视情况 我需要在 Next.js 16、React 19 和严格 TypeScript 栈中维护多租户 CRM，并让 AI 通过 MCP 移动线索、执行 Follow-up 和读取租户知识库；DeskcommCRM 能作为基础平台吗？
适合读者： 需要多个组织或客户共用一套 CRM、使用 Supabase Postgres/RLS 做租户隔离，并希望让 AI 通过 MCP 执行 CRM 操作的 TypeScript 开发者

视情况：平台能力匹配，但是否能直接作为生产基础取决于你能否承担 RLS、MCP 权限和业务定制的安全责任。

  • 技术栈已经包含 Next.js 16 App Router、React 19、TypeScript 6 strict，以及 Supabase Postgres、RLS 和 vector，适合在同一代码库扩展 CRM 与 RAG。
  • README 说明 AI 代理可按租户使用 RAG，并通过 MCP 操作完整 CRM；同时提供组织、团队、API Tokens、Audit Log 和 LGPD 页面。
  • 但项目洞察明确指出，多租户安全依赖每张表的 RLS、服务端鉴权、MCP 工具权限和 Token 管理，配置错误可能造成跨组织暴露。
  • 另外，项目依赖 Supabase Auth、Realtime、Storage 和 Postgres 扩展，迁移到其他数据库会增加改造成本。
  • README「Stack」：Next.js 16 App Router、React 19、TypeScript 6 strict、Supabase（Postgres + RLS + vector）
  • README「O que é」：agentes de IA com RAG por tenant；CRM inteiro exposto via MCP
  • README「O que você opera」：Organização、Equipe、Audit Log、LGPD、API Tokens、Segurança
  • 项目洞察：多租户安全取决于 RLS、服务端鉴权、MCP 工具权限和 API Token 管理
git clone https://github.com/melgarafael/DeskcommCRM.git
材料未说明：README 未列出每张业务表的完整 RLS 策略，也未给出 MCP 每个工具的默认权限矩阵。；README 未说明多租户部署的最大组织数、并发 AI 执行数或 Supabase 资源基准。
视情况 我们使用 Nuvemshop，销售主要通过 WhatsApp 完成，还需要 LGPD 页面、Audit Log、MFA 和私有 WhatsApp 媒体存储；DeskcommCRM 是否足以作为这套业务的 CRM 基础？
适合读者： 需要把 Nuvemshop、电商销售管道和 WhatsApp 自动化连接起来，同时要求 LGPD、审计日志和私有媒体存储的巴西电商技术负责人

视情况：产品覆盖了你列出的系统能力，但不能仅凭这些页面宣称已经满足全部 LGPD 合规责任。

  • README 直接列出 Nuvemshop、Webhooks、WhatsApp Inbox、Kanban 和自动化，适合作为电商聊天销售的业务入口。
  • 安全与组织页面包含 LGPD、Audit Log、MFA、恢复码、会话和 API Tokens；Stack 还指定 Supabase Storage 的私有 whatsapp-media bucket 与签名 URL。
  • 项目洞察说明系统支持审计和隐私相关功能，但企业仍须负责数据保留、删除请求、用户同意、供应商协议和跨境处理。
  • 因此它能提供合规实施基础，却不能替代企业自己的法律流程、数据分类和供应商审查。
  • README「O que você opera」：Nuvemshop、Webhooks、LGPD、Audit Log、MFA、API Tokens
  • README「Stack」：Supabase Storage（URLs assinadas），private bucket `whatsapp-media`
  • README「O que é」：项目从电商 CRM 起步，现支持 lojas 及 WhatsApp 销售
  • 项目洞察：LGPD 功能存在，但数据保留、删除、同意、供应商协议和跨境处理仍由部署企业负责
cp .env.example .env.local  # guia completo em docs/SETUP.md
材料未说明：README 未说明 Nuvemshop 集成支持哪些具体事件、字段映射和同步方向。；README 未说明 LGPD 页面是否自动执行删除、导出和同意记录，还是仅提供管理入口。；README 未说明私有媒体的默认保留周期和备份策略。

✨ 核心亮点

  • WAHA Plus 接入 WhatsApp，支持 AI 代理与人工协作
  • Supabase Postgres RLS 与 vector 支持多租户 RAG
  • VPS 安装包可用单条 curl 命令部署完整 CRM
  • 开发环境要求 Node 22、Docker 与 Supabase 扩展

🔧 工程化

  • Inbox、Kanban 与 Radar 管理 WhatsApp 对话和销售漏斗
  • Vercel AI SDK v7 对接 OpenRouter、Anthropic、OpenAI、Google
  • MCP 暴露 CRM 操作，代理可处理线索、自动化与移交

⚠️ 风险

  • 0001-0009 和 0013 是 stub，必须执行 baseline.sql 建库
  • 新 Supabase 项目需先启用 vector、citext、pg_trgm
  • SETUP.md 估计整合 Supabase、WAHA 等需 60–90 分钟
  • 生产部署依赖 VPS、Docker、WAHA Plus 与 Meta Cloud API

👥 适合谁？

  • 需要 WhatsApp 销售流程和多租户 RAG 的团队
  • 使用 Next.js、TypeScript、Supabase 的全栈开发者
  • 愿在 Docker VPS 自托管 CRM 与 WhatsApp 的企业