Giới thiệu chung Booking Bot V2

Tài liệu hướng dẫn vận hành hệ thống Discord Booking Bot V2 thế hệ mới.

Chào mừng bạn đến với trung tâm tài liệu chính thức của Booking Bot V2 được phát triển bởi Motional Hub.

Booking Bot V2 là phiên bản thế hệ mới, được thiết kế lại toàn diện về kiến trúc và trải nghiệm người dùng nhằm tối ưu hóa quy trình đặt lịch, quản lý tài chính và tự động hóa vận hành máy chủ Discord.

Điểm Cải Tiến Cốt Lõi Ở Phiên Bản V2

Kiến trúc Hóa đơn Độc lập: Mỗi phiên booking là một hóa đơn riêng biệt với mã định danh duy nhất (bill-id), loại bỏ hoàn toàn tình trạng nhầm lẫn giờ chơi và hỗ trợ hoàn tiền chính xác tuyệt đối.
Panel khách tương tác trực tiếp: Khách hàng có thể tương tác trực tiếp qua hệ thống nút bấm (React, Book, Donate, Nạp cọc) và Modal biểu mẫu ngay trên giao diện Discord.
Cổng thanh toán tự động & BankQR: Hỗ trợ tạo mã VietQR theo từng bill và xác nhận nạp tiền tức thì qua các cổng webhook (Pay2S, SePay, ApiPay).
Bộ cài đặt thông minh (Setup Wizard): Khởi tạo toàn bộ vai trò mẫu, kênh log và phân quyền chỉ với một câu lệnh /setup.

Cấu Trúc Tài Liệu V2

Tài liệu được phân chia thành 7 chuyên mục chuyên biệt:

Bắt đầu sử dụng: Hướng dẫn mời bot, cấp quyền ban đầu và chạy trình cài đặt /setup.
Quy trình Booking: Luồng nghiệp vụ chi tiết từ khi khách đặt lịch, hỗ trợ Cam/Game, tính giờ đêm, tính lương và hoàn tiền.
Quản trị & Phân quyền Staff: Phân quyền theo hệ thống BotRole (Owner, Admin, Supporter, Cashier, Player) và cấu hình kênh log.
Tính năng mở rộng: Thiết lập Ticket hỗ trợ, Đánh giá sau dịch vụ (Feedback) và Autoresponder V2.
Kinh tế & Thanh toán: Cấu hình cổng nạp tự động, cơ chế BankQR Pending và quản lý cọc.
Tài liệu tham khảo: Bảng tra cứu toàn bộ 100% câu lệnh Slash của phiên bản V2.
Hỗ trợ & Sự cố: Hướng dẫn chẩn đoán và khắc phục các vấn đề vận hành thường gặp.

Lộ Trình Triển Khai Cho Máy Chủ Mới

Để đưa bot vào vận hành nhanh nhất và không gặp lỗi phân quyền, bạn nên thực hiện theo trình tự sau:

Bước 1: Mời Bot và Cấp Quyền

Mời bot vào máy chủ Discord của bạn với quyền Administrator và sắp xếp thứ tự vai trò (Role) của Bot cao hơn các vai trò của Staff. Xem chi tiết tại Hướng dẫn phân quyền.

Bước 2: Chạy Trình Cài Đặt Tự Động

Thực hiện lệnh /setup để bot tự động tạo các vai trò mẫu và hệ thống danh mục kênh log chuyên dụng. Xem chi tiết tại Setup Wizard.

Bước 3: Cấu Hình Tài Chính Máy Chủ

Sử dụng lệnh /config view để thiết lập bảng giá booking, lương player và phụ phí server phù hợp với chính sách của máy chủ bạn. Xem chi tiết tại Cấu hình hệ thống.

Bước 4: Khởi Tạo Panel Khách Hàng

Sử dụng lệnh /config selfservice send để gửi bảng tương tác đặt lịch vào kênh công khai cho khách hàng.

Đối với các máy chủ đang sử dụng Booking Bot V1 và có nhu cầu chuyển đổi dữ liệu sang V2, vui lòng tham khảo Cẩm nang chuyển đổi V1 sang V2.