Bỏ qua nội dung

🎫 Ticket System

Vấn đề

Member cần hỗ trợ (báo lỗi, khiếu nại, mua bán, …) nhưng lại nhắn thẳng vào kênh chat chung, hoặc DM từng admin một. Admin thì không biết ai đang xử lí vụ nào, và khi xong việc cũng chẳng còn lại gì để xem lại.

Giải pháp

Ticket System cho phép member tự mở một kênh (hoặc thread) riêng chỉ có họ và đội ngũ hỗ trợ nhìn thấy, chỉ bằng 1 nút bấm. Bạn có thể:

  • Tạo nhiều bảng ticket (danh mục) khác nhau, mỗi bảng có category, role hỗ trợ, câu hỏi và tin nhắn riêng
  • Hỏi member vài câu (form) trước khi mở ticket
  • Cho supporter nhận (claim) ticket để biết ai đang xử lí
  • Tự động đóng ticket khi người mở thoát server, hoặc khi không ai nhắn
  • Lưu transcript khi đóng ticket, và cho member đánh giá (1 - 5 sao)

Thiết lập ban đầu


/ticket setup - Thiết lập hệ thống ticket lần đầu

Lệnh này sẽ tự động tạo mọi thứ cần thiết để bạn có thể dùng ngay:

  • Kênh #transcripts để lưu lịch sử ticket
  • Category Hỗ trợ và kênh 🎫〡ticket
  • Role Hỗ trợ Ticket và Admin Ticket
  • Một bảng ticket mặc định, và gửi luôn bảng đó vào kênh vừa tạo

Bạn cần quyền Manage Server và Manage Channels, bot cần quyền Manage Roles và Manage Channels.

Tham số lệnh (Parameters)

Không bắt buộc:

  • force: Thiết lập lại, xóa config cũ, mặc định: không

Ví dụ sử dụng lệnh

Lệnh này sẽ thiết lập hệ thống ticket cho server lần đầu

command
/ticket setup

Cài đặt


/ticket configuration - Cài đặt chung

Lệnh này sẽ mở menu cài đặt áp dụng cho toàn bộ hệ thống ticket, bao gồm:

  • Thể loại: Ticket là 1 kênh trong category, hoặc 1 thread trong kênh
  • Transcript: Kênh để lưu các ticket đã đóng
  • Định dạng tên ticket: Ví dụ ticket-{id}
  • Số lượng ticket/1 người: Số ticket tối đa 1 người được mở cùng lúc
  • Close: Người mở có được tự đóng không, cho phép đánh giá, tự động đóng (khi người mở thoát, khi người mở không nhắn, khi không ai nhắn)
  • Claim: Cho phép supporter nhận ticket, và supporter khác còn được xem/nhắn vào ticket đã được nhận hay không
  • Blacklist: Chặn một role bất kì khỏi tạo ticket

Tham số lệnh (Parameters)

Không có tham số

Ví dụ sử dụng lệnh

command
/ticket configuration

/ticket panel configuration - Cài đặt bảng ticket

Lệnh này sẽ mở menu quản lí các bảng ticket (danh mục). Mỗi nút bấm mở ticket được coi là 1 bảng ticket. Với mỗi bảng, bạn có thể chỉnh:

  • Tên danh mục: Tên, emoji và màu của nút mở ticket
  • Category tạo ticket: Category (hoặc kênh, nếu thể loại là thread) mà ticket mới sẽ được tạo trong đó
  • Quản lí câu hỏi: Các câu hỏi khi mở ticket (tối đa 5 câu, giới hạn của Discord), loại câu trả lời ngắn/dài, bắt buộc hay không
  • Role hỗ trợ: Các role sẽ được thêm vào ticket mỗi khi được mở
  • Tin nhắn mở: Tin nhắn chào mừng khi ticket được mở
  • Tin nhắn bảng: Tin nhắn hiển thị ngoài bảng ticket (embed và/hoặc nội dung)
  • Ưu tiên: Ticket của role ưu tiên sẽ được đẩy lên trên cùng của category, có thể đặt tên ticket riêng cho từng role

