Cài đặt nhanh

Hướng dẫn 3 bước đưa Booking Bot V2 vào hoạt động trên máy chủ Discord.

Trang này cung cấp các bước ngắn gọn nhất để đưa Booking Bot V2 vào vận hành trên máy chủ của bạn. Hệ thống V2 đã được tích hợp bộ cài đặt tự động giúp tiết kiệm 90% thời gian cấu hình so với các phiên bản trước đây.

Điều Kiện Chuẩn Bị

Trước khi bắt đầu, hãy đảm bảo:

Bạn có quyền Administrator (Quản trị viên) hoặc là Server Owner trên máy chủ Discord.
Bot đã được mời vào máy chủ với đầy đủ các quyền hạn hệ thống cần thiết.
Trong phần Server Settings > Roles, vai trò của Bot phải được kéo lên vị trí cao hơn các vai trò của nhân viên (Staff, Player) để bot có thể quản lý và cấp quyền chính xác.

3 Bước Thiết Lập Hoạt Động

Bước 1: Mời Bot vào Máy chủ

Sử dụng liên kết mời chính thức từ Motional Hub để thêm bot vào máy chủ của bạn. Đảm bảo tích chọn đầy đủ các quyền được yêu cầu trên màn hình xác thực OAuth2.

Bước 2: Chạy Trình Cài Đặt Thông Minh `/setup`

Truy cập vào một kênh chat quản trị (nơi chỉ có Admin xem được) và gõ câu lệnh:

/setup

Bot sẽ mở một giao diện wizard tương tác (Components V2). Trình cài đặt sẽ tự động:

Khởi tạo các vai trò mẫu cho hệ thống nếu chưa có (Admin, Cash, Supporter, Player).
Tạo danh mục kênh Booking Logs và toàn bộ các kênh ghi log chuyên dụng (Bill Log, Cash Log, Mod Log...).
Hướng dẫn các bước liên kết ban đầu.

Xem hướng dẫn chi tiết về các tùy chọn tại Hướng dẫn Setup Wizard.

Bước 3: Gán Quyền Bot Cho Các Vai Trò Discord

Nếu máy chủ của bạn đã có sẵn các vai trò nhân viên từ trước và muốn liên kết trực tiếp với hệ thống phân quyền của bot, sử dụng lệnh:

/setuprole add permission:<Tên-Quyền> role:<@Role-Discord>

Ví dụ gán quyền thực tế:

/setuprole add permission:Admin role:@BanQuanTri
/setuprole add permission:Cash role:@KeToan
/setuprole add permission:Supporter role:@NhanVien
/setuprole add permission:Player role:@Gamer

Kiểm tra lại toàn bộ danh sách phân quyền đã gán bằng lệnh:

/setuprole list

Kiểm Tra Trạng Thái Vận Hành

Sau khi hoàn thành 3 bước trên, bạn có thể kiểm tra cấu hình tổng quan của hệ thống bằng lệnh:

/config view

Bảng thông tin sẽ hiển thị toàn bộ biểu phí, lương, kênh log và phân quyền hiện tại. Nếu mọi thông số đã hiển thị đầy đủ, bot đã sẵn sàng phục vụ đơn đặt lịch đầu tiên của máy chủ.

Lưu ý về vai trò Cash (Thu ngân): Trong Booking Bot V2, quyền Cash là quyền tài chính độc lập, không kế thừa tự động từ các vai trò khác để đảm bảo an toàn tuyệt đối cho số dư tài khoản của khách hàng. Hãy gán vai trò này cho đúng nhân sự phụ trách kế toán.