Panel Khách Tương Tác Trực Tiếp
Hướng dẫn quản trị và trải nghiệm bảng điều khiển tự phục vụ (Self-Service Panel) dành cho khách hàng.
Panel Khách Tự Phục Vụ (Client Self-Service Panel) là một trong những nâng cấp giá trị nhất của Booking Bot V2. Tính năng này cho phép khách hàng chủ động tìm kiếm player, đặt lịch, ủng hộ (donate) hoặc nạp cọc trực tiếp bằng các nút bấm và biểu mẫu thông minh mà không cần phải chờ đợi nhân viên hỗ trợ gõ lệnh.
1. Cấu Hình & Gửi Panel Khách (Dành Cho Owner)
Chủ máy chủ sử dụng bộ lệnh /config selfservice để quản lý giao diện panel:
Các Câu Lệnh Quản Trị
# Xem trạng thái bật/tắt của các nút chức năng
/config selfservice view
# Mở form bật/tắt từng nút trên panel
/config selfservice toggle
# Chọn danh sách các phòng vé Ticket hiển thị trên panel
/config selfservice tickets
# Gửi bảng điều khiển panel vào kênh chỉ định
/config selfservice send channel:<#Kênh-Đặt-Lịch>Cơ Chế Bật / Tắt Các Nút Chức Năng
Mặc định khi cài đặt bot, 4 nút chức năng trên panel đều ở trạng thái Tắt. Khi chạy lệnh /config selfservice toggle:
- Chọn nút trong danh sách: Bật.
- Bỏ chọn: Tắt (nếu bỏ chọn tất cả, panel sẽ ẩn toàn bộ nút).
- Điều kiện riêng cho nút Nạp cọc: Bạn bắt buộc phải hoàn tất cấu hình thông tin ngân hàng qua lệnh
/payment-config set-qrtrước. Nếu chưa cài đặt, bot sẽ tự động giữ nút này ở trạng thái tắt và thông báo lý do.
Tích Hợp Nút Ticket Hỗ Trợ (/config selfservice tickets)
Owner có thể chọn tối đa 20 loại Ticket từ các template đã tạo để đưa thẳng lên Panel khách hàng:
- Các nút ticket hiển thị trong nhóm Hỗ trợ của panel.
- Giữ nguyên màu sắc, tên định danh và icon đã thiết lập tại
/ticket setup. - Khi khách bấm vào, bot sẽ tự động tạo phòng vé đúng theo quy trình của ticket đó.
- Bấm Ẩn toàn bộ ticket nếu muốn gỡ tất cả nút phòng vé khỏi panel.
2. Trải Nghiệm Khách Hàng Trên Panel
Bảng điều khiển được thiết kế tinh tế với 4 nút tương tác chính:
| Nút bấm | Trải nghiệm và Luồng thao tác |
|---|---|
| React | Khách hàng nhập tiêu đề và chọn vai trò Player muốn mời. Bot tạo phiên tương tác tìm kiếm. Khi chọn 1 player từ danh sách, bot lập tức hiển thị Profile cá nhân của player đó kèm hai nút Book và Donate trực tiếp trên cùng một thông báo. |
| Book | Mở menu chọn từ 1 đến 10 Player ➔ Chọn phương thức thanh toán phù hợp ➔ Mở modal nhập số giờ chơi và xác nhận đặt lịch. |
| Donate | Mở menu chọn từ 1 đến 10 Player ➔ Chọn phương thức thanh toán ➔ Nhập số tiền gửi tặng cho mỗi player. |
| Nạp cọc | Nhập số tiền muốn nạp ➔ Bot tự động tạo mã VietQR thanh toán. Sau khi chuyển khoản khớp nội dung, số dư cọc được cộng tự động vào ví. |
3. Điều Kiện Hiển Thị Nút Thanh Toán
Khi khách hàng bấm Book hoặc Donate, bot sẽ tự động kiểm tra điều kiện tài khoản để hiển thị các phương thức thanh toán hợp lệ:
| Phương thức | Điều kiện xuất hiện | Cơ chế xử lý |
|---|---|---|
| Trừ Cọc | Khách hàng có số dư cọc lớn hơn 0 (b.cash > 0) | Tự động trừ tiền cọc tương ứng với tổng chi phí phiên book (đã nhân số lượng player) |
| Trừ Lương | Khách hàng sở hữu vai trò Player và có số dư lương khả dụng | Tự động trừ trực tiếp vào quỹ lương tích lũy của player |
| Quét VietQR | Máy chủ đã hoàn tất cài đặt /payment-config set-qr | Tạo mã QR ngân hàng; hóa đơn tự động được chốt khi hệ thống nhận được tiền |
Tối ưu hóa thao tác: Nếu tài khoản của khách chỉ thỏa mãn duy nhất 1 phương thức thanh toán (ví dụ: chỉ có BankQR hoặc chỉ có số dư cọc), bot sẽ bỏ qua bước chọn phương thức và mở thẳng biểu mẫu nhập giờ để tiết kiệm thời gian.
4. Tính Năng Đặt Lịch Ẩn Danh (Anonymous Booking)
Tại biểu mẫu xác nhận đặt lịch hoặc donate, khách hàng có thể tích chọn Đặt lịch ẩn danh:
- Trên thông báo hóa đơn và kênh chat công khai, tên khách hàng sẽ được hiển thị thành Ai đó.
- Hệ thống sổ cái giao dịch của bot vẫn ghi nhận chính xác tài khoản khách để trừ tiền cọc hoặc hoàn tiền khi có sự cố.
- Khi supporter thực hiện hoàn tiền cho bill ẩn danh, thông báo hoàn tiền cũng tự động ẩn tên khách hàng.
5. Panel Thu Nhỏ Trong Phòng Ticket
Ngay sau khi khách hàng mở một phòng vé hỗ trợ, bot sẽ gửi kèm một thông báo ngắn có nút Xem panel:
- Bấm vào nút này sẽ mở trực tiếp bảng điều khiển ngay bên trong phòng ticket.
- Panel trong ticket sẽ tự động lược bỏ các nút tạo ticket mới để tránh việc khách hàng mở phòng vé lồng nhau.