SELF HOSTING

Hướng dẫn cài đặt và sử dụng Twenty – Hệ thống CRM mã nguồn mở

Trong thời đại chuyển đổi số, quản lý quan hệ khách hàng (CRM) đã trở thành yếu tố then chốt quyết định sự thành bại của doanh nghiệp. Tuy nhiên, các giải pháp CRM truyền thống như Salesforce thường đi kèm với mức giá cao ngất ngưởng và tính năng phức tạp khiến nhiều doanh nghiệp vừa và nhỏ (SME) do dự.

Chính vì vậy, Twenty CRM ra đời như một luồng gió mới – một hệ thống quản lý quan hệ khách hàng mã nguồn mở hoàn toàn miễn phí, hiện đại và mạnh mẽ. Với hơn 36,400 stars trên GitHub và cộng đồng 536 contributors tích cực đóng góp, Twenty đang nhanh chóng trở thành lựa chọn hàng đầu thay thế Salesforce cho các doanh nghiệp muốn kiểm soát hoàn toàn dữ liệu khách hàng mà không phải chịu chi phí đắt đỏ.

Bài viết này sẽ hướng dẫn bạn chi tiết về Twenty CRM – từ tổng quan, tính năng nổi bật, đến cách cài đặt và sử dụng thực tế cho doanh nghiệp của bạn.

Twenty CRM là gì?

Tổng quan về Twenty CRM

Twenty CRM là nền tảng quản lý quan hệ khách hàng mã nguồn mở số 1 được phát triển trên GitHub tại https://github.com/twentyhq/twenty. Đây là giải pháp hiện đại, mạnh mẽ và giá cả phải chăng giúp doanh nghiệp quản lý toàn bộ thông tin khách hàng, quy trình bán hàng và tương tác với khách một cách hiệu quả.

Twenty được xây dựng trên nền tảng công nghệ tiên tiến bao gồm TypeScript, React, NestJS, PostgreSQL và Redis, mang đến trải nghiệm người dùng mượt mà và khả năng tùy biến cao. Phiên bản mới nhất v1.8.0 được phát hành vào tháng 10/2025, liên tục cập nhật tính năng mới và cải thiện hiệu suất.

Vì sao cần một CRM mới?

Theo thông tin từ repository chính thức, Twenty được tạo ra dựa trên ba lý do cốt lõi:

1. CRM truyền thống quá đắt đỏ và “nhốt” người dùng

Các công ty CRM thương mại như Salesforce thường lợi dụng việc “khóa” dữ liệu khách hàng để tăng giá liên tục. Một gói Salesforce cơ bản có thể tốn từ $25/người dùng/tháng trở lên, trong khi Twenty hoàn toàn miễn phí và cho phép bạn sở hữu 100% dữ liệu.

2. Cần một khởi đầu mới để tạo trải nghiệm tốt hơn

Twenty học hỏi từ những sai lầm của các CRM cũ và tạo ra trải nghiệm liền mạch lấy cảm hứng từ các công cụ hiện đại như Notion, Airtable và Linear. Giao diện tối giản, thân thiện với người mới bắt đầu, kết hợp phím tắt và khả năng tìm kiếm mạnh mẽ giúp tăng hiệu suất làm việc.

3. Tin tưởng vào mã nguồn mở và cộng đồng

Với giấy phép GPL, Twenty đảm bảo bạn sở hữu phần mềm chứ không phải thuê. Cộng đồng hàng trăm developers đang cùng xây dựng Twenty, và khi tính năng plugin ra mắt, một hệ sinh thái hoàn chỉnh sẽ phát triển xung quanh nền tảng này.

So sánh Twenty CRM với Salesforce và HubSpot

Tiêu chíTwenty CRMSalesforceHubSpot CRM
Chi phíMiễn phí (mã nguồn mở)$25+/người dùng/thángMiễn phí cơ bản, $20+/user cho premium
Tùy biếnRất cao – tùy chỉnh objects, fields, workflows​Hạn chế trừ khi trả phí caoTrung bình​
Quyền sở hữu dữ liệu100% kiểm soát – self-hostedVendor control​Vendor control
Giao diệnHiện đại, tối giản, dễ họcPhức tạp, khó làm quen​Thân thiện người dùng
Mã nguồn mởCó (GPL)​Không​Không
API Access100% GraphQL & REST​Có nhưng phức tạp​Có​
Self-hostingHỗ trợ đầy đủ​Không​Không

