# DeskcommCRM: CRM tự host có AI bán hàng qua WhatsApp — hướng dẫn cài đặt và dùng

> DeskcommCRM là một CRM mã nguồn mở (giấy phép MIT) chạy trên máy chủ của bạn, có agent AI chăm khách qua WhatsApp và tự động hoá theo quy tắc. Bạn thuê một VPS, chạy một script cài đặt và trả lời vài câu hỏi. Script lo phần còn lại, nên người không rành kỹ thuật vẫn cài được nếu làm theo từng bước.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-15 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/deskcommcrm-crm-tu-host-ai-ban-hang-whatsapp

DeskcommCRM là một CRM mã nguồn mở, chạy trên máy chủ riêng của bạn, có sẵn agent AI để trả lời, phân loại và chốt đơn với khách qua WhatsApp. Tác giả định vị nó là lựa chọn mở thay cho Kommo, Octadesk hay Intercom. Mã nguồn dùng giấy phép MIT, nên bạn không trả phí theo tháng cho phần mềm và không bị khoá tính năng. Repo hiện có khoảng 5.396 sao và 1.552 fork.

Nếu bạn bán hàng chủ yếu bằng tin nhắn (shop online, phòng khám, môi giới bất động sản, bán khoá học, agency…), repo này dành cho bạn. Khách nhắn tới là có người hoặc AI trả lời. Mỗi cuộc trò chuyện nằm trong một phễu bán hàng để bạn theo dõi. Dữ liệu nằm trên VPS của bạn, không nằm ở nền tảng của người khác.

Điểm đáng giá nhất là cách cài. README viết cho người không rành kỹ thuật: bạn thuê VPS, đăng nhập, chạy ba lệnh, rồi trả lời các câu hỏi mà script đặt ra. Bạn không cần cài Node hay biên dịch gì. Bài này đi qua từng bước, kèm các chỗ người mới hay vấp.

```repo
- repo | melgarafael/DeskcommCRM
- kind | Ứng dụng
- desc | CRM mã nguồn mở tự host, có agent AI trả lời, phân loại khách và bán hàng qua WhatsApp. Cài lên VPS bằng một lệnh, không thu phí theo tháng.
- stars | 5.4k
- lang | TypeScript
- license | MIT
```

```video
- youtube | https://youtube.com/shorts/71AX3Jj-pcI
- facebook | https://www.facebook.com/reel/1505209901456101
- title | Video giới thiệu DeskcommCRM
```

## DeskcommCRM làm được gì

Tên Deskcomm là ghép của “Desk” (cái bàn) và “comm” (thương mại): toàn bộ việc bán hàng gom vào một chỗ, do người và AI cùng làm. Dự án ban đầu làm cho thương mại điện tử, sau đó cộng đồng dùng sang nhiều ngành khác. Các tính năng chính:

