Hệ thống phân tích chất lượng chăm sóc khách hàng bằng AI. Tự động đồng bộ tin nhắn từ Zalo OA, Facebook Messenger, dùng AI (Claude/Gemini) đánh giá chất lượng CSKH và gửi cảnh báo qua Telegram/Email.

📖 Hướng dẫn sử dụng chi tiết: https://tanviet12.github.io/chat-quality-agent/

• Đồng bộ tin nhắn từ Zalo OA và Facebook Messenger
• Đánh giá chất lượng CSKH bằng AI (Claude hoặc Gemini) — Đạt/Không đạt, điểm 0-100, nhận xét chi tiết
• Phân loại chat theo chủ đề tùy chỉnh (khiếu nại, góp ý, hỏi giá...)
• Cảnh báo tự động qua Telegram và Email
• Batch AI mode — gom nhiều cuộc chat/lần gọi AI, tiết kiệm chi phí
• Dashboard với biểu đồ, thống kê, cảnh báo gần đây
• Multi-tenant — nhiều công ty trên 1 hệ thống, phân quyền Owner > Admin > Member
• Tích hợp MCP cho Claude Web/Desktop
• SSL tự động qua Let's Encrypt (tùy chọn)

curl -s https://raw.githubusercontent.com/tanviet12/chat-quality-agent/main/install.sh | sudo bash

Script tự cài Docker, tạo secrets ngẫu nhiên, pull images và khởi chạy.

git clone https://github.com/tanviet12/chat-quality-agent.git
cd chat-quality-agent
cp .env.example .env
# Sửa .env
docker compose up -d --build

Truy cập: http://your-server-ip (hoặc http://localhost nếu cài trên máy local) — Lần đầu sẽ hiện trang Setup để tạo tài khoản admin.

Thêm vào file .env:

LEGO_DOMAIN=cqa.yourdomain.com
[email protected]

Trỏ DNS A record về IP server, sau đó restart:

docker compose restart nginx

SSL sẽ tự động tạo và gia hạn qua Let's Encrypt.

                    ┌──────────────┐
  Internet ────────>│    Nginx     │ Port 80/443
                    │  (SSL + RP)  │
                    └──────┬───────┘
                           │
                    ┌──────┴───────┐
                    │   CQA App    │ Port 8080 (internal)
                    │ Go + Vue SPA │
                    └──────┬───────┘
                           │
                    ┌──────┴───────┐
                    │   MySQL 8.0  │ Port 3306 (internal)
                    └──────────────┘

chat-quality-agent/
├── backend/            # Go API server
│   ├── ai/             # AI providers (Claude, Gemini)
│   ├── api/            # REST API handlers + middleware
│   ├── channels/       # Zalo OA, Facebook adapters
│   ├── db/             # GORM models + MySQL
│   ├── engine/         # Analyzer + Sync + Scheduler
│   ├── mcp/            # MCP server cho Claude
│   └── notifications/  # Telegram + Email
├── frontend/           # Vue 3 SPA
├── docker/             # Nginx + SSL configs
├── docs/               # Tài liệu hướng dẫn (VitePress)
├── docker-compose.yml      # Build từ source
├── docker-compose.hub.yml  # Dùng image Docker Hub
└── Dockerfile

1. Kết nối kênh chat: Cài đặt > Kênh chat > Kết nối Facebook/Zalo
2. Đồng bộ tin nhắn: Bấm "Đồng bộ ngay" hoặc chờ tự động
3. Cấu hình AI: Cài đặt > AI > Chọn Claude/Gemini + nhập API key
4. Tạo công việc: Công việc > Tạo mới > Wizard 6 bước
5. Chạy phân tích: Chi tiết công việc > Chạy thử hoặc Chạy ngay
6. Xem kết quả: Chi tiết công việc > Kết quả đánh giá

Xem đầy đủ trong .env.example.

Trang Setup lần đầu	Dashboard
Kết nối kênh chat	Tạo công việc
Kết quả đánh giá QC	Kết quả phân loại
Chi tiết tin nhắn + đánh giá	Chi tiết kênh chat

Xem tài liệu chi tiết tại: https://tanviet12.github.io/chat-quality-agent/

MIT - SePay