适合谁
- 希望通过 WhatsApp 销售并愿意自行维护 VPS 的中小企业
- 需要多租户隔离与数据主权的团队
- 有技术能力按文档完成 Supabase、WAHA 与 AI 提供商配置的运营者
- 需要审计、RBAC、LGPD 能力的服务型业务（诊所、房产、电商、信息服务）
D
52FMRS · D
DeskcommCRM 是一个 MIT 许可、自托管的开源 CRM，核心卖点是在 WhatsApp 上运行 AI 智能体并把整个 CRM 通过 MCP 暴露给智能体操作，同时具备多租户 RLS、RBAC、审计与 LGPD 能力。它适合愿意自行运维 VPS 与 Supabase 的团队，不适合寻求托管、有 SLA 或零运维体验的用户。主要风险来自自托管责任、WhatsApp 非官方接入的封号可能、以及 cron 未安装导致自动化失效；文档提供了安装器、健康检查与恢复脚本等应对手段。作为 MCP 服务器，仓库指出其 MCP 能力存在且内部可用，公开 MCP 仍在路线图中，因此具体工具清单未被证据支持。
DeskcommCRM 是一个开源、自托管的 AI 销售操作系统（CRM），面向通过聊天销售的企业，定位为 Kommo、Octadesk 与 Intercom 的开源替代方案。它把 AI 智能体与 CRM 结合：智能体可按租户进行 RAG 检索、在服务过程中执行 skills、移动销售漏斗中的线索，并在合适时机转接给人工，相关交接有审计记录。WhatsApp 支持两条路径：通过 WAHA 扫码接入（多号码，带节流、抖动和发送时间窗口等防封措施），或使用 Meta 官方 Cloud API 通道（含已审批并同步的模板）。项目为多租户设计，所有涉及租户的表都启用 RLS，并将隔离测试作为 CI 门禁；包含 LGPD 能力（导出、匿名化、经审计的同意）、追加式审计日志、服务端 RBAC、按 pipeline 可配置的行业词汇、Webhooks（可接收线索的公开来源）以及 QUANDO/SE/ENTÃO 形式的自动化规则。仓库中描述了内部 MCP server 以及把 CRM 能力通过 MCP 暴露给外部智能体的计划。技术栈包括 Next.js 16、TypeScript、Supabase（Postgres + Auth + Storage + Realtime）、Tailwind + shadcn/ui、WAHA、Vercel AI SDK（OpenRouter、Anthropic、OpenAI 等）、Upstash Redis 限流与可选的 Sentry 遥测。安装以 hostgator-setup-kit 提供，可通过一条命令部署 app、WhatsApp 与数据库，支持从界面或脚本更新并自动备份。
安装接入
推荐使用自托管安装器（面向使用而非开发）：在带有 Docker 的 VPS 上执行 git clone https://github.com/melgarafael/DeskcommCRM.git，进入目录后运行 bash hostgator-setup-kit/install.sh。脚本会询问域名、Supabase 凭据、AI 提供商密钥和管理员密码，验证每个输入，生成技术密钥，创建 Postgres 扩展并应用 supabase/baseline.sql，创建首个管理员，启动整栈并启用 HTTPS，同时安装自动化 cron 和更新代理。非交互模式：复制 .env.hostgator.example 为 .env，填好后运行 bash hostgator-setup-kit/install.sh --yes。若 VPS 自带反向代理（Hostinger、Coolify、Dokploy、CapRover 等），安装器会自行检测并在其后面发布服务。安装完成后访问 https://<你的域名> 登录，并在引导中用 WhatsApp 扫描二维码。开发者本地环境需要 Node 22、pnpm、Supabase 项目、Docker（可选 WAHA）并手工应用 baseline.sql，详见 docs/SETUP.md。
选型与风险
不适合谁
- 希望开箱即用、无需自建服务器与 Supabase 项目的非技术用户
- 需要官方 SLA 或厂商托管支持的场景（项目为社区自助、as-is）
- 不愿配置第三方服务（Supabase、AI 提供商、WAHA、Upstash、Resend 等）的团队
- 需要自动更新的用户（更新需手动点击或运行脚本）
所需权限
- VPS 的 root 或等效权限（Docker、cron、80/443 端口）
- Supabase 项目的数据库连接与认证凭据（4 项凭据 + Session pooler 连接串）
- AI 提供商（OpenRouter、Anthropic 或 OpenAI）的 API 密钥
- WhatsApp 号码的扫码连接或 Meta Cloud API 官方通道凭据
- 可选：Upstash Redis、Sentry DSN、Resend、Nuvemshop 集成凭据
风险与副作用
- 自托管意味着你是实例的数据控制者，需自行承担 LGPD 合规、备份与维护责任
- 若未安装并运行 cron（event-log-drain），自动化规则会被创建但永不执行
- WhatsApp 通过非官方引擎（WAHA）连接存在账号被封的风险，项目依赖节流、抖动等缓解措施
- Supabase 免费计划不会自动备份，需自行调度 backup.sh
- 更新只应用于已发布的版本标签；如需回退旧版本必须显式使用 --force
- 可选 Sentry 遥测会发送错误报告，但已对 CPF、电话、邮箱等做脱敏，且可用 SENTRY_DSN=off 关闭
常见排障
- 应用不可用或出现异常时运行 bash hostgator-setup-kit/healthcheck.sh 并查看输出
- 自动化无反应时检查 install.sh/update.sh 是否安装了每分钟的 event-log-drain cron
- 基线应用报 type public.vector does not exist 时先手动创建 vector、citext、pg_trgm 扩展
- 更新后数据库出现 already exists / multiple primary keys 属预期噪音，关注脚本输出的警告
- 需要回退时运行 bash hostgator-setup-kit/restore.sh 恢复备份
- 界面提示“自动更新不可用”说明更新代理不在运行，可改用终端 update.sh
- 旧安装首次更新需运行 update.sh 两次以安装更新代理
- 报告问题时可附上 /api/v1/health 结果；安全问题请走私有漏洞报告而非公开 issue
使用场景
在自托管 CRM 中让 AI 智能体在 WhatsApp 上接待、筛选并推进销售线索
为通过聊天销售的企业提供多租户客服与销售管理（每个租户独立的 RAG 知识库）
用 Webhooks 接收来自落地页、表单或 Zapier/n8n 的线索并自动进入漏斗
用 QUANDO/SE/ENTÃO 规则自动打标签、移动线索、分配坐席或发送 WhatsApp 消息
满足 LGPD 要求的数据导出、匿名化与审计记录管理
作为 Kommo、Octadesk、Intercom 的开源自托管替代方案，数据留在自有服务器