- **Agent AI vận hành được CRM.** Agent có kho kiến thức riêng cho từng tenant (RAG), tự chạy các “skill” khi đang tiếp khách, phân tích cảm xúc và chuyển cho người thật khi cần (có ghi lại lịch sử). Bạn cũng đặt được mức chi tối đa cho AI theo từng tổ chức, nên không lo hoá đơn AI phình ra ngoài ý muốn.
- **Không để khách “chết” trong im lặng.** Hệ thống tự nhắn lại những cuộc trò chuyện nguội dần, đánh dấu khách có nguy cơ mất vì chưa được trả lời, và có trung tâm thông báo cho những việc cần người quyết định.
- **Agent tự cải thiện.** Cuộc trò chuyện đã giải quyết xong trở thành kiến thức mới. Màn hình “Evolução da IA” cho biết agent đang tốt lên hay chưa, sai ở đâu. Các “Propostas” là đề xuất cải tiến do chính AI đưa ra, và bạn phải duyệt thì mới áp dụng.
- **Dùng cho nhiều ngành.** Từ vựng đổi được theo từng phễu: “lead” có thể thành Khách hàng, Bệnh nhân hay Người mua. “Won” có thể thành Đã thanh toán, Đã đặt lịch hay Đã chốt. Có tích hợp Nuvemshop cho shop online.
- **WhatsApp hai kiểu.** Một là quét mã QR (qua WAHA, nhiều số, có cơ chế giãn nhịp gửi để hạn chế bị khoá). Hai là kênh chính thức của Meta (Cloud API, dùng template đã duyệt).
- **Chọn AI tuỳ ý.** OpenRouter, Anthropic hoặc OpenAI, chọn lúc cài và đổi lại được trên giao diện.
- **Phân quyền và LGPD.** Có phân quyền (RBAC) phía máy chủ, chuyển giao khách có ghi vết, chia khách luân phiên và định tuyến theo ý định của khách. Mỗi tổ chức bị cô lập dữ liệu với nhau, ưu tiên ẩn danh hoá hơn là xoá. LGPD là luật bảo vệ dữ liệu của Brazil, nơi tác giả làm dự án.
- **Webhook và tự động hoá.** Bạn tạo “nguồn thu khách”, tức một địa chỉ công khai để landing page, form hoặc Zapier/n8n gửi khách mới vào thẳng phễu. Trên đó bạn lập quy tắc dạng QUANDO/SE/ENTÃO (KHI/NẾU/THÌ) để gắn thẻ, chuyển giai đoạn, giao cho nhân viên hay gửi tin WhatsApp.

Repo còn nhắc tới MCP, nghĩa là các agent bên ngoài có thể thao tác với CRM. Phần này README mô tả chi tiết ở đoạn sau, mình chỉ nêu để bạn biết.

## Cần chuẩn bị gì

Theo README, bạn cần năm thứ sau:

| Thứ cần có | Chi tiết |
|---|---|
| VPS có Docker | Khuyến nghị 4 GB RAM. README gợi ý HostGator (đối tác của dự án) hoặc VPS nào có Docker cũng được. Nếu máy chưa có Docker, script hỏi rồi tự cài. |
| Tên miền | Một bản ghi **A** trỏ về IP của VPS, ví dụ `crm.suaempresa.com.br`. |
| Cơ sở dữ liệu | Tài khoản miễn phí trên supabase.com: 3 khoá và connection string loại **Session pooler**. |
| Khoá AI | Một khoá của OpenRouter, Anthropic hoặc OpenAI. Script sẽ hỏi bạn dùng loại nào. |
| WhatsApp | Số điện thoại của bạn, kết nối bằng mã QR lúc onboarding (hoặc kênh chính thức của Meta). |

Về hệ điều hành: bạn làm việc trên máy của mình bằng Terminal (Windows dùng PowerShell, Mac/Linux dùng Terminal) để SSH vào VPS. Còn lệnh cài chạy trên VPS. Script cũng hỗ trợ VPS ARM64 như Oracle Ampere A1.

Có hai điểm cần biết trước. Một, README nói thẳng: nếu dự án Supabase gói miễn phí bị treo (lỗi `522` hoặc `PGRST002` kéo dài hàng giờ), có thể gói Nano không đủ, và bạn cần xem runbook của repo. Hai, nếu bạn xuất sẵn biến `SUPABASE_ACCESS_TOKEN` trước khi chạy, script có thể tự tạo dự án Supabase và lấy các khoá giúp bạn.

```note
Bạn sẽ nhập khoá AI, khoá Supabase và mật khẩu admin vào script cài. Đừng dán các thông tin này vào chat công khai hay ảnh chụp màn hình. Khoá AI có thể phát sinh chi phí theo mức bạn dùng, nên nên đặt mức chi tối đa trong CRM.
```

## Cài đặt từng bước

