Hệ thống Ticket

Ticket là một luồng trò chuyện riêng giữa khách và supporter. Khách bấm nút trên bảng ticket, bot mở một luồng riêng tư ngay trong kênh đó. Máy chủ có thể tạo nhiều bảng ticket với các nút phân loại khác nhau (book player, ứng tuyển, khiếu nại...).

---

Quản lý setup: Admin trở lên qua /ticket config. Thao tác trong ticket: Supporter trở lên, giữ kiểm tra quyền từng thao tác.

Các lệnh

Tạo và quản lý setup

1. Gõ /ticket config → Tạo Setup → chọn kênh → nhập tên và gửi form. Setup mới có ba nút Booking/Apply/Support và mẫu Components V2 mặc định.
2. Chọn setup trong danh sách (có phân trang khi hơn 25 setup). Trang Tổng quan có bốn mục, mỗi mục giải thích chức năng và có nút thao tác bên phải: Nút ticket → Chỉnh sửa, Nội dung tin nhắn → Chỉnh sửa, Supporter → Thiết lập, Kênh đăng panel → Đổi kênh.
3. Supporter: bật/tắt đồng bộ Supporter (mặc định tắt), tự gỡ nhân sự bị thu role (mặc định bật); sửa mention. Mention trống dùng role Supporter mặc định. Kênh đăng panel dùng để đổi kênh và đăng lại panel ngay sau khi chọn.
4. Nút ticket: thêm hoặc chọn nút để sửa nhãn, emoji và màu; xóa có xác nhận. Tối đa 20 nút; nhãn không chứa dấu chấm.
5. Nội dung tin nhắn: chọn panel, mẫu mở ticket chung hoặc mẫu mở riêng của từng nút → Sửa Mẫu/Xem Thử. Sau khi lưu/hủy trình soạn, bấm Về Setup để quay lại. Nút Xem thử trên Tổng quan xem bảng tạo ticket. Bản xem thử không tạo ticket và không ping thật.
6. Quản lý: gửi lại panel hoặc xóa setup có xác nhận. Xóa setup giữ template, lịch sử và thread đang mở; staff vẫn đóng, giữ, claim và xuất transcript các ticket đó được.

Trong màn hình con, menu đánh dấu nhóm đang mở; bấm Tổng quan để trở lại các mục có mô tả hoặc Danh Sách để chọn setup khác. Bật/tắt Supporter và sửa mention xong vẫn ở nhóm Supporter.

Tên setup gồm 1–32 chữ, số, dấu _ hoặc -. Bot lưu cấu hình và đồng bộ panel; nếu panel mất hoặc bot thiếu quyền, bảng báo rõ để bạn cấp quyền rồi Gửi Lại. Khi đổi kênh/gửi lại, tin mới được lưu trước khi xóa tin cũ.

Các subcommand cấu hình cũ và bảng ticket settings cũ đã được thay bằng /ticket config. Các nút tạo/đóng/giữ/claim trên panel và ticket cũ tiếp tục hoạt động với cấu hình còn tồn tại.

Tùy Chỉnh Template Giao Diện Ticket (Panel & Open)

Khi chạy lệnh /ticket setup, hệ thống tự động khởi tạo 2 template Components V2 mặc định:

1. Template Panel (tin nhắn tạo ticket): Thẻ thông tin và các nút bấm category hiển thị tại kênh ticket.
2. Template Open (tin nhắn khi mở ticket): Thẻ thông báo chào mừng và hướng dẫn hiển thị đầu tiên bên trong thread/kênh riêng tư của khách.

Quy Trình Chỉnh Sửa Template:

• Sửa qua lệnh ticket:
  • Sửa panel: /ticket edit-template setup-name:<tên-setup> which:panel
  • Sửa tin mở ticket: /ticket edit-template setup-name:<tên-setup> which:open
• Sửa qua trình dựng EmbedV2 nâng cao:
  • Chạy /embedv2 edit name:<tên-template> (với tên template được thông báo sau khi setup, ví dụ ticket_panel_<setupName> hoặc ticket_open_<setupName>).

Lương ⇄ Cash trên panel ticket

