Motional HubDocs
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.

Trợ giúp theo ngữ cảnh (HD01): Khi gặp thông báo lỗi từ bot, bấm vào liên kết Xem hướng dẫn chi tiết để đối chiếu nguyên nhân và cách khắc phục trực tiếp tại cẩm nang này.

Khi bot không phản hồi hoặc báo lỗi, hãy đối chiếu các tình huống dưới đây để tự xử lý nhanh.


1. Lệnh Không Phản Hồi

Hiện tượngNguyên nhân có thểCách xử lý
Gõ lệnh văn bản không thấy trả lời (ví dụ b.cash)Máy chủ đã đổi tiền tốHỏi chủ máy chủ tiền tố hiện tại; đưa về mặc định bằng nút Về mặc định ở mục Chung của /config.
Gõ / không thấy lệnh của botBot vừa vào máy chủ hoặc thiếu quyền lệnh ứng dụngĐợi vài phút. Nếu vẫn không có, mời lại bot bằng liên kết chính thức.
Bot báo cần vai trò ... hoặc cao hơnTài khoản chưa được gán quyềnChủ máy chủ mở /setuprole và chọn đúng vai trò cho quyền đó.
Bot báo đã hết hạnHết hạn sử dụngNgười có quyền Administrator chạy /renew để gia hạn bằng QR.
Bot hiển thị OfflineHệ thống đang khởi động lại hoặc bảo trìChờ vài phút hoặc xem thông báo tại Discord Hỗ Trợ.

Kiểm tra nhanh: b.ping hoặc b.botinfo.


2. Booking, Lương & Hóa Đơn

Hiện tượngNguyên nhân có thểCách xử lý
Giá bill hoặc lương tính saiCấu hình giá chưa đúng/config ➔ mục Giá & phí, bấm nút nhóm tương ứng để sửa.
Bill Cam / Game báo cần giáChưa có giá cho loại bill nàyNhập giá trên lệnh, hoặc cài giá Cam / Game trong /config, mục Giá & phí.
Tính nhầm giờ đêmKhung giờ đêm chưa đúngKiểm tra nhóm Khung giờ đêm trong /config, mục Giá & phí.
Hoàn tiền báo không tìm thấy hóa đơnSai mã hoặc nhầm lệnhLấy mã bill-id trong kênh log Bill. Dùng /refundbill cho bill book, /refunddonate cho bill donate.
Không thấy bill trong kênh logChưa gán kênh hoặc bot thiếu quyềnGõ /logger để kiểm tra, chọn loại log Bill rồi chọn kênh.
Không có King / Queen sau khi chốt kỳChưa chọn vai trò ứng viên hoặc không ai đạt giờ tối thiểuXem lại cài đặt trong /setupplayerbadge.

3. Bảng Tự Phục Vụ

Hiện tượngCách xử lý
/panel báo chỉ dùng trong ticketBảng tự phục vụ chỉ mở được bên trong ticket.
Báo tính năng chưa được bậtChủ máy chủ bật nút bằng /config ➔ mục Panel khách.
Không thấy nút Nạp cọcMáy chủ chưa cài /payment-config.
Báo chưa có cách thanh toánKhách không có cọc, không có lương và máy chủ chưa cài QR. Nạp cọc trước hoặc nhờ supporter.
Báo thao tác hơi nhanhĐợi vài giây rồi bấm lại.
Chọn player bị từ chốiChỉ chọn được người có vai trò Player.

4. Tiền Cọc

Hiện tượngNguyên nhân có thểCách xử lý
Không dùng được b.ac, b.scChưa có quyền CashAdmin không tự động cộng / trừ tiền. Chủ máy chủ gõ /setuprole và chọn vai trò cho quyền Cash.
b.give thất bạiKhông đủ số dưKiểm tra bằng b.cash.
Số dư âmKhách đang nợTheo dõi bằng b.topdebt.
/deposit báo sai số tiềnNgoài giới hạnMỗi lần nạp từ 10.000 đến 50.000.000 VNĐ.

5. Thanh Toán VietQR

