Hệ thống Ticket

Hướng dẫn thiết lập hệ thống Ticket hỗ trợ khách hàng chuyên nghiệp

Hệ thống Ticket cho phép tạo ra các kênh hỗ trợ riêng tư (private threads) khi khách hàng bấm nút, giúp đội ngũ staff quản lý và giải quyết các yêu cầu giao dịch booking bảo mật và hiệu quả.

Yêu cầu quyền hạn: Thiết lập ban đầu yêu cầu quyền Owner. Tuy nhiên, các Supporter có quyền điều hành hỗ trợ bên trong ticket sau khi kênh được mở.

Các câu lệnh chính (Commands)

/ticketSlash Command

Owner

Lệnh điều hành hệ thống Ticket Panel

Lệnh con	Mục đích	Các tham số tùy chọn
`/ticket create`	Khởi tạo bảng Ticket Panel mới	`ticket-name` (tên quản lý), `embed` (tên embed mô tả), `ticket-msg` (tin nhắn text thường), `limit-ticket` (giới hạn số ticket/user), `ticket-channel` (kênh đăng panel), `category` (danh mục chứa ticket mới), `logs` (kênh ghi log đóng/mở ticket)
`/ticket show`	Hiển thị lại bảng panel ticket đã tạo	`ticket-name` (hỗ trợ autocomplete để tìm kiếm nhanh)
`/ticket edit`	Chỉnh sửa cấu hình của panel ticket	`ticket-name`
`/ticket delete`	Xóa bỏ hoàn toàn panel ticket	`ticket-name`
`/ticket add-button`	Thêm nút bấm mở ticket vào panel	`label` (chữ hiển thị), `emoji` (biểu tượng), `embed` (embed hiển thị khi ticket được mở)
`/ticket edit-button`	Chỉnh sửa thông số nút bấm đã tạo	`label`
`/ticket clear-button`	Xóa sạch toàn bộ các nút bấm trên panel	—

Lệnh vận hành trong ticket (Supporter)

Lệnh	Dạng	Mục đích
`close`	Prefix	Đóng ticket kênh hiện tại và gửi transcript

Cơ chế hoạt động của Ticket

Khởi tạo: Owner thiết lập và gửi bảng nút bấm mở ticket ra kênh Discord chỉ định bằng lệnh /ticket create.
Kích hoạt: Thành viên bấm vào nút (ví dụ: Mở Ticket) trên bảng panel.
Kiểm tra điều kiện:
- Bot kiểm tra xem người dùng có nằm trong danh sách đen (blacklist) của bot hay không. Nếu có, hành động bị từ chối.
- Bot kiểm tra giới hạn số ticket đang mở đồng thời của người dùng (limit-ticket) để tránh hành vi spam tạo kênh hàng loạt.
Tạo kênh hỗ trợ: Bot tạo một luồng riêng tư (private thread hoặc kênh text riêng) dưới category được cấu hình, tự động thêm khách hàng và tag các thành viên có role supporter vào hỗ trợ.
Đóng và Lưu trữ: Supporter gõ close (prefix) trong kênh/thread ticket. Bot lưu trữ hội thoại (archive) và gửi transcript về kênh log đã đăng ký trên panel.

Điều kiện quyền hạn của Bot

Để hệ thống hoạt động trơn tru, hãy chắc chắn Bot Discord đã được cấp đủ các quyền sau trong kênh đăng panel:

Send Messages (Gửi tin nhắn)
Embed Links (Nhúng liên kết)
Create Private Threads (Tạo luồng riêng tư)
Manage Permissions (Quản lý quyền kênh)
Read Message History (Đọc lịch sử tin nhắn)

Vấn đề thường gặp (FAQ)

Tại sao nút bấm tạo ticket không hoạt động?

Cách xử lý: Kiểm tra xem Bot có đang online hay không. Đồng thời kiểm tra xem Bot có quyền Create Private Threads và Manage Channels tại danh mục (Category) chứa ticket hay không.

Tại sao staff không nhận được thông báo khi có ticket mới?

Cách xử lý: Hãy kiểm tra xem trong mẫu embed được gán khi khách bấm nút (add-button) đã chứa tin nhắn tag tên role của Supporter hoặc Administrator hay chưa.