Twenty vượt trội rõ rệt về tính tùy biến, chi phí và quyền kiểm soát dữ liệu, trong khi Salesforce mạnh về tính năng phức tạp cho doanh nghiệp lớn và HubSpot tốt cho marketing automation.

Tính năng nổi bật của Twenty CRM

1. Tùy chỉnh objects và fields không giới hạn

Twenty cho phép bạn tùy biến hoàn toàn cấu trúc dữ liệu theo nhu cầu doanh nghiệp. Bạn có thể tạo các custom objects (đối tượng tùy chỉnh), thêm/bớt fields (trường thông tin), và thiết lập mối quan hệ giữa các đối tượng một cách linh hoạt.

Ví dụ thực tế: Một công ty bất động sản có thể tạo object “Bất động sản” với các fields như địa chỉ, giá, diện tích, và liên kết với object “Khách hàng tiềm năng”.

2. Quản lý contacts, companies, tasks và notes

Twenty cung cấp 4 module cốt lõi để quản lý toàn diện hoạt động kinh doanh:

  • People (Contacts): Quản lý thông tin cá nhân khách hàng với email làm định danh duy nhất
  • Companies: Quản lý thông tin doanh nghiệp với domain làm định danh
  • Tasks: Theo dõi công việc, deadline, và phân công cho team members
  • Notes: Ghi chép quan sát, ý kiến về khách hàng và dự án

Mỗi record (bản ghi) có timeline view hiển thị toàn bộ lịch sử tương tác theo thứ tự thời gian, giúp team nắm rõ toàn bộ hành trình khách hàng.

3. Kanban và table views linh hoạt

Twenty hỗ trợ nhiều cách hiển thị dữ liệu phù hợp với từng phong cách làm việc:

  • Kanban View: Trực quan hóa workflow với drag-and-drop, lý tưởng cho quản lý sales pipeline​
  • Table View: Hiển thị dạng lưới để xem, thêm, sửa, xóa records nhanh chóng​
  • Custom Views: Tạo views riêng với filters, sort, group by theo nhu cầu từng team

4. Workflow automation mạnh mẽ

Tự động hóa quy trình là điểm mạnh nổi bật của Twenty. Bạn có thể thiết lập workflows tự động kích hoạt dựa trên các hành động cụ thể:

  • Tự động gửi email follow-up sau cuộc họp​
  • Tự động tạo task khi có lead mới​
  • Tự động cập nhật trạng thái deal khi nhận email từ khách hàng​

Twenty tích hợp với ZapierWindmill để mở rộng khả năng automation không giới hạn.

5. Tích hợp email và calendar

Twenty hỗ trợ đồng bộ với các dịch vụ email và lịch phổ biến:

  • Gmail & Google Calendar: Tự động tạo contacts khi gửi/nhận email, đồng bộ lịch họp
  • Microsoft 365 & Outlook: Tích hợp đầy đủ với hệ sinh thái Microsoft
  • Email Threading: Liên kết emails với contacts tương ứng, tạo lịch sử giao tiếp hoàn chỉnh

Khi bạn gửi email cho người chưa có trong CRM, Twenty tự động tạo Person record mới, tiết kiệm thời gian nhập liệu đáng kể.

6. REST & GraphQL API đầy đủ

Twenty cung cấp 100% API access với cả REST và GraphQL:

  • GraphQL: Kiểm soát chính xác dữ liệu cần lấy, tối ưu hiệu suất
  • REST API: Tích hợp dễ dàng với third-party services bằng HTTP methods chuẩn
  • API Playground: Test API calls trực tiếp trong app tại Settings → APIs & Webhooks

Bạn có thể tạo API keys với tên mô tả và expiration date từ Settings, cho phép automation và tích hợp không giới hạn.

7. Quản lý Permissions và Workspaces

Twenty hỗ trợ custom roles để quản lý quyền truy cập chi tiết, đảm bảo mỗi thành viên chỉ thấy dữ liệu phù hợp với vai trò.​

Workspaces là môi trường độc lập trong Twenty, cho phép doanh nghiệp hoạt động đa thị trường/ngành nghề dùng các workspace riêng mà không ảnh hưởng lẫn nhau.

8. Advanced Search Bar

Thanh tìm kiếm nâng cao giúp truy xuất thông tin tức thì từ dataset lớn. Bạn có thể tìm contacts, notes, deals, tasks chỉ bằng vài từ khóa, tăng tốc độ làm việc đáng kể.​

Yêu cầu hệ thống

Trước khi cài đặt Twenty CRM, đảm bảo máy chủ của bạn đáp ứng các yêu cầu sau:

