Hệ thống Phòng vé Ticket

Hướng dẫn khởi tạo và quản lý hệ thống hỗ trợ khách hàng đa phân loại thông qua lệnh /ticket.

Hệ thống Ticket (Phòng vé hỗ trợ) trong Booking Bot V2 được xây dựng chuyên nghiệp, cho phép máy chủ thiết lập nhiều biểu mẫu tiếp nhận khác nhau (như: Đặt lịch riêng, Ứng tuyển Player, Khiếu nại dịch vụ, Hỗ trợ kỹ thuật) với giao diện nút bấm trực quan và cơ chế phân luồng tự động.

1. Danh Sách Câu Lệnh Quản Trị Ticket

Quyền hạn yêu cầu: Vai trò Supporter, Admin hoặc Owner.

Câu lệnh	Chức năng chính
`/ticket setup`	Khởi tạo một mẫu phòng vé Ticket mới
`/ticket add-button`	Thêm các nút bấm lựa chọn phân loại vào bảng Ticket đã có
`/ticket list`	Liệt kê toàn bộ các cấu hình Ticket đang hoạt động trong máy chủ
`/ticket delete`	Xóa bỏ một cấu hình Ticket theo tên định danh
`/ticket close`	Đóng phòng vé hiện tại và giải phóng quyền kênh
`/ticket transcript`	Xuất toàn bộ lịch sử trao đổi trong phòng vé thành file lưu trữ

2. Quy Trình Khởi Tạo Phòng Vé Mới

Bước 1: Tạo Bảng Thông Báo Ticket (`/ticket setup`)

Chỉ định tên cấu hình và kênh chat mà bạn muốn bot gửi tin nhắn hướng dẫn mở phòng vé:

/ticket setup \
  name:cskh \
  channel:#kenh-ho-tro \
  title:"Trung Tâm Hỗ Trợ & Khiếu Nại" \
  description:"Vui lòng bấm vào nút bên dưới để tạo phòng trao đổi riêng với Ban Quản Trị" \
  color:#4f46e5

Các tham số tùy chọn:

template: Chọn mẫu giao diện có sẵn của V2 (như Booking, Apply, Support).
color: Mã màu dải màu hex của tin nhắn Embed (ví dụ: #4f46e5).

Bước 2: Bổ Sung Nút Bấm Phân Loại (`/ticket add-button`)

Bạn có thể thêm nhiều nút bấm đại diện cho các nhu cầu khác nhau vào cùng một bảng ticket:

# Nút tạo ticket hỗ trợ chung
/ticket add-button setup-name:cskh label:"Gặp Supporter" style:primary

# Nút tiếp nhận đơn ứng tuyển Player
/ticket add-button setup-name:cskh label:"Ứng Tuyển Player" style:success

# Nút phản ánh sự cố khẩn cấp
/ticket add-button setup-name:cskh label:"Khiếu Nại Bill" style:danger

Các kiểu hiển thị nút (Style):

primary: Màu xanh dương nổi bật.
secondary: Màu xám trung tính.
success: Màu xanh lá cây.
danger: Màu đỏ cảnh báo.

3. Tích Hợp Nút Ticket Lên Panel Khách Hàng

Server Owner có thể tận dụng các nút Ticket đã tạo để đưa thẳng vào Panel khách tự phục vụ:

/config selfservice tickets

Hệ thống mở bảng danh sách cho phép chọn tối đa 20 nhãn Ticket.
Các nút đã chọn sẽ tự động xuất hiện tại mục Hỗ trợ trên bảng điều khiển đặt lịch cố định.
Khi khách hàng bấm vào nút trên Panel, bot sẽ áp dụng chính xác quy trình tạo phòng vé tương ứng mà bạn đã cấu hình tại /ticket setup.

4. Xử Lý Phòng Vé & Xuất Bản Sao Kê (Transcript)

Khi một phòng vé được mở ra, bot sẽ tự động tạo một kênh chat riêng biệt chỉ có Khách hàng và Staff được quyền truy cập:

Panel hỗ trợ nhanh trong ticket: Bot tự động gửi một thông báo kèm nút Xem panel giúp khách hàng có thể đặt lịch hoặc nạp cọc ngay trong phòng ticket mà không cần quay lại kênh chung.
Xuất bản sao kê (Transcript): Khi nhân viên gõ lệnh /ticket transcript, bot sẽ tổng hợp toàn bộ tin nhắn, hình ảnh và mốc thời gian trong phòng vé thành một file HTML/Text gửi trực tiếp vào kênh log-ticket.
Đóng ticket an toàn: Khi hoàn tất hỗ trợ, nhân viên hoặc khách gõ /ticket close hoặc bấm nút Đóng Ticket trên thông báo ghim. Bot sẽ gửi lời cảm ơn và tự động xóa kênh sau vài giây.

5. Đồng Bộ Quyền Ticket Theo Vai Trò Server

Nhằm bảo vệ thông tin nội bộ và quyền riêng tư của khách hàng, hệ thống Ticket trong V2 áp dụng cơ chế đồng bộ quyền hạn thời gian thực:

Tự động thu hồi quyền: Khi một nhân sự bị gỡ role Staff trên máy chủ Discord, bot sẽ tự động quét và thu hồi quyền xem trong toàn bộ các phòng vé đang mở.
Nguyên tắc phân quyền chặt chẽ: Thao tác tag hoặc ping tên một thành viên bên trong ticket không tự động cấp quyền xem cho thành viên đó. Chỉ những ai có vai trò hợp lệ hoặc được thêm chỉ định qua lệnh /ticket add-member mới có quyền truy cập.
Dọn dẹp quyền cũ: Khi vai trò của supporter thay đổi, bot tự động cập nhật lại danh sách quyền hạn trên các kênh ticket hiện có.