Admin chọn /ticket config → setup → Nút ticket → Thêm Lương ⇄ Cash để thêm nút cạnh Booking/Apply/Support trên bảng tạo ticket. Mặc định không có nút này; mỗi setup bật riêng. Bấm Gỡ Lương ⇄ Cash để bỏ nút. Các nút tạo ticket vẫn có giới hạn 20; nút đổi lương là thao tác riêng.

Trước khi thêm, cấu hình % phí đổi lương → cash tại /config → Giá & phí → Lương player & supporter → Lương & cash. Phí 10% nghĩa là đổi 100.000 lương nhận 90.000 cash; phí 0% là miễn phí, để trống là tắt tính năng.

Ô % phí đổi cash → lương cho phép đặt phí riêng cho chiều ngược lại. Để trống thì dùng phí lương → cash; nếu cả hai chưa cài thì tính năng tắt.

Người có quyền Player trở lên bấm Lương ⇄ Cash, chỉ nhập một trong hai ô Lương → Cash hoặc Cash → Lương (tối thiểu 1.000 VNĐ, có thể nhập 100k), xem số tiền thực nhận rồi Xác nhận hoặc Huỷ. Thao tác chỉ dùng lương và cash của chính người bấm, không tạo ticket và không cần mở bảng self-service. Bản xem trước và kết quả chỉ người bấm thấy; chưa xác nhận thì chưa trừ tiền.

Phiên xác nhận hết hạn sau 5 phút. Gỡ nút, tắt tính năng, thay tỷ lệ, xoá setup hoặc gửi lại/chuyển kênh panel khiến phiên cũ bị từ chối; hãy dùng panel hiện tại và làm lại. Bản xem thử trong cấu hình vô hiệu hoá nút đổi lương.

---

4. Trong Ticket

Khi khách bấm nút, bot mở luồng riêng, ping khách cùng supporter, và gửi tin mở ticket kèm ba nút:

Nếu máy chủ bật bảng tự phục vụ, bot gửi thêm một tin có nút Panel để khách tự Book, Donate, Nạp cọc ngay trong ticket. Xem Panel khách.

Nhận Ticket (Claim)

Bấm Nhận Ticket trên tin mở ticket, hoặc gõ /ticket claim. Nhận ticket chỉ để mọi người biết ai đang phụ trách: tin mở ticket hiện dòng Supporter và nút đổi thành Bỏ Nhận. Supporter khác vẫn nhắn và đóng ticket được như thường.

• Mỗi ticket chỉ có một người phụ trách; người tạo ticket không tự nhận ticket của mình.
• Bỏ nhận bằng nút Bỏ Nhận hoặc /ticket unclaim. Chỉ người đang phụ trách, hoặc Admin trở lên, mới bỏ nhận được.
• Người phụ trách rời hoặc bị xóa khỏi ticket thì ticket trở lại trạng thái chưa ai nhận.
• Transcript ghi lại người phụ trách.
• Máy chủ bật Ca làm việc thì phải vào ca mới nhận được ticket. Xem mục 6 bên dưới.

Bảng Xếp Hạng Nhận Ticket (Top Claim)

Bảng xếp hạng supporter phụ trách nhận ticket theo kỳ lương.

• Cú pháp:
  • Slash: /topclaim [supporter:@User] [ngay:DD/MM/YYYY]
  • Prefix: topclaim, topclaim me, topclaim @user, topclaim DD/MM/YYYY, topclaim DD/MM/YYYY me, topclaim DD/MM/YYYY @user
• Quyền hạn: Supporter trở lên (áp dụng cho cả lệnh và nút bấm).
• Chu kỳ: Mặc định là kỳ lương đang mở hiện tại của máy chủ. Có thể chọn ngày (ngay:DD/MM/YYYY) để xem lại kỳ tương ứng.
• Quy tắc đếm:
  • Mỗi ticket hiện có người nhận hợp lệ tính 1 lượt cho supporter đó.
  • Tính cả ticket đang mở và ticket đã đóng (miễn còn người phụ trách).
  • Gán vào kỳ theo thời điểm nhận (claimedAt).
  • Khi bỏ nhận (unclaim) hoặc rời thread, ticket không còn được tính. Nếu nhận lại, lượt tính cho người nhận mới theo thời điểm nhận mới.
  • Thống kê mang tính chất động tại thời điểm tra cứu; không phải cơ chế chốt lương hay thưởng.