Phần cứng

  • RAM: Tối thiểu 2GB (khuyến nghị 4GB cho sản xuất)​
  • Disk Space: Tối thiểu 5GB cho database và storage​
  • CPU: 2 cores trở lên cho hiệu suất tốt

Phần mềm

  • Docker: Phiên bản mới nhất​
  • Docker Compose: Phiên bản mới nhất
  • PostgreSQL: Version 16 (tự động cài qua Docker)
  • Redis: Cho cache và message queue

Các hệ điều hành được hỗ trợ

  • Ubuntu 24.04 LTS (khuyến nghị)
  • Debian
  • macOS
  • Windows (qua WSL2)​
  • ARM-based systems (Raspberry Pi, Apple Silicon)​

Hướng dẫn cài đặt Twenty CRM

Bước 1: Cài đặt Docker và Docker Compose

Trên Ubuntu/Debian:

# Cập nhật package list
sudo apt-get update

# Cài đặt các dependencies cần thiết
sudo apt-get install -y ca-certificates curl gnupg lsb-release

# Thêm Docker GPG key
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# Thiết lập Docker repository
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Cài đặt Docker Engine và Docker Compose
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Kiểm tra cài đặt
sudo docker run hello-world

Lệnh cuối sẽ tải và chạy một container test – nếu thấy thông báo “Hello from Docker!” nghĩa là Docker đã hoạt động.

Bước 2: Tạo thư mục làm việc

# Tạo và di chuyển vào thư mục cho Twenty
mkdir -p /opt/twenty
cd /opt/twenty

Thư mục /opt/twenty sẽ chứa toàn bộ cấu hình và dữ liệu của Twenty CRM.​

Bước 3: Download Docker Compose file

# Tải file docker-compose.yml chính thức
curl -O https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml

# Tải file .env mẫu
curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/.env.example

File docker-compose.yml chứa cấu hình các containers (server, worker, PostgreSQL, Redis), trong khi .env chứa các biến môi trường cần thiết.​

Bước 4: Cấu hình Environment Variables

Mở file .env và chỉnh sửa các biến quan trọng:

# Mở file .env bằng editor
nano .env

Các biến cơ bản cần cấu hình:

# URL của server (thay localhost bằng domain/IP của bạn)
SERVER_URL=http://localhost:3000

# Cấu hình PostgreSQL
PG_DATABASE_URL=postgres://twentyuser:twentypass@db:5432/default

# Secrets cho authentication (tạo chuỗi random mạnh)
ACCESS_TOKEN_SECRET=your-random-secret-here
LOGIN_TOKEN_SECRET=your-random-secret-here
REFRESH_TOKEN_SECRET=your-random-secret-here
FILE_TOKEN_SECRET=your-random-secret-here

# Storage type (local hoặc s3)
STORAGE_TYPE=local
STORAGE_LOCAL_PATH=.local-storage

# Message Queue
MESSAGE_QUEUE_TYPE=bull-mq

Lưu ý quan trọng: Chỉ sửa các biến được đề cập trong hướng dẫn, không thay đổi các cài đặt khác để tránh lỗi.

Bước 5: Khởi chạy Twenty CRM

# Khởi động các containers
docker compose up -d

Lệnh này sẽ:

  • Tải các Docker images cần thiết (có thể mất vài phút lần đầu)
  • Khởi tạo PostgreSQL database và Redis​
  • Start Twenty server và worker containers

Kiểm tra trạng thái containers:

# Xem danh sách containers đang chạy
docker compose ps

# Xem logs nếu có vấn đề
docker compose logs

Tất cả containers phải ở trạng thái “Up” và healthy.

Bước 6: Truy cập Twenty CRM

Mở trình duyệt và truy cập:

http://localhost:3000

Hoặc nếu bạn cài trên server remote:

http://your-server-ip:3000

Bạn sẽ thấy màn hình đăng nhập/đăng ký của Twenty CRM.​

Bước 7: Tạo tài khoản Admin đầu tiên

Người dùng đầu tiên đăng ký sẽ tự động trở thành admin với quyền truy cập đầy đủ. Admin có thể:​

  • Truy cập Admin Panel trong Settings
  • Cấu hình integrations (Google, Microsoft)
  • Quản lý API keys và webhooks
  • Thêm thành viên mới vào workspace

Hướng dẫn sử dụng Twenty CRM cơ bản

Thêm Contacts và Companies

