Quản lý Khách hàng (CRM)

Trang Khách hàng (/app/customers) là danh bạ CRM tập trung lưu trữ toàn bộ hồ sơ khách hàng đổ về từ mọi kênh (Facebook Messenger, Zalo, Instagram, Telegram, Webchat, Email…).

Header & Thao tác chính

• Tiêu đề: “Khách hàng” (customers.page_title_short) — mô tả “Quản lý danh bạ khách hàng toàn hệ thống, theo dõi nhãn, kênh và lịch sử tương tác.”.
• Nút Xuất dữ liệu (customers.export_btn): Mở ExportModal cho phép xuất file Excel / CSV danh sách khách hàng.
• Nút Làm mới (customers.refresh_btn): Reload danh sách khách hàng và dữ liệu tag.
• Nút Quản lý nhãn (customers.manage_tags): Mở modal quản lý danh sách nhãn (tags) của toàn tài khoản.

---

Bộ lọc danh bạ 4 chiều

Thanh công cụ lọc phía trên bảng danh bạ giúp tìm kiếm nhanh chóng:

1. Ô tìm kiếm từ khóa: Tìm kiếm theo Tên khách hàng, Số điện thoại, Email hoặc ID người dùng (subscriber ID).
2. Lọc theo Kênh giao tiếp: Tất cả kênh, Messenger, Zalo, Instagram, Telegram, Website…
3. Lọc theo Nhãn (Tag): Lọc khách hàng sở hữu nhãn chỉ định (vd #VIP, #khach_moi, #chua_so_dien_thoai).
4. Lọc theo Trạng thái: Active (Hoạt động), Pause (Tạm dừng), Done (Hoàn tất), Kỹ thuật, Spam.

---

Bảng danh bạ khách hàng (CustomersDataTable)

Bảng hiển thị thông tin tổng quan của từng khách hàng:

Cột	Dữ liệu hiển thị
Khách hàng	Avatar + Tên khách hàng + Số điện thoại / Email bên dưới.
Kênh giao tiếp	Icon nền tảng + Tên kênh/Fanpage kết nối.
Nhãn (Tags)	Các chip nhãn màu sắc phân loại khách hàng.
Giai đoạn Lead	Badge giai đoạn trong phễu (Mới nhắn, Đang tư vấn, Quan tâm giá, Chờ chốt, Đã mua, Không tiềm năng).
Tương tác gần nhất	Thời gian lần cuối khách nhắn tin hoặc được phản hồi.
Trạng thái	Badge trạng thái xử lý (Active, Pause, Done, Kỹ thuật, Spam).
Thao tác	👁️ Xem hồ sơ (mở drawer chi tiết) hoặc 💬 Nhắn tin (chuyển thẳng tới cuộc trò chuyện ở Hộp thư).

---

Modal Hồ sơ chi tiết Khách hàng

Khi bấm vào một khách hàng, modal/drawer hồ sơ chi tiết hiển thị:

1. Thông tin liên lạc cơ bản

• Họ và tên (name).
• Số điện thoại (phone) & Email (email).
• Giới tính, Ngày sinh, Địa chỉ giao hàng mặc định.
• Nút Lưu thông tin để cập nhật thay đổi.

2. Quản lý Nhãn (Tag Management)

• Gắn thêm nhãn mới cho khách hàng từ dropdown nhãn.
• Gỡ bỏ nhãn khỏi hồ sơ.

3. Ghi chú nội bộ (Internal Notes)

• Thêm các ghi chú CSKH cá nhân hóa (vd: “Khách thích giao hàng giờ hành chính”, “Hay mua size L”).
• Xem nhật ký các ghi chú đã lưu kèm tên nhân viên tạo và mốc thời gian.
• Nút 🗑️ xóa từng ghi chú.

4. Liên kết đa kênh

• Xem danh sách các tài khoản mạng xã hội khác đã được gộp chung với khách hàng này (khi gộp qua SĐT).

Bước tiếp theo

• Thông tin khách (cột phải Hộp thư) — Quản lý trực tiếp khi chat.
• Đơn hàng — Xem lịch sử mua hàng của khách.
• Sản phẩm & Dịch vụ — Catalog sản phẩm.