Hiện tượngNguyên nhân có thểCách xử lý
Gõ qr không thấy mã QRMáy chủ chưa cài QRChủ máy chủ gõ /payment-config, mở mục Tài khoản nhận tiền và bấm Nhập Tài Khoản.
Đã chuyển khoản nhưng bill chưa lên / chưa cộng cọcSai số tiền, sai nội dung hoặc ngân hàng chậmSupporter bấm Check trên tin QR; khi kênh log bank đã có thông báo nhận tiền của bot thì bấm Xác nhận đã nhận tiền. Xem BankQR đang chờ.
BankQR báo chưa sẵn sàngChưa cài QR hoặc kết nối thanh toán chưa bậtKiểm tra mục Tài khoản nhận tiền của /payment-config; liên hệ đội hỗ trợ nếu kết nối chưa bật.
Đã nhận tiền nhưng tạo bill lỗiLỗi khi lên billAdmin bấm Thử tạo bill lại trên tin QR.
Mã QR lệch trên ảnh nềnVị trí, kích thước chưa khớpMở /payment-config ➔ mục Hình QR, bấm Kích Thước & Vị Trí hoặc các nút nghiêng. Ảnh QR trong bảng đổi theo ngay.

6. Ticket

Hiện tượngNguyên nhân có thểCách xử lý
Bấm nút ticket không mở đượcBảng đã bị xóa hoặc bot thiếu quyền/ticket list để kiểm tra; /ticket send để gửi lại bảng. Bot cần quyền tạo luồng riêng tư trong kênh.
Khách không đóng được ticketChỉ Supporter đóng đượcSupporter bấm Đóng Ticket hoặc gõ b.close.
Người được tag bị loại khỏi ticketTag không cấp quyền xemDùng /ticket add-member.
Supporter cũ vẫn thấy ticketTắt dọn quyềnBật Dọn Quyền Sup trong /ticket settings.
Ticket tự đóng quá sớmThời gian chờ ngắnBấm Giữ Ticket (Hold), hoặc chỉnh /config ➔ mục Tự đóng ticket.

7. Thông Báo

Hiện tượngCách xử lý
Khách không nhận lời cảm ơnKiểm tra /config ➔ mục Thông báo; khách gõ b.profile, bấm Settings để xem đã bật DM chưa, và kiểm tra cài đặt tin nhắn riêng của Discord.
Player không nhận tin báo billPlayer gõ b.tinhluong, bấm Settings để xem đã bật DM In-Out chưa; chủ máy chủ kiểm tra /config ➔ mục Thông báo.
Bot không báo khi có người vào / rời room voiceTính năng mặc định tắt: chủ máy chủ bật trong /config ➔ mục Thông báo. Kiểm tra bot có quyền Xem kênh, Kết nối và Gửi tin nhắn ở kênh voice đó.

8. Autoresponder & Hồ Sơ Player

Hiện tượngCách xử lý
Gõ tên không hiện gìb.ar list kiểm tra tên; b.ar view <tên> kiểm tra cách khớp.
Hồ sơ không hiện ở một kênhKênh không nằm trong danh sách được phép; xem /player-profile config.
Nút sửa không bấm đượcPhiên đã hết hạn hoặc bạn không phải người mở; gõ lại b.ar edit <tên>.
Ảnh không nhậnLink phải bắt đầu bằng http:// hoặc https://; nên đính kèm ảnh trực tiếp.
b.ar changenumber, b.ar showall báo đã thay thếDùng b.ar rename và b.ar view.

9. Anti-Raid

Hiện tượngCách xử lý
Supporter bị xóa tin, tắt tiếngThêm vào /antiraid whitelist.
Link hợp lệ bị xóaThêm tên miền bằng /antiraid link domain-add, hoặc chỉnh kênh áp dụng bằng /antiraid scope.
Kênh vẫn khóa sau raid/antiraid recover.
Không thấy cảnh báoGõ /logger, chọn loại log Moderation rồi chọn kênh.

Khi Cần Hỗ Trợ

Gửi cho đội hỗ trợ tại Discord Hỗ Trợ:

  1. Tên máy chủ và Server ID.
  2. Lệnh đã chạy.
  3. Thông báo lỗi của bot, kể cả mã lỗi nếu có.
  4. Thời gian xảy ra (giờ Việt Nam).

On this page