Thêm Contact (People):

  1. Nhấp vào menu People trên sidebar​
  2. Click nút + ở góc trên bên phải​
  3. Điền thông tin:
    • Name: Tên người liên hệ (bắt buộc)
    • Email: Email (định danh duy nhất)​
    • Phone: Số điện thoại
    • Company: Liên kết với công ty (chọn từ danh sách hoặc tạo mới)youtube​
  4. Click Save

Thêm Company:

  1. Vào menu Companies
  2. Click nút +
  3. Điền:
    • Company Name: Tên công ty (bắt buộc)
    • Domain: Website domain (định danh duy nhất)
    • Industry: Ngành nghề
    • Size: Quy mô nhân sự
  4. Click Save

Import hàng loạt: Twenty hỗ trợ import CSV để thêm nhiều records cùng lúc, tiết kiệm thời gian khi migrate từ hệ thống cũ.​

Quản lý Tasks và Notes

Tạo Task:

  1. Nhấp vào tab Tasks trong sidebaryoutube​
  2. Click + Add taskyoutube​
  3. Điền thông tin:
    • Title: Tiêu đề task
    • Description: Mô tả chi tiết
    • Assignee: Người được giao
    • Due Date: Deadline
    • Status: Open/In Progress/Done
  4. Click Save

Tasks được hiển thị trong timeline của contact/company liên quan, giúp team theo dõi toàn bộ hoạt động.

Tạo Note:

Notes hoạt động tương tự tasks nhưng dùng để ghi chép thông tin, quan sát về khách hàng. Ví dụ: “Khách hàng quan tâm đến gói Premium, cần follow-up sau 3 ngày”.

Tùy chỉnh Views và Filters

Twenty cho phép tạo custom views để hiển thị dữ liệu phù hợp với từng vai trò:​

Tạo Custom View:

  1. Vào module (People/Companies/Tasks)
  2. Click biểu tượng filter hoặc sort
  3. Thiết lập điều kiện:
    • Filter: Lọc theo field (ví dụ: Industry = “Technology”)​
    • Sort: Sắp xếp (theo tên, ngày tạo…)
    • Group By: Nhóm theo field (ví dụ: nhóm theo Sales Stage)
  4. Click Save View và đặt tên

Chuyển đổi giữa Kanban và Table:

  • Click biểu tượng view switcher ở góc trên
  • Chọn Kanban để xem dạng bảng trực quan
  • Chọn Table để xem dạng lưới chi tiết

Tích hợp Gmail/Outlook

Kích hoạt Gmail Integration:

  1. Vào Settings → Admin Panel → Configuration Variables
  2. Tìm mục Google Auth
  3. Bật MESSAGING_PROVIDER_GMAIL_ENABLEDCALENDAR_PROVIDER_GOOGLE_ENABLED
  4. Điền Google Client IDClient Secret (lấy từ Google Cloud Console)​
  5. Thêm redirect URIs:
    • https://your-domain/auth/google/redirect
    • https://your-domain/auth/google-apis/get-access-token
  6. Click Save

Kích hoạt Microsoft 365:

Quy trình tương tự nhưng sử dụng Microsoft Azure để tạo app registration và lấy credentials.

Sau khi cấu hình, mỗi user có thể kết nối email cá nhân của mình từ Settings, Twenty sẽ tự động đồng bộ emails và calendar events.​

Tạo và sử dụng API Keys

Tạo API Key:

  1. Vào Settings → APIs & Webhooks
  2. Click + Create key
  3. Điền:
    • Name: Tên mô tả (ví dụ: “Zapier Integration”)
    • Expiration Date: Ngày hết hạn
  4. Click Save
  5. Copy API key ngay – nó chỉ hiển thị một lần​

Sử dụng API Key:

Thêm API key vào header của HTTP requests:

Authorization: Bearer YOUR_API_KEY

Test API trong Playground:

  1. Vào Settings → APIs & Webhooks
  2. Click Open API Playground
  3. Nhập API key và test các queries/mutations​

API Playground cho phép bạn thử GraphQL queries trực tiếp mà không cần code.

Cấu hình Email SMTP (Tùy chọn)

Để gửi email invitations cho team members, cấu hình SMTP trong Admin Panel:

[email protected]
EMAIL_FROM_NAME="Your Company CRM"
EMAIL_DRIVER=smtp
EMAIL_SMTP_HOST=smtp.gmail.com
EMAIL_SMTP_PORT=587
[email protected]
EMAIL_SMTP_PASSWORD=your-app-password

Lưu ý: Với Gmail, bạn cần tạo App Password thay vì dùng mật khẩu thường.

Lợi ích của Twenty CRM cho doanh nghiệp

1. Miễn phí và mã nguồn mở

