Xử lý sự cố (Troubleshooting)

Trang này hướng dẫn bạn cách chẩn đoán và tự khắc phục các vấn đề kỹ thuật thường gặp khi sử dụng Booking Bot.

1. Bot đột ngột ngừng hoạt động hoặc không phản hồi

Quy trình tự động khởi động lại (Overload Restart)

Khi hệ thống xử lý lượng lớn yêu cầu hoặc thực hiện sao lưu định kỳ, bot có thể rơi vào trạng thái quá tải và tự động khởi động lại để giải phóng bộ nhớ.

• Trạng thái: Bot sẽ tạm thời hiển thị ngoại tuyến (offline) và không phản hồi tin nhắn.
• Thời gian chờ: Thời gian restart trung bình từ 1 đến 3 phút (tùy thuộc vào số lượng bot đang hoạt động trên cụm máy chủ).
• Khuyến nghị: Hãy đợi từ 2 đến 3 phút. Trong hầu hết các trường hợp, bot sẽ tự động trực tuyến trở lại mà không làm mất bất kỳ cấu hình hay số dư tài khoản nào.

Các bước kiểm tra cơ bản nếu bot vẫn offline:

1. Đảm bảo tài khoản bot có trạng thái online trên server Discord.
2. Kiểm tra xem bot có bị chặn quyền đọc và gửi tin nhắn tại kênh chat bạn đang thực hiện hay không.
3. Gõ câu lệnh @Tên_Bot ping để kiểm tra độ trễ phản hồi của bot.

2. Lỗi phân quyền và Truy cập Lệnh

• Không nhìn thấy slash command: Đảm bảo vai trò của bạn trên server đã được khai báo chính xác trong lệnh /settings roles.
• Lỗi Missing Permissions khi gán role: Vui lòng di chuyển vai trò của bot lên vị trí cao hơn vai trò cần gán trong phần cấu hình role Discord của server.
• Tính năng bị khóa: Một số lệnh (ví dụ: parttime) bị ẩn nếu bot name của server không được kích hoạt tính năng này trong cấu hình backend.

3. Lỗi Định dạng nhập số tiền

Hệ thống xử lý số liệu tự động sẽ từ chối giao dịch nếu nhập sai định dạng tiền tệ:

• Đúng cú pháp: 100000, 100k, 1.5m.
• Sai cú pháp: 100,000 (có dấu phẩy), 100.000 (có dấu chấm phân tách hàng nghìn), 100 000 (có khoảng trắng).
• Giới hạn tối thiểu: Tạo hóa đơn booking yêu cầu số giờ tối thiểu từ 1, hóa đơn donate yêu cầu số tiền lớn hơn 0.

4. Lỗi Hệ thống Ticket & Embed

• Không tạo được ticket hỗ trợ: Kiểm tra xem bot đã được cấp quyền Create Private Threads (Tạo luồng riêng tư) và Manage Channels tại kênh chứa ticket panel hay chưa.
• Embed không hiển thị hình ảnh: Kiểm tra xem đường dẫn ảnh (URL) có kết thúc bằng định dạng file ảnh hợp lệ (như .png, .jpg, .webp) hay không. Đảm bảo bot được cấp quyền Embed Links trong kênh chat.

5. Mẫu báo cáo sự cố (Bug Report)

Nếu đã thực hiện các bước trên nhưng vẫn gặp lỗi, vui lòng tạo ticket hỗ trợ và gửi thông tin theo mẫu dưới đây để đội ngũ kỹ thuật xử lý nhanh nhất:

Mẫu báo lỗi (Bug Report):
1. Tên Server & ID Server: [Nhập thông tin]
2. Cú pháp lệnh đã chạy: [Ví dụ: /book khách:@A player:@B...]
3. Lỗi xuất hiện hoặc thông báo của bot: [Mô tả chi tiết lỗi]
4. Thời gian xảy ra lỗi: [Ngày/Giờ]
5. Ảnh chụp màn hình lỗi (Screenshot): [Đính kèm nếu có]
6. Các bước tái hiện lỗi:
   - Bước 1: Chạy lệnh...
   - Bước 2: Bấm nút xác nhận...
   - Bước 3: Xuất hiện lỗi...