```steps
- Vào VPS | Dùng SSH từ Terminal/PowerShell trên máy bạn để đăng nhập vào máy chủ
- Tải mã nguồn | Dùng git clone rồi cd vào thư mục DeskcommCRM
- Chạy trình cài | Chạy install.sh và trả lời các câu hỏi (tên miền, khoá, mật khẩu admin)
- Đăng nhập | Mở https://tên-miền-của-bạn, vào bằng tài khoản admin vừa tạo
- Nối WhatsApp | Quét mã QR ở màn hình onboarding
```

### Vào VPS bằng SSH

Mở Terminal trên máy bạn (Windows: PowerShell; Mac/Linux: Terminal) rồi kết nối với IP và cổng mà nhà cung cấp VPS gửi qua email:

```bash
ssh -p PORTA root@SEU_IP
```

Thay `PORTA` và `SEU_IP` bằng cổng và IP của bạn. Nếu nhà cung cấp không nhắc tới cổng thì dùng cổng mặc định 22 và có thể bỏ `-p`:

```bash
ssh root@SEU_IP
```

Hệ thống hỏi mật khẩu. **Khi gõ, màn hình không hiện gì, kể cả dấu sao.** Đó không phải treo máy, chỉ là terminal giấu mật khẩu. Bạn cứ gõ hoặc dán rồi nhấn Enter. Lần đầu kết nối, nó hỏi `Are you sure you want to continue connecting?`. Bạn trả lời `yes`.

### Tải mã nguồn và chạy trình cài

Bây giờ bạn đang ở trong VPS. Chạy ba lệnh sau:

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

Lệnh đầu tải mã nguồn về. Lệnh thứ hai chui vào thư mục vừa tải. Lệnh thứ ba chạy trình cài đặt. README nói bạn không cần cài Node, pnpm hay biên dịch gì, vì ảnh Docker của ứng dụng đã dựng sẵn.

Trình cài chỉ hỏi những thứ thuộc về bạn: tên miền, các khoá và mật khẩu admin. Nó kiểm tra từng câu trả lời ngay khi bạn nhập, nên khoá sai bị từ chối ngay chứ không để đến ba bước sau mới lỗi. Sau đó nó tự làm các việc sau:

1. Sinh tất cả bí mật kỹ thuật, bạn không phải tự nghĩ mật khẩu nào.
2. Tạo các extension của Postgres và áp dụng schema đầy đủ (`supabase/baseline.sql`).
3. Tạo admin đầu tiên với email và mật khẩu bạn đã chọn.
4. Dựng toàn bộ hệ thống với HTTPS tự động, rồi kiểm tra sức khoẻ ở cuối.
5. Cài cron cho automation và “agent cập nhật” (nhờ đó nút “Atualizar agora” mới có trên màn hình).

Chạy lại `install.sh` không gây hỏng gì: script này idempotent, không nhân đôi cron, không tạo lại người dùng, và chạy tiếp từ chỗ đang dở.

Nếu muốn chạy không cần trả lời câu hỏi, README có chế độ không tương tác. Bạn sao chép `.env.hostgator.example` thành `.env`, điền đủ giá trị rồi chạy:

```bash
bash hostgator-setup-kit/install.sh --yes
```

### Nếu VPS không phải HostGator

README cho biết cách này chạy được trên Hostinger, Coolify, Dokploy, CapRover… Nếu VPS đã có proxy ngược chiếm cổng 80/443, trình cài tự nhận ra và đưa CRM ra ngoài qua proxy đó. Riêng trường hợp proxy chạy `--network host` (như Hostinger), nó sẽ hỏi bạn thay vì đoán. Chi tiết nằm ở `hostgator-setup-kit/README.md`.

### Muốn một AI cài giúp?

Repo có các “hướng dẫn cho trợ lý” chạy được với Claude Code, Codex, Cursor, OpenCode hoặc Antigravity. Cài chúng một lần bằng lệnh sau trên máy bạn:

```bash
curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/scripts/instalar-guias.sh | bash
```

Sau đó mở phiên mới của trợ lý và nói “quero instalar o CRM na minha VPS” (README viết bằng tiếng Bồ Đào Nha). Muốn gọi đích danh thì dùng `/deskcomm-instalar` trong Claude Code, Cursor, Antigravity; `$deskcomm-instalar` trong Codex. Muốn gỡ các hướng dẫn này:

```bash
curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/scripts/instalar-guias.sh | bash -s -- --remover
```

Lưu ý: lệnh `curl ... | bash` chạy thẳng một script từ mạng. Nếu bạn muốn đọc trước, hãy tải repo về và xem file trong thư mục `scripts/`.

## Kiểm tra đã chạy được chưa

Mở `https://<tên-miền-của-bạn>`. README nói ổ khoá HTTPS mất khoảng 1 phút mới hiện ra. Bạn đăng nhập bằng tài khoản admin đã tạo. Ở màn hình onboarding, quét mã QR bằng WhatsApp của số bạn muốn nối.

Xác thực hai bước là tuỳ chọn. Nó nằm ở Configurações › Segurança và lần đăng nhập đầu **không** bắt buộc.

Muốn kiểm tra bằng lệnh, chạy trong thư mục repo trên VPS:

```bash
bash hostgator-setup-kit/healthcheck.sh
```

Script này chẩn đoán các dịch vụ và chỉ trả về mã 0 khi ứng dụng tự báo trạng thái tổng thể là `healthy`. Vì thế bạn cũng dùng được nó cho cron hoặc công cụ giám sát.

Sau khi cài xong, README giới thiệu một khoá học trực quan miễn phí (trên trang chủ dự án) với ảnh màn hình thật, hướng dẫn dùng hộp thư, sắp xếp phễu và cấu hình agent AI.

## Dùng vào việc thật

Mình không có ví dụ chính thức nào từ README cho các tình huống dưới đây. Đây là cách áp dụng các tính năng đã được mô tả vào công việc.

### Chủ shop online: nhận khách từ landing page

Bạn chạy quảng cáo và có một form đăng ký trên landing page. Trong CRM, bạn tạo một **nguồn thu khách**. Hệ thống cho bạn một địa chỉ dạng `/api/v1/webhooks/in/<token>`. Bạn cấu hình form (hoặc Zapier/n8n) gửi dữ liệu POST tới địa chỉ đó, dưới dạng JSON hoặc `application/x-www-form-urlencoded`. Khách mới tự xuất hiện trong phễu và giai đoạn bạn chọn, không cần viết code. Nếu bán qua Nuvemshop, repo có tích hợp riêng cho nền tảng này.

### Nhân viên văn phòng: tự động hoá chăm khách

Bạn muốn mỗi khi khách chuyển sang giai đoạn “Đã báo giá” thì gắn thẻ và giao cho một nhân viên. Vào phần automation và tạo quy tắc QUANDO/SE/ENTÃO: KHI lead đổi giai đoạn, NẾU thoả điều kiện, THÌ thêm thẻ và gán người phụ trách. Bạn cũng thêm được hành động gửi tin WhatsApp hoặc gọi webhook ra hệ thống khác. Khi chạy, nhớ rằng cron mà trình cài đã dựng phải hoạt động, vì README nói thiếu nó thì các quy tắc sẽ nằm chờ trong hàng đợi.

> Không phải chatbot trang trí: agent trả lời, phân loại khách và tự đưa khách đi trong phễu.
>
> — Ông T

### Phòng khám hoặc môi giới: đổi tên theo ngành

Từ “lead” của CRM nghe khá xa lạ với phòng khám. Trong phễu, bạn đổi từ vựng: lead thành “Bệnh nhân”, trạng thái chốt thành “Đã đặt lịch”. Cùng một hệ thống phục vụ được clinic, bất động sản hoặc bán khoá học mà nhân viên không bị rối. Bạn chỉ cần đặt từ vựng trong cấu hình của từng pipeline.

### Chủ doanh nghiệp: để AI trực và có người duyệt

Bạn nạp tài liệu bán hàng vào kho kiến thức của agent để nó trả lời khách thông thường. Khi gặp câu hỏi khó hoặc khách có vẻ bực, agent chuyển cho người thật và hệ thống ghi lại việc chuyển giao. Mỗi tuần bạn mở màn hình “Evolução da IA” xem agent sai ở đâu và duyệt các “Propostas”. AI chỉ áp dụng cải tiến sau khi bạn đồng ý.

## Lỗi hay gặp và cách xử lý

### Gõ mật khẩu SSH mà không thấy gì

Đây không phải lỗi. Terminal cố ý giấu mật khẩu. Bạn gõ hoặc dán đúng rồi nhấn Enter. Nếu bị từ chối, kiểm tra lại IP, cổng và mật khẩu trong email của nhà cung cấp.

### Supabase bị treo (`522` hoặc `PGRST002`)

README cảnh báo gói miễn phí với compute Nano đôi khi không đủ nếu dự án chạy lâu mà báo lỗi này hàng giờ. Cách an toàn là xem runbook của repo (`hostgator-setup-kit/README.md`) và cân nhắc nâng gói Supabase. Đồng thời lưu ý gói miễn phí không tự backup, nên hãy lên lịch chạy `backup.sh` hằng ngày.

### Trang web không mở hoặc không có HTTPS

Trước hết đợi khoảng một phút, vì README nói ổ khoá cần ngần đó thời gian. Nếu vẫn không lên, kiểm tra bản ghi A của tên miền đã trỏ đúng IP VPS chưa, vì tên miền là thứ trình cài cần để cấp HTTPS. Với VPS đã có proxy riêng chiếm cổng 80/443, đọc phần “Outra hospedagem” trong README để biết cách trình cài xử lý.

### Cập nhật thấy nhiều dòng `already exists` hoặc `multiple primary keys`

Theo README, đây là hiện tượng bình thường và vô hại, vì script cập nhật chạy lại `baseline.sql` đã có sẵn nhiều thứ. Script lọc nhiễu và cuối cùng báo `✓ banco atualizado`. Nếu thấy dòng cảnh báo `Apareceram avisos no banco que NÃO são os esperados`, hãy lưu lại thông báo và đọc phần cuối của kết quả, vì nó hướng dẫn cách xử lý từng trường hợp.

### Nút “Atualizar agora” báo “Atualização automática indisponível”

Nghĩa là agent cập nhật trên VPS không chạy. Màn hình sẽ hiện lệnh dự phòng. Bạn có thể cập nhật bằng terminal:

```bash
cd /caminho/do/DeskcommCRM
bash hostgator-setup-kit/update.sh
```

Với bản cài cũ chưa có agent này, README dặn chạy `update.sh` hai lần: lần đầu là bản script cũ (nó tải bản mới), lần hai mới cài agent. Script cập nhật luôn backup trước khi đụng vào dữ liệu và chỉ lên bản đã gắn thẻ, không lên commit chưa kiểm thử.

```note
Lệnh desinstalar_docker.sh xoá cả volume Docker, kể cả phiên WhatsApp cục bộ. Hãy chạy backup.sh trước nếu bạn còn cần dữ liệu.
```

Nếu muốn gỡ cài đặt, chạy ở thư mục gốc repo:

```bash
bash desinstalar_docker.sh
```

Script chỉ xoá container, volume và mạng nội bộ của dự án này, rồi hỏi bạn gõ `REMOVER-<tên-dự-án>` để xác nhận. Nó không đụng tới ứng dụng khác trên cùng máy chủ, mã nguồn, `.env` hay backup.

## Có nên dùng không

**Điểm mạnh.** Bạn giữ dữ liệu trên VPS của mình, giấy phép MIT, không bị khoá tính năng. Cài đặt và cập nhật gọn (một lệnh hoặc một nút bấm, có backup trước khi cập nhật). Agent AI làm được việc thật trong CRM chứ không chỉ trả lời cho có. Repo còn được cập nhật trong 3 tháng gần đây.

**Giới hạn.** Bạn phải tự lo máy chủ: thuê VPS, tên miền, Supabase, khoá AI, và tự backup. Tài liệu chính được viết bằng tiếng Bồ Đào Nha, có bản tiếng Anh và Tây Ban Nha, chưa có bản tiếng Việt. Hệ thống dùng WhatsApp qua mã QR (WAHA) nên có rủi ro bị khoá số nếu gửi sai cách, dù README nói có cơ chế giãn nhịp. Chi phí AI do bạn trả cho nhà cung cấp. Dự án cũng đi kèm khá nhiều thành phần (Docker Compose, Supabase, WAHA…), nên khi hỏng bạn cần đọc runbook.

**Khi nên chọn cách khác.** Nếu bạn chỉ cần một công cụ chat nhỏ cho vài khách mỗi ngày, một CRM có sẵn dạng thuê bao có thể đỡ việc hơn. Còn nếu bạn bán hàng chủ yếu qua WhatsApp, muốn làm chủ dữ liệu và chấp nhận tự vận hành một máy chủ, DeskcommCRM đáng thử trên một VPS nhỏ trước khi đưa vào dùng thật.

## Câu hỏi thường gặp

### DeskcommCRM có miễn phí không?

Phần mềm là mã nguồn mở với giấy phép MIT, README nói không có phiên bản trả phí hay tính năng bị khoá. Tuy nhiên bạn vẫn phải trả tiền cho VPS, tên miền và khoá AI (OpenRouter, Anthropic hoặc OpenAI). Gói miễn phí của Supabase dùng được, nhưng README lưu ý nó có thể không đủ nếu dự án bị treo.

### Cài có cần biết lập trình không?

README viết cho người không rành kỹ thuật. Bạn chỉ cần SSH vào VPS và chạy ba lệnh, rồi trả lời các câu hỏi của trình cài. Bạn không phải cài Node hay biên dịch, vì ảnh ứng dụng đã dựng sẵn và nếu thiếu Docker thì trình cài sẽ hỏi rồi tự cài.

### Có cần GPU không?

Tư liệu không nhắc tới GPU. AI chạy qua khoá API của OpenRouter, Anthropic hoặc OpenAI. VPS được khuyến nghị 4 GB RAM.

### Chạy trên Windows được không?

Trình cài chạy trên VPS Linux. Máy Windows của bạn chỉ dùng PowerShell để SSH vào VPS. Với lệnh cài guide cho trợ lý AI và lệnh comecar.sh, README ghi dùng được trên macOS, Linux hoặc WSL.

### Dữ liệu của tôi có an toàn không?

Dữ liệu nằm trên VPS của bạn và trong dự án Supabase của bạn. README nói mỗi tổ chức bị cô lập bằng RLS, có audit log giữ 5 năm và ưu tiên ẩn danh hoá hơn xoá. Việc backup là của bạn: gói miễn phí Supabase không tự backup nên nên đặt lịch chạy backup.sh.

### Khác gì Kommo, Octadesk hay Intercom?

Tác giả định vị DeskcommCRM là lựa chọn mở thay cho các dịch vụ đó. Điểm khác chính là tự host, không thu phí theo tháng, không khoá tính năng và có sẵn agent AI thao tác được trong CRM. Tư liệu không có bảng so sánh chi tiết từng tính năng.

### Cập nhật phiên bản mới thế nào?

Có hai cách. Cách thứ nhất là bấm “Nova versão” ở menu rồi vào Configurações → Atualização, hệ thống tự backup và cập nhật, có thể mất tới 5 phút mới bắt đầu. Cách thứ hai là chạy `bash hostgator-setup-kit/update.sh` trong thư mục repo trên VPS.