Twenty được cấp phép GPL, nghĩa là bạn sở hữu phần mềm chứ không phải thuê. Chi phí bằng 0 so với $25+/user/tháng của Salesforce, giúp doanh nghiệp SME tiết kiệm hàng ngàn đô la mỗi năm.​

2. Kiểm soát hoàn toàn dữ liệu

Với self-hosting, dữ liệu khách hàng của bạn được lưu trữ 100% trên server riêng. Không còn lo ngại về:​

  • Vendor control (nhà cung cấp kiểm soát dữ liệu)
  • Tăng giá đột ngột do bị “khóa” trong hệ sinh thái
  • Data privacy và bảo mật

3. Tùy biến cao theo nhu cầu

Twenty cho phép tùy chỉnh gần như không giới hạn:

  • Tạo custom objects và fields phù hợp với ngành nghề​
  • Thiết kế workflows automation riêng​
  • Tích hợp với bất kỳ hệ thống nào qua API​

Khả năng này đặc biệt quan trọng với doanh nghiệp vừa và nhỏ có quy trình độc đáo.

4. Giao diện hiện đại, dễ học

Giao diện của Twenty được thiết kế tối giản, trực quan, lấy cảm hứng từ Notion và Linear. Team members mới có thể làm quen trong vài giờ mà không cần training phức tạp, tiết kiệm thời gian và chi phí onboarding.

Keyboard shortcuts tích hợp sẵn giúp power users tăng tốc độ làm việc đáng kể.

5. Cộng đồng lớn mạnh

Với 536 contributors4,500+ forks trên GitHub, Twenty có cộng đồng sôi động:​

  • Cập nhật tính năng mới liên tục (50 releases)
  • Hỗ trợ nhanh chóng qua Discord và GitHub Issues
  • Hệ sinh thái plugins đang phát triển

6. Phù hợp với doanh nghiệp SME

Twenty được thiết kế đặc biệt cho doanh nghiệp vừa và nhỏ:​

  • Chi phí thấp: Miễn phí hoàn toàn
  • Triển khai nhanh: Cài đặt trong 10-15 phút​
  • Dễ sử dụng: Không cần chuyên gia IT​
  • Mở rộng linh hoạt: Dễ dàng thêm users và features khi doanh nghiệp phát triển

7. Tích hợp Email và Automation

Khả năng tích hợp email, calendar và automation workflows giúp:​

  • Giảm 30-50% thời gian nhập liệu thủ công
  • Tăng 15-20% năng suất đội bán hàng
  • Cải thiện tỷ lệ khách hàng quay lại 40-70%

8. API đầy đủ cho Integration

REST và GraphQL API với 100% coverage cho phép:​

  • Tích hợp với website, app mobile, hệ thống ERP​
  • Tự động sync dữ liệu với các công cụ khác​
  • Xây dựng custom solutions không giới hạn​

Twenty CRM là giải pháp quản lý quan hệ khách hàng mã nguồn mở tuyệt vời dành cho doanh nghiệp vừa và nhỏ muốn kiểm soát dữ liệu, tiết kiệm chi phí và có tính năng hiện đại. Với giao diện thân thiện, khả năng tùy biến cao và cộng đồng mạnh mẽ, Twenty đang nhanh chóng trở thành lựa chọn số 1 thay thế Salesforce.​

Twenty CRM lý tưởng cho:

  • Doanh nghiệp SME cần CRM mạnh mẽ nhưng ngân sách hạn chế
  • Startups muốn tùy biến cao và sở hữu dữ liệu 100%
  • Developers ưa thích mã nguồn mở và API-first approach
  • Sales teams cần automation và email integration​

Việc cài đặt Twenty CRM chỉ mất 10-15 phút với Docker. Hãy truy cập https://github.com/twentyhq/twenty để bắt đầu, tham gia cộng đồng Discord để được hỗ trợ, và trải nghiệm sự khác biệt của một CRM thực sự hiện đại, mở và mạnh mẽ.

Đừng để chi phí CRM đắt đỏ cản trở sự phát triển của doanh nghiệp bạn – Twenty CRM mang đến tất cả tính năng cần thiết hoàn toàn miễn phí, với quyền kiểm soát đầy đủ trong tay bạn.

Duy Nghiện
Hãy làm khán giả, đừng làm nhân vật chính :)

You may also like

Nhận thông báo qua email
Nhận thông báo cho
guest

0 Bình luận
Mới nhất
Cũ nhất Nhiều like nhất
Phản hồi nội tuyến
Xem tất cả bình luận