ZaloCRM — Quản lý nhiều tài khoản Zalo cá nhân

Hệ thống quản lý tập trung nhiều tài khoản Zalo cá nhân trên 1 giao diện web. Chat real-time, quản lý khách hàng, lịch hẹn, báo cáo, API & Webhook.

Tính năng

• Quản lý nhiều Zalo — Đăng nhập QR, tự kết nối lại, lưu phiên đăng nhập
• Chat real-time — Gửi/nhận tin nhắn, ảnh, file, sticker, nhóm chat
• Quản lý khách hàng — Pipeline (Mới → Đã liên hệ → Quan tâm → Chuyển đổi → Mất)
• Lịch hẹn — Tạo, theo dõi, nhắc nhở tự động hàng ngày
• Dashboard — Biểu đồ tin nhắn, KPI, nguồn khách hàng, trạng thái pipeline
• Báo cáo — Xuất Excel, lọc theo thời gian
• Phân quyền — Owner / Admin / Member, quản lý đội nhóm, phân quyền Zalo
• API công khai — REST API với xác thực API key cho tích hợp bên ngoài
• Webhook — Nhận thông báo khi có tin nhắn mới, khách hàng mới, Zalo kết nối/ngắt
• Chống block Zalo — Giới hạn 200 tin/ngày, phát hiện gửi quá nhanh
• Thông báo — Tin chưa trả lời >30 phút, lịch hẹn sắp tới, Zalo mất kết nối
• Tìm kiếm toàn hệ thống — Tìm khách hàng, tin nhắn, lịch hẹn
• Giao diện — Theme tối/sáng, thiết kế Liquid Silicon

Yêu cầu hệ thống

Thành phần	Tối thiểu	Khuyến nghị
CPU	1 vCPU	2-4 vCPU
RAM	1 GB	4 GB
Ổ cứng	10 GB	20 GB SSD
Hệ điều hành	Ubuntu 20.04+	Ubuntu 22.04 LTS
Phần mềm	Docker + Docker Compose	Docker 24+

Cài đặt nhanh

Hướng dẫn chi tiết: HUONG-DAN-CAI-DAT.md

git clone https://github.com/vuongnguyenbinh/ZaloCRM.git
cd ZaloCRM
cp .env.example .env
# Sửa file .env — đặt mật khẩu và secret keys
docker compose up -d --build

Truy cập http://IP-server:3080 → Tạo tài khoản admin lần đầu.

Công nghệ sử dụng

Thành phần	Công nghệ
Backend	Node.js 20 / Fastify 5 / Prisma 7
Frontend	Vue 3 / Vuetify 3 / Chart.js / Pinia
Cơ sở dữ liệu	PostgreSQL 16
Real-time	Socket.IO
Zalo	zca-js 2.x
Triển khai	Docker Compose

API & Webhook

Hướng dẫn chi tiết: HUONG-DAN-SU-DUNG.md

Xác thực API

Header: X-API-Key: your-api-key

Endpoint chính

Phương thức	Đường dẫn	Mô tả
GET	/api/public/contacts	Danh sách khách hàng
POST	/api/public/contacts	Tạo khách hàng mới
POST	/api/public/messages/send	Gửi tin nhắn
GET	/api/public/appointments	Danh sách lịch hẹn

Sự kiện Webhook

Sự kiện	Mô tả
message.received	Tin nhắn mới đến
message.sent	Tin nhắn gửi đi
contact.created	Khách hàng mới
zalo.connected	Zalo kết nối
zalo.disconnected	Zalo mất kết nối

Giấy phép

MIT — Miễn phí sử dụng và chỉnh sửa.