Hỗ trợ & Sự cố
Cẩm nang Xử lý Sự cố (Troubleshooting)
Bảng chẩn đoán và hướng dẫn khắc phục nhanh các vấn đề vận hành thường gặp trong Booking Bot V2.
Trong quá trình vận hành Booking Bot V2, nếu gặp các hiện tượng bot không phản hồi hoặc thông báo lỗi quyền hạn, bạn có thể đối chiếu các tình huống dưới đây để tự xử lý nhanh chóng.
| Hiện tượng | Nguyên nhân có thể | Cách xử lý |
|---|
Gõ lệnh văn bản không thấy bot trả lời (ví dụ: b.cash, b.profile) | Máy chủ đã đổi tiền tố khác hoặc sai tiền tố | Gõ lệnh /setprefix để xem tiền tố hiện tại của máy chủ bạn, hoặc thử tag trực tiếp bot (ví dụ: @Bot cash). |
Gõ / nhưng không thấy danh sách lệnh Slash | Discord chưa đồng bộ xong danh mục lệnh | Thường mất 2–5 phút sau khi bot vào máy chủ mới. Nếu vẫn không hiện, hãy mời lại bot với đầy đủ phạm vi applications.commands. |
| Bot báo lỗi "Bạn không có quyền sử dụng lệnh này" | Tài khoản Discord của bạn chưa được cấp vai trò tương ứng | Nhờ Owner chạy /setuprole list để kiểm tra và gán đúng nhóm quyền cho vai trò của bạn. |
| Bot hiển thị trạng thái Offline | Hệ thống bot đang khởi động lại hoặc bảo trì định kỳ | Chờ 1–2 phút hoặc kiểm tra thông báo tại Discord Hỗ Trợ. |
| Hiện tượng | Nguyên nhân có thể | Cách xử lý |
|---|
| Giá trên hóa đơn hoặc tiền lương player tính sai | Cấu hình biểu phí máy chủ chưa cập nhật chuẩn | Chạy /config view, bấm nút nhóm tương ứng để mở Modal Form và nhập lại đơn giá chính xác. |
| Hoàn tiền báo lỗi "Không tìm thấy hóa đơn" | Nhập sai mã hóa đơn hoặc nhầm lệnh | Đảm bảo copy chính xác mã bill-id từ thông báo hóa đơn ban đầu. Dùng /refundbill cho đơn booking và /refunddonate cho khoản ủng hộ. |
| Không thấy hóa đơn gửi vào kênh Log | Chưa gán kênh hoặc bot thiếu quyền xem kênh | Chạy /logger view để kiểm tra. Nếu chưa có kênh, dùng /logger channel type:Bill channel:#ten-kenh. Đảm bảo Bot có quyền gửi tin nhắn trong kênh đó. |
| Nút bấm trên Panel khách báo lỗi "Phiên đã hết hạn" | Thời gian chờ tương tác của Discord vượt quá quy định | Bấm lại nút trên panel để mở phiên tương tác mới. |
| Hiện tượng | Nguyên nhân có thể | Cách xử lý |
|---|
Nhân viên không dùng được lệnh cộng/trừ tiền (b.ac, b.sc) | Nhân viên chưa được cấp vai trò Cash | Trong V2, quyền Admin không tự động cộng/trừ tiền. Owner cần gán quyền riêng: /setuprole add permission:Cash role:@ThuNgan. |
Khách gõ lệnh b.give báo thất bại | Số dư trong ví cọc không đủ hoặc nhập sai số tiền | Dùng b.cash kiểm tra số dư hiện có trước khi thực hiện chuyển tiền. |
| Tài khoản của thành viên hiển thị số dư âm | Thành viên được cấp quyền nợ hoặc dùng quá số dư | Đây là cơ chế ghi nợ bình thường nếu máy chủ cho phép. Ban quản trị có thể theo dõi danh sách nợ qua lệnh b.topdebt. |
| Hiện tượng | Nguyên nhân có thể | Cách xử lý |
|---|
Gõ từ khóa qr nhưng không thấy mã QR gửi ra | Kênh chat chưa được thiết lập thanh toán hoặc chưa có tài khoản ngân hàng | Chạy /payment-config view để kiểm tra. Cần gán kênh qua /payment-config set-channel và khai báo ngân hàng qua /payment-config set-qr. |
| Khách đã chuyển tiền nhưng đơn ở trạng thái Pending | Khách gõ thiếu mã nội dung hoặc ngân hàng chậm giao dịch | Nhân viên kiểm tra biến động số dư thực tế trong app ngân hàng và bấm nút Duyệt đơn thủ công trên hóa đơn. Xem chi tiết tại Xử lý BankQR Pending. |
| Mã QR bị che khuất hoặc lệch phông nền | Tọa độ và kích thước QR chưa khớp với ảnh nền | Sử dụng các lệnh /payment-config rotate-left, /payment-config rotate-right hoặc /payment-config set-qr với tham số qr-offset-y để cân chỉnh. |
| Hiện tượng | Nguyên nhân có thể | Cách xử lý |
|---|
| Bấm nút Ticket nhưng bot không tạo kênh mới | Bot bị thiếu quyền tạo kênh trên Discord | Vào Server Settings > Roles, kéo vai trò của Bot lên vị trí cao hơn và bật quyền Administrator hoặc Manage Channels. |
| Người lạ tự ý vào phòng vé của người khác | Phân quyền vai trò Supporter hoặc cài đặt kênh bị lọt quyền | Kiểm tra danh sách role được gán quyền Supporter qua /setuprole list. Đảm bảo vai trò @everyone không có quyền View Channel trong category chứa ticket. |
| Nhân viên không thể đóng ticket | Kênh ticket không thuộc quyền quản lý của bot | Sử dụng câu lệnh /ticket close khi có vai trò Supporter trở lên. |