Tin nhắn mở và tin nhắn bảng đều hỗ trợ BucketScript và Embed.

Tham số lệnh (Parameters)

Không có tham số

Ví dụ sử dụng lệnh

command
/ticket panel configuration

Gửi bảng ticket


/ticket panel send - Gửi một bảng ticket

Lệnh này sẽ gửi một (không phải nhiều) bảng ticket vào kênh

Tham số lệnh (Parameters)

Bắt buộc:

  • channel: Chọn kênh
  • panel: Chọn một bảng ticket

Ví dụ sử dụng lệnh

Lệnh này sẽ gửi bảng ticket Hỗ trợ chung vào kênh #support

command
/ticket panel send channel:#support panel:Hỗ trợ chung

/ticket multi-panel manage - Quản lí multi-panel

Multi-panel là 1 tin nhắn chứa nhiều bảng ticket cùng lúc. Lệnh này sẽ mở menu để bạn chọn các bảng ticket được gắn vào multi-panel, và chọn hiển thị dạng nút (button) hay hộp chọn (dropdown).

Tham số lệnh (Parameters)

Không có tham số

Ví dụ sử dụng lệnh

command
/ticket multi-panel manage

/ticket multi-panel send - Gửi multi-panel

Lệnh này sẽ gửi multi-panel vào kênh

Tham số lệnh (Parameters)

Bắt buộc:

  • channel: Chọn kênh

Ví dụ sử dụng lệnh

Lệnh này sẽ gửi multi-panel vào kênh #support

command
/ticket multi-panel send channel:#support

Các lệnh trong ticket


/ticket close - Đóng ticket

Lệnh này sẽ đóng ticket hiện tại. Nếu server có kênh transcript, bot sẽ lưu lại lịch sử chat, và người mở có thể đánh giá ticket (nếu bật).

Tham số lệnh (Parameters)

Bắt buộc:

  • reason: Nhập hoặc chọn một lí do

Ví dụ sử dụng lệnh

Lệnh này sẽ đóng ticket với lí do Đã giải quyết xong vấn đề

command
/ticket close reason:Đã giải quyết xong vấn đề

/ticket unclaim - Bỏ nhận ticket

Lệnh này sẽ bỏ nhận ticket hiện tại, để supporter khác có thể nhận

Tham số lệnh (Parameters)

Không có tham số

Ví dụ sử dụng lệnh

command
/ticket unclaim

/ticket add - Thêm người/role vào ticket

Lệnh này sẽ cho một thành viên hoặc role xem và nhắn vào ticket hiện tại

Tham số lệnh (Parameters)

Bắt buộc:

  • object: Chọn một role hoặc người dùng

Ví dụ sử dụng lệnh

Lệnh này sẽ thêm role @Developer vào ticket

command
/ticket add object:@Developer

/ticket remove - Xóa người/role khỏi ticket

Lệnh này sẽ xóa quyền truy cập ticket của một thành viên hoặc role

Tham số lệnh (Parameters)

Bắt buộc:

  • object: Chọn một role hoặc người dùng

Ví dụ sử dụng lệnh

Lệnh này sẽ xóa @tudubucket khỏi ticket

command
/ticket remove object:@tudubucket

/rename - Đổi tên ticket

Lệnh này sẽ đổi tên ticket hiện tại. Cần quyền Manage Channels.

Tham số lệnh (Parameters)

Bắt buộc:

  • name: Tên mới cho ticket

Ví dụ sử dụng lệnh

Lệnh này sẽ đổi tên ticket thành đã-xử-lí

command
/rename name:đã-xử-lí

Kênh hay Thread?


Kênh (Channel)Thread
Hiển thịNằm ngay trong category, dễ nhìnPhải bấm vào kênh để xem
Số lượngTối đa 50 kênh/category, 500 kênh/server (giới hạn của Discord). Category đầy thì bot sẽ tự tạo category - OverflowGần như không giới hạn
Phù hợpServer nhỏ - vừaServer lớn, nhiều ticket

Bạn có thể đổi thể loại trong /ticket configuration.