DeskcommCRM: CRM tự host có AI bán hàng trên WhatsApp — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về melgarafael/DeskcommCRM — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: DeskcommCRM: CRM tự host có AI bán hàng qua WhatsApp — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
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, tích hợp sẵn agent AI và WhatsApp để chăm sóc, phân loại và bán hàng qua chat. Bạn dùng nó thay cho các CRM trả phí theo tháng như Kommo, Octadesk, Intercom. Cài không quá khó: thuê một VPS có Docker, chạy một script và trả lời các câu hỏi, còn Node hay việc biên dịch thì README nói bạn không phải lo.
DeskcommCRM là một hệ thống CRM mã nguồn mở, tự cài trên máy chủ của bạn, có sẵn agent AI và kết nối WhatsApp. Tác giả gọi nó là “hệ điều hành bán hàng bằng AI”. Nó dành cho bất kỳ ai bán hàng qua chat: chủ shop, phòng khám, môi giới bất động sản, người bán khóa học, agency.
Vấn đề nó giải quyết khá quen thuộc. Khách nhắn WhatsApp đến liên tục, nhân viên trả lời không kịp, lead nguội dần mà không ai nhớ nhắn lại. Các CRM có sẵn thì tính phí theo tháng, và nhiều tính năng bị khóa ở gói cao. DeskcommCRM chạy trên VPS của bạn, dữ liệu nằm ở chỗ bạn, và README nói rõ là không có bản trả phí, không khóa tính năng.
Điểm đáng giá nhất là phần cài đặt. Bạn chạy một script, nó hỏi những thứ chỉ bạn biết (tên miền, khóa, mật khẩu admin) rồi tự làm phần còn lại. Hiện repo có khoảng 5.396 sao và 1.552 fork, và vẫn được cập nhật trong vài tháng gần đây. Bạn có thể xem video ngắn bên dưới để thấy tổng quan trước khi bắt tay vào.
melgarafael/DeskcommCRM
CRM mã nguồn mở tự host trên VPS của bạn, có agent AI trả lời, phân loại khách và chốt đơn trên WhatsApp, cài bằng một script.
I.DeskcommCRM làm được gì
A.Agent AI làm việc thật trong CRM
Agent AI không chỉ là chatbot trả lời cho có. Theo README, agent dùng kho kiến thức riêng của từng doanh nghiệp (RAG theo tenant). Nó tự chạy các kỹ năng trong lúc trò chuyện, phân tích cảm xúc của khách, và chuyển cho người thật khi cần. Mỗi lần chuyển đều được ghi lại. Có cả mức trần chi phí AI theo từng tổ chức, nên bạn không sợ hóa đơn AI phình ra ngoài ý muốn.
B.Không để khách “chết trong im lặng”
Hệ thống có tính năng follow-up để kéo lại cuộc trò chuyện đã nguội. Nó cũng có radar hiển thị những khách có nguy cơ bị bỏ quên không ai trả lời, và một trung tâm thông báo cho việc cần người quyết định. Với người bán hàng, đây là phần giữ doanh thu rõ nhất.
C.Agent tự cải thiện, nhưng có người duyệt
Các cuộc trò chuyện đã giải quyết xong có thể 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 không, hay sai ở đâu. Mục “Propostas” là những cải tiến AI tự đề xuất, và bạn phải duyệt thì mới áp dụng.
D.Dùng được cho nhiều ngành
Từ ngữ đổi được theo từng pipeline: “khách hàng” có thể thành “bệnh nhân” hay “người mua”, “won” có thể thành “đã thanh toán” hay “đã chốt”. Dự án khởi đầu từ thương mại điện tử (có tích hợp Nuvemshop) nhưng giờ dùng được cho phòng khám, bất động sản, sản phẩm số.
E.WhatsApp theo hai cách
Cách thứ nhất là quét mã QR (qua WAHA), hỗ trợ nhiều số, có cơ chế giảm nguy cơ bị khóa như giãn tốc độ gửi, thêm độ trễ ngẫu nhiên và giới hạn khung giờ. Cách thứ hai là kênh chính thức của Meta (Cloud API) với template đã được duyệt.
F.Chọn nhà cung cấp AI
Bạn dùng OpenRouter, Anthropic hoặc OpenAI. Chọn lúc cài, đổi sau trong giao diện, và có thể chọn khác nhau cho từng phần của hệ thống.
G.Phân quyền, nhiều tenant, tuân thủ dữ liệu
Hệ thống có phân quyền phía server, giao việc và chuyển việc có ghi vết, hàng chờ chia đều, và định tuyến tự động theo ý định của khách. README cũng nói đến cách ly dữ liệu giữa các tenant và tuân thủ luật bảo vệ dữ liệu của Brazil (LGPD).
H.Webhook và tự động hóa
Mỗi tenant có thể tạo “nguồn thu lead”: một địa chỉ công khai dạng /api/v1/webhooks/in/<token> nhận lead từ landing page, form riêng hoặc Zapier/n8n bằng POST. Lead vào thẳng pipeline và giai đoạn bạn chọn, không cần viết code. Trên đó bạn dựng các luật QUANDO/SE/ENTÃO (tức KHI / NẾU / THÌ): gắn tag, chuyển lead sang giai đoạn khác, giao cho nhân viên, gửi tin WhatsApp hoặc báo hệ thống khác qua webhook.
II.Cần chuẩn bị gì
Theo README, bạn cần năm thứ:
- VPS có Docker. README khuyến nghị 4 GB RAM. Tác giả hợp tác với HostGator nên có sẵn bộ cài cho đó, nhưng VPS nào có Docker cũng được. VPS ARM64 (ví dụ Oracle Ampere A1) cũng được hỗ trợ.
- Tên miền. Cần một bản ghi A trỏ về IP của VPS, ví dụ
crm.suaempresa.com.br. - Cơ sở dữ liệu. Một tài khoản miễn phí trên supabase.com. Bạn cần 3 khóa và chuỗi kết nối Session pooler. Nếu dự án Supabase bản miễn phí hay bị treo (lỗi
522hoặcPGRST002kéo dài hàng giờ), README gợi ý xem runbook vì gói Nano có thể không đủ. - Khóa AI. Một khóa của OpenRouter, Anthropic hoặc OpenAI. Script sẽ hỏi bạn dùng loại nào.
- Số WhatsApp. Kết nối bằng mã QR lúc onboarding, hoặc dùng kênh chính thức của Meta.
Bạn không cần cài Node hay pnpm và không phải biên dịch gì, vì README nói ảnh Docker của app đã dựng sẵn. File package.json có yêu cầu Node từ phiên bản 22 trở lên, nhưng điều đó chỉ liên quan nếu bạn tự chạy mã nguồn để phát triển.
Trên máy cá nhân, bạn chỉ cần một cửa sổ terminal để kết nối vào VPS. Trên Windows dùng PowerShell, trên Mac hoặc Linux dùng Terminal.
Mỗi lần script hỏi khóa AI hay khóa Supabase, bạn đang đưa quyền truy cập tài khoản của mình cho máy chủ này. Chỉ cài trên VPS của bạn, đừng dán khóa vào chat hay gửi ảnh chụp màn hình. Nhớ đặt giới hạn chi tiêu ở phía nhà cung cấp AI.
III.Cài đặt từng bước
- Vào VPSDùng ssh từ terminal để đăng nhập vào máy chủ
- Tải mãgit clone repo rồi cd vào thư mục
- Chạy bộ càibash hostgator-setup-kit/install.sh và trả lời các câu hỏi
- Mở trang webVào https://tên-miền-của-bạn, đăng nhập admin
- Kết nối WhatsAppQuét mã QR ở màn hình onboarding
A.Đăng nhập vào VPS
Mở terminal trên máy tính của bạn rồi kết nối bằng IP và cổng mà nhà cung cấp VPS gửi qua email:
ssh -p PORTA root@SEU_IPThay PORTA và SEU_IP bằng cổng và IP của bạn. Nếu nhà cung cấp không nhắc đến cổng thì đó là cổng mặc định 22, bạn có thể bỏ phần -p và gõ ssh root@SEU_IP.
Chỗ người mới hay vấp: khi nhập mật khẩu, 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. Cứ gõ hoặc dán rồi nhấn Enter. Lần kết nối đầu tiên sẽ hỏi Are you sure you want to continue connecting?, bạn trả lời yes.
B.Tải mã và chạy bộ cài
Khi đã ở trong VPS, chạy ba lệnh sau:
git clone https://github.com/melgarafael/DeskcommCRM.git
cd DeskcommCRM
bash hostgator-setup-kit/install.shLệnh đầu tải mã về, lệnh thứ hai vào thư mục vừa tải, lệnh thứ ba chạy bộ cài. Nếu máy chưa có Docker, bộ cài sẽ hỏi rồi tự cài giúp.
Bộ cài chỉ hỏi những thứ của riêng bạn: tên miền, các khóa, mật khẩu admin. Nó kiểm tra từng câu trả lời ngay, nên khóa sai sẽ bị từ chối luôn chứ không đợi đến ba bước sau. Sau đó nó làm các việc sau:
- Tự sinh các khóa bí mật kỹ thuật, bạn không phải nghĩ mật khẩu nào.
- Tạo extension cho Postgres và áp dụng toàn bộ schema (
supabase/baseline.sql). - Tạo admin đầu tiên với email và mật khẩu bạn chọn.
- Chạy toàn bộ hệ thống với HTTPS tự động, rồi kiểm tra tình trạng.
- Cài cron cho tự động hóa (thiếu nó thì các luật KHI/NẾU/THÌ nằm yên trong hàng chờ) và cài agent cập nhật, thứ làm cho nút “Atualizar agora” xuất hiện trên màn hình.
Chạy lại install.sh không gây hại vì nó idempotent: không nhân đôi cron, không tạo lại người dùng, và tiếp tục từ chỗ đã dừng.
Nếu bạn muốn nó tạo luôn dự án Supabase, README nói hãy đặt biến SUPABASE_ACCESS_TOKEN trước khi chạy. Khi đó bộ cài tự tạo dự án, chờ DB khỏe, lấy các thông tin đăng nhập và dò host pooler. README không ghi cú pháp đặt biến, nên bạn tự đặt theo cách thông thường của shell.
C.Cài không cần trả lời câu hỏi (tùy chọn)
Nếu bạn muốn chạy một mạch, copy file mẫu thành .env, điền thông tin, rồi chạy kèm cờ --yes:
cp .env.hostgator.example .env
bash hostgator-setup-kit/install.sh --yesLệnh cp chỉ là sao chép file mẫu. Bạn phải mở file .env vừa tạo, điền các giá trị của mình rồi mới chạy lệnh thứ hai.
D.Chưa có VPS thì sao
README có một script chạy ngay trên máy tính của bạn (macOS, Linux hoặc WSL). Nó cho biết nên chọn gói nào, kèm con số cụ thể, và đưa lại lệnh phù hợp:
curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/hostgator-setup-kit/comecar.sh | bashNếu bạn muốn đọc trước khi chạy, hãy clone repo rồi chạy bash hostgator-setup-kit/comecar.sh. README nói script này không cài gì khi bạn chưa xác nhận.
E.Dùng hosting khác
Hostinger, Coolify, Dokploy, CapRover… đều dùng được. Nếu VPS đã có proxy riêng chiếm cổng 80/443, bộ cài tự nhận ra và đưa CRM ra qua proxy đó. Trường hợp proxy chạy --network host như Hostinger, nó sẽ hỏi bạn thay vì tự đoán. Chi tiết nằm trong hostgator-setup-kit/README.md.
IV.Kiểm tra đã chạy được chưa
Sau khi bộ cài chạy xong, mở https://<tên-miền-của-bạn> trên trình duyệt. Ổ khóa HTTPS có thể mất khoảng 1 phút mới hiện. Đăng nhập bằng email và mật khẩu admin bạn vừa đặt. Nếu thấy màn hình onboarding yêu cầu quét mã QR bằng WhatsApp, nghĩa là hệ thống đã lên.
Bạn cũng có thể chạy kiểm tra trên VPS, trong thư mục repo:
bash hostgator-setup-kit/healthcheck.shScript chẩn đoán tất cả dịch vụ. Nó chỉ trả mã thoát 0 khi app tự báo trạng thái tổng thể là healthy, nên cũng dùng được cho cron hoặc công cụ giám sát. Khi app chưa khỏe, nó trả mã 1.
Xác thực hai bước (Google Authenticator hoặc Authy) là tùy chọn, bật ở Configurações › Segurança. Lần đăng nhập đầu không bắt buộc.
V.Dùng vào việc thật
A.Chủ shop: gom lead từ landing page vào pipeline
Bạn chạy quảng cáo về một landing page, khách điền form. Trong CRM, bạn tạo một nguồn thu lead để lấy địa chỉ webhook dạng /api/v1/webhooks/in/<token>, rồi gắn địa chỉ đó vào form (hoặc vào Zapier/n8n) để gửi POST dạng JSON hoặc form. Lead sẽ vào thẳng giai đoạn bạn chọn. Tiếp theo bạn tạo một luật tự động: KHI lead mới vào, THÌ gắn tag và gửi tin chào qua WhatsApp. Kết quả là lead không phải chép tay, và người mới được chào ngay thay vì chờ nhân viên rảnh.
Công cụ tốt nhất không phải cái nhiều tính năng nhất, mà là cái không để khách nào chết trong im lặng.
Ông T
B.Nhân viên chăm sóc khách: để AI trả lời trước, người thật chốt sau
Bạn nạp thông tin sản phẩm và câu hỏi thường gặp cho agent (kho kiến thức riêng của doanh nghiệp). Agent trả lời khách trên WhatsApp, hỏi thêm để phân loại nhu cầu và chuyển lead sang giai đoạn phù hợp. Khi khách cần người thật, agent chuyển cuộc trò chuyện cho nhân viên và hệ thống ghi lại việc chuyển. Cách này hợp với shop nhận nhiều tin lặp lại như giá, tình trạng hàng, giờ mở cửa, vì nhân viên chỉ phải vào cuộc ở lúc cần chốt.
C.Chủ phòng khám hoặc dịch vụ: đổi từ vựng cho đúng ngành
Bạn không bán hàng online mà đặt lịch cho bệnh nhân. Trong cấu hình pipeline, bạn đổi từ vựng: lead thành “Bệnh nhân”, trạng thái thắng thành “Đã đặt lịch”. Cả đội thấy đúng ngôn ngữ ngành của mình mà không cần một CRM khác. README cũng nói hệ thống có radar nhắc những khách có nguy cơ bị bỏ quên, giúp lễ tân không sót ai.
D.Lập trình viên mới: nhờ AI cài hộ
Nếu bạn quen dùng Claude Code, Codex, Cursor, OpenCode hoặc Antigravity, repo có sẵn các “hướng dẫn cho trợ lý”. Cài một lần bằng lệnh sau:
curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/scripts/instalar-guias.sh | bashSau đó mở một phiên mới của trợ lý và nói “quero instalar o CRM na minha VPS”. README nói hãy yêu cầu bằng tiếng Bồ Đào Nha thì mới kích hoạt đúng hướng dẫn. Để gọi đích danh: /deskcomm-instalar trong Claude Code, Cursor và Antigravity, $deskcomm-instalar trong Codex, còn OpenCode thì bạn nhờ bằng ngôn ngữ tự nhiên. Muốn gỡ thì chạy lại lệnh trên kèm bash -s -- --remover. Các hướng dẫn này không tự cập nhật, nên muốn bản mới bạn chạy lại lệnh cài.
VI.Lỗi hay gặp và cách xử lý
A.Gõ mật khẩu SSH mà màn hình trống trơn
Đây là hành vi bình thường. Terminal không hiển thị ký tự khi bạn nhập mật khẩu. Cứ gõ hoặc dán rồi nhấn Enter.
B.Trang web không mở hoặc không có ổ khóa HTTPS
Kiểm tra bản ghi A của tên miền đã trỏ đúng IP VPS chưa. Ổ khóa mất khoảng 1 phút mới hiện. Nếu VPS của bạn dùng proxy riêng (Hostinger, Coolify…), xem lại phần cấu hình trong hostgator-setup-kit/README.md, vì publish sai proxy có thể ra một trang trống dù cài “thành công”.
C.Supabase báo 522 hoặc PGRST002 kéo dài
README nói gói miễn phí với compute Nano có thể không đủ nếu dự án bị treo hàng giờ. Bạn xem runbook trong repo để chọn hướng xử lý. Bản miễn phí cũng không tự backup, nên hãy chạy backup.sh đều đặn.
D.Cập nhật báo nhiều dòng already exists hoặc multiple primary keys
README nói đây là điều bình thường và vô hại: script chỉ áp lại các thứ đã có, rồi lọc nhiễu và in ✓ banco atualizado. Nếu bạn 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ì phần cuối của kết quả sẽ hướng dẫn cách xử lý từng trường hợp.
E.Nút cập nhật trên màn hình không chạy
Nếu agent cập nhật không hoạt động, màn hình sẽ báo “Atualização automática indisponível” và đưa lệnh thay thế. Bạn chạy trong thư mục repo:
bash hostgator-setup-kit/update.shVớ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 vẫn là script cũ (nó tải bản mới về), lần hai mới cài agent và bật nút.
VII.Có nên dùng không
Điểm mạnh. Bạn sở hữu toàn bộ dữ liệu vì nó nằm trên VPS của bạn. Giấy phép MIT và không có bản trả phí. Cài đặt gần như một lệnh, cập nhật có backup tự động và tự quay lại ảnh cũ nếu bản mới lỗi. Agent AI có kiểm soát: có mức trần chi phí, có chuyển giao cho người, và các đề xuất cải tiến đều cần bạn duyệt.
Giới hạn. Bạn phải tự quản lý một VPS: tên miền, Docker, backup, giám sát. README và nhiều giao diện đều bằng tiếng Bồ Đào Nha, có bản tiếng Anh và Tây Ban Nha nhưng tôi chưa thấy thông tin về bản tiếng Việt. Dự án nhắm tới thị trường Brazil (LGPD, Nuvemshop, HostGator), nên phần tích hợp địa phương có thể không khớp nhu cầu ở Việt Nam. README cũng không nói gì về Zalo. Kết nối WhatsApp qua mã QR là cách không chính thức, nên dù có cơ chế giảm nguy cơ khóa số, bạn vẫn nên cân nhắc kênh chính thức của Meta cho số quan trọng.
Khi nên chọn cách khác. Nếu bạn không muốn quản trị máy chủ, hoặc chỉ cần một CRM nhỏ có Zalo, một dịch vụ thuê sẵn có thể hợp hơn. Nếu bạn bán hàng chủ yếu qua WhatsApp, muốn có AI trả lời và chủ động giữ dữ liệu, DeskcommCRM đáng thử trên một VPS nhỏ trước khi đưa vào dùng chính.
Câu hỏi thường gặp
DeskcommCRM có miễn phí không?
Repo dùng giấy phép MIT, và README nói rõ là không có bản trả phí hay tính năng bị khóa. Tuy vậy bạn vẫn phải trả tiền thuê VPS và phí dùng AI (OpenRouter, Anthropic hoặc OpenAI), còn Supabase có gói miễn phí.
Tôi có cần biết lập trình để cài không?
Bạn cần biết mở terminal, gõ ssh và chạy vài lệnh. README nói bạn không phải cài Node hay pnpm và không phải biên dịch gì, vì ảnh Docker của app đã dựng sẵn. Bộ cài sẽ hỏi từng thứ cần thiết rồi tự làm phần còn lại.
Cần cấu hình máy chủ thế nào?
README khuyến nghị VPS có Docker và 4 GB RAM, kèm một tên miền có bản ghi A trỏ về IP VPS. VPS ARM64 như Oracle Ampere A1 cũng được hỗ trợ. Tôi chưa thấy thông tin về yêu cầu GPU trong tư liệu.
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, không qua một dịch vụ CRM thuê ngoài. README nói bảng dữ liệu theo tenant có cách ly (RLS) và có kiểm thử trong CI, nhưng một Supabase bên ngoài vẫn lưu cơ sở dữ liệu ở bên đó. Bạn nên bật xác thực hai bước và chạy backup định kỳ.
Chạy được trên Windows không?
Phần chạy hệ thống nằm trên VPS (Linux), còn Windows chỉ dùng để kết nối: README hướng dẫn dùng PowerShell để chạy ssh. Script `comecar.sh` thì README ghi chạy trên macOS, Linux hoặc WSL.
Khác gì Kommo, Octadesk hay Intercom?
Tác giả định vị đây là lựa chọn mã nguồn mở thay thế các CRM đó. Khác biệt chính theo README là tự host, không phí bản quyền hàng tháng, agent AI gắn sẵn trong CRM và hỗ trợ MCP. Chưa có thông tin so sánh chi tiết từng tính năng.
Làm sao cập nhật và gỡ cài đặt?
Cập nhật có thể bấm “Nova versão” trong giao diện, hoặc chạy `bash hostgator-setup-kit/update.sh` ở terminal, và cả hai đều backup DB trước. Gỡ thì chạy `bash desinstalar_docker.sh`, script sẽ hỏi xác nhận rồi chỉ xóa container, volume và mạng của dự án này. Volume bị xóa kèm theo, gồm cả phiên WhatsApp cục bộ, nên hãy chạy `backup.sh` trước nếu cần giữ.