• Thao tác: Bảng hiển thị 10 người/trang với các nút chuyển trang Trước / Sau, nút Thành tích của tôi (xem riêng tư) và nút Làm mới (cooldown 15s).

Nhắc Ticket Chưa Ai Nhận

Lệnh: /config ➔ mục Quản lý ticket · Quyền hạn: Owner · Mặc định: tắt

Khi bật, nếu ticket mở sau thời gian đã cài đặt mà chưa có supporter nhận (chưa bấm Nhận Ticket), bot sẽ gửi tin nhắn ping vai trò Supporter để nhắc phụ trách:

• Thời gian nhắc: nhắc lần đầu sau N phút kể từ lúc mở ticket; các lần tiếp theo cách nhau N phút, lặp lại tối đa M lần (cài đặt ở modal Thời gian nhắc).
• Giới hạn thời gian: bot chỉ nhắc các ticket đang mở trong vòng 24 giờ gần nhất; ticket quá 24 giờ sẽ tự động bỏ qua để tránh gửi dồn.
• Thao tác nhanh: supporter có thể bấm ngay nút Nhận Ticket trên tin nhắn nhắc để nhận phụ trách ticket đó; tin mở ticket ban đầu sẽ tự động đổi sang trạng thái Bỏ Nhận và hiển thị tên supporter.

Ai Xem Được Ticket

• Chỉ khách mở ticket, supporter có quyền và người được /ticket add-member mới ở trong ticket.
• Tag một người trong ticket không cho họ quyền xem; bot tự loại người không được phép.
• Người đã bị /ticket remove-member sẽ không bị bot tự thêm lại. Muốn thêm lại, dùng /ticket add-member.

---

5. Tự Đóng Ticket Theo Bill

Lệnh: /config ➔ mục Tự đóng ticket · Quyền hạn: Owner · Mặc định: tắt

Gõ /config, chọn mục Tự đóng ticket, rồi bấm Bật tự đóng ticket.

Khi bật, mỗi bill được gắn với ticket của khách và bot hẹn giờ đóng:

Ticket đã bấm Giữ Ticket (Hold) hoặc đã đổi tên riêng thì không bị tự đóng theo bill.

Ticket không hoạt động: ticket không có tin nhắn mới trong 3 ngày sẽ được nhắc kèm nút Vẫn Giữ Ticket và Đóng Ticket Ngay. Sau 24 giờ không ai phản hồi, bot đóng ticket.

Tùy Chọn

Mục này luôn hiển thị cấu hình hiện tại.

---

6. Ca Làm Việc

Lệnh: /config ➔ mục Ca làm việc · Quyền hạn: Owner · Mặc định: tắt

Khi bật, Supporter phải vào ca mới nhận được ticket. Ngoài ca vẫn nhắn tin trong ticket bình thường, chỉ không bấm Nhận Ticket được. Lúc ra ca, bot thống kê số ticket đã nhận và số bill đã lên trong ca. Máy chủ không bật thì mọi thứ như cũ.

Cài Đặt

Bảng Ca

Bảng có bốn nút, Supporter trở lên bấm được. Bảng luôn hiện danh sách người đang trong ca.

Thống Kê Lúc Ra Ca

Bảng thống kê gồm: giờ vào ca, giờ ra ca, thời lượng, số ticket đã nhận (theo loại ticket), số bill đã lên (theo loại bill) và các ticket người đó còn đang phụ trách.

• Ticket đã bỏ nhận trong ca không được tính.
• Bill đã hoàn không được tính.
• Ra ca không làm mất vai trò phụ trách ở các ticket đang nhận; bảng thống kê liệt kê các ticket này để bàn giao.
• Lên bill không cần vào ca, nhưng bill lên ngoài ca không tính vào ca nào.

Tổng Ca Và Xuất Excel

Bấm Tổng Ca, rồi chọn khoảng thời gian: hôm nay, hôm qua, tuần này, tuần trước, tháng này, tháng trước, hoặc Từ ngày đến ngày.

• Supporter xem tổng ca của mình.
• Admin trở lên chọn được người khác, hoặc bấm Cả Server để xem mọi người.
• Bấm Xuất Excel để tải file gồm hai trang: Tổng hợp theo từng người và Chi tiết ca từng ca một.

Ca qua nửa đêm được tính vào ngày bắt đầu ca.

Tùy Chọn