Cẩm nang Nâng cấp từ V1 lên V2
Hướng dẫn chuyển đổi toàn diện dành cho các máy chủ đang sử dụng Booking Bot V1 nâng cấp lên thế hệ mới V2.
Tài liệu này được biên soạn dành riêng cho các chủ máy chủ (Server Owner) và ban quản trị đang vận hành Booking Bot V1 và có kế hoạch nâng cấp lên Booking Bot V2 để tận dụng các tính năng tự động hóa vượt trội.
1. So Sánh Đột Phá: V1 và V2 Khác Nhau Thế Nào?
Booking Bot V2 không chỉ là một bản cập nhật nhỏ, mà là sự thay đổi toàn diện về trải nghiệm vận hành và tự động hóa:
| Hạng mục vận hành | Booking Bot V1 (Phiên bản cũ) | Booking Bot V2 (Thế hệ mới) |
|---|---|---|
| Quản lý phiên chơi | Giờ chơi được ghi nhận gộp chung vào hồ sơ, khó theo dõi riêng lẻ từng phiên | Mỗi lần đặt lịch là một Hóa đơn độc lập có mã tra cứu riêng biệt (bill-id) |
| Phân loại dịch vụ | Không phân tách rõ ràng hình thức | Hỗ trợ phân loại trực tiếp Cam hoặc Game ngay trên hóa đơn |
| Hoàn tiền dịch vụ | Nhân viên phải nhập lại số giờ và loại giờ thủ công, dễ nhầm lẫn | Hoàn trả chính xác 100% chỉ cần nhập mã hóa đơn /refundbill bill-id:<id> |
| Trải nghiệm khách hàng | Khách phải chờ đợi nhân viên rảnh tay gõ lệnh | Khách hàng tự đặt lịch, donate, nạp cọc trực tiếp qua Panel nút bấm thông minh |
| Thanh toán chuyển khoản | Supporter phải mở app ngân hàng tự kiểm tra bằng mắt | Tự động tạo mã VietQR theo từng hóa đơn và đối soát khớp lệnh tức thì |
| Phòng đàm thoại (Voice Room) | Staff phải tự kéo kênh và tạo phòng thủ công | Tự động tạo phòng voice theo bill, tự hủy sau 5 phút và cảnh báo trễ qua kênh Ping Bill |
| Bảng tổng hợp lương | Ưu tiên tính theo giờ ngày, khó đối soát giờ đêm | Sắp xếp khoa học theo tổng số giờ (ngày + đêm + Cam + Game) và tách riêng giờ đêm |
| Quản lý QR lương Player | Gửi thủ công qua tin nhắn chat, dễ thất lạc | Quản lý tập trung qua /setupbankqr và /bankqr (lọc lương tối thiểu, tạo phiên thanh toán) |
| Đồng bộ quyền Ticket | Phải gỡ quyền thủ công từng người trong kênh | Tự động đồng bộ theo vai trò máy chủ; nhân sự bị gỡ role lập tức mất quyền xem ticket |
| Thiết lập ban đầu | Gõ hàng chục câu lệnh cấu hình riêng lẻ | Chỉ cần 1 câu lệnh /setup để bot tự động tạo toàn bộ vai trò và kênh log |
| Bảo mật dòng tiền | Quyền hạn tài chính chưa được phân lập chặt chẽ | Vai trò Cash (Kế toán) được tách biệt hoàn toàn, chống thất thoát quỹ |
2. Bảng Đối Chiếu Thay Đổi Câu Lệnh & Tùy Chọn
Nhiều tính năng trong V2 vẫn giữ nguyên bản chất xử lý của V1 nhưng được đổi tên lệnh cho ngắn gọn, dễ nhớ và khoa học hơn:
| Nghiệp vụ cần làm | Câu lệnh / Tùy chọn ở V1 | Câu lệnh tương ứng ở V2 | Ghi chú vận hành |
|---|---|---|---|
| Khởi tạo nhanh bot | (Không có) | /setup | Wizard cài đặt tự động 1-click |
| Cài đặt vai trò và quyền | /settings roles | /setuprole | Cài đặt role và phân quyền theo cấp bậc |
| Tùy biến quyền từng lệnh | (Không có) | /setuprole permission | Phân quyền chi tiết cho từng lệnh hoặc nhóm lệnh |
| Cài đặt biểu phí & lương | /settings server | /config view hoặc /config set | Bảng điều hành biểu phí tập trung |
| Gửi bảng đặt lịch cho khách | (Không có) | /config selfservice send | Panel khách tự phục vụ (Self-Service) |
| Bật/tắt nút trên panel | (Không có) | /config selfservice toggle | Mở Form chọn nhanh 4 nút (React, Book, Donate, Nạp cọc) |
| Thiết lập kênh nhận log | /settings logs | /logger setup (hoặc /logger channel) | Khởi tạo hệ thống 9 nhóm kênh nhật ký |
| Cấu hình tài khoản ngân hàng | /settings qr | /payment-config set-qr | Cài đặt thông tin nhận tiền và VietQR |
| Tạo hóa đơn đặt lịch | /book (book_đêm) | /book (bill_đêm) | Bổ sung chọn Cam/Game, phí server, giá riêng, ẩn danh |
| Phương thức trừ cọc | Phương thức Trừ cọc | Phương thức Cash | Logic trừ số dư cọc của khách giữ nguyên |
| Phương thức trừ lương | Phương thức Trừ lương | Phương thức Salary | Logic trừ số dư lương player giữ nguyên |
| Hoàn tiền đơn đặt lịch | Hoàn giờ thủ công | /refundbill (alias: /hoanbill) | Hoàn tiền chính xác theo mã bill-id |
| Hoàn tiền khoản ủng hộ | Hoàn tiền thủ công | /refunddonate (alias: /hoandonate) | Hoàn tiền donate theo mã bill-id |
| Tính & xem lương cá nhân | luong / tinhluong | b.salary / b.salarycalc | Logic tính lương giữ nguyên |
| Báo cáo tổng lương | tongluong | b.totalsalary | Sắp xếp theo tổng số giờ (ngày + đêm + Cam + Game) |
| Cửa hàng & Hộp quà | Lệnh box | /luckybox + unbox | Quản lý cấu hình bằng slash; mở hộp bằng prefix (ub, mohop) |
| Đọc văn bản voice | speak | tts | Chuyển văn bản thành giọng nói (alias speak vẫn dùng được) |
| Tạo tin nhắn Embed | embed | /embedv2 | Trình tạo tin nhắn nhúng Components V2 |
| Thông tin hệ thống bot | info | botinfo | Hiển thị thông số máy chủ và phiên bản bot |
| Chế độ khớp Autoresponder | ar include | ar matchmode | Hỗ trợ exact, includes, startsWith, endsWith |
| Xem cấu hình Autoresponder | ar info | ar view | Tra cứu chi tiết trigger phản hồi tự động |
3. Các Siêu Tính Năng Độc Quyền Chỉ Có Ở V2
Khi nâng cấp lên phiên bản V2, máy chủ của bạn sẽ sở hữu ngay các tính năng đột phá:
- Panel Khách Tự Phục Vụ (Self-Service Panel): Khách hàng tự bấm nút tìm kiếm player qua React, chọn hình thức chơi (Cam/Game), nạp cọc qua BankQR hoặc mở phòng vé hỗ trợ mà không cần nhân viên trực máy chủ 24/7.
- Thanh Toán VietQR Tự Động: Tích hợp với Pay2S, SePay, ApiPay giúp tự động nhận diện tiền về tài khoản và chốt bill cho khách trong 2 giây. Hỗ trợ trigger chat nhanh
qr <số tiền>cho supporter. - Theo Dõi Phòng Voice & Cảnh Báo Trễ: Sau khi bill hoàn tất, bot tự động tạo phòng voice riêng. Nếu khách đã vào phòng mà player chưa vào, bot sẽ tự động gửi cảnh báo vào kênh Ping Bill (ngay khi phát hiện, sau 3 phút và sau 5 phút sẽ ping supporter hỗ trợ). Phòng voice tự hủy sau 5 phút nếu không có ai.
- Hệ Thống QR Ngân Hàng Của Player (
/setupbankqr,/bankqr): Player gửi ảnh QR vào kênh chuyên biệt để bot lưu trữ. Quản trị viên dễ dàng lọc danh sách theo mức lương tối thiểu và tạo phiên thanh toán lương nhanh chóng. - Cơ Chế Đặt Lịch Ẩn Danh: Bảo vệ quyền riêng tư tuyệt đối cho khách hàng VIP với tùy chọn hiển thị tên thành "Ai đó" trên các kênh công khai (hệ thống sổ cái vẫn ghi nhận chính xác tài khoản khách).
- Hệ Thống Phản Hồi Đánh Giá Sao (Feedback): Thu thập ý kiến khách hàng (1-5 sao) sau mỗi phiên phục vụ để xếp hạng mức độ uy tín của từng player.
- Hệ Thống Hộp Quà May Mắn (Lucky Box) & 9 Nhóm Kênh Log: Quản lý tỷ lệ rơi phần trăm chuẩn xác qua slash command và ghi nhận nhật ký chuyên sâu, bảo vệ minh bạch dòng tiền.
Lưu ý về tính năng đang phát triển: Chức năng Thẻ Hồ Sơ Player AR Canvas V2 (vẽ danh thiếp đồ họa kèm nút Book/Donate trực tiếp) và giao diện Live Preview của lệnh ar edit hiện đang được đội ngũ kỹ thuật Motional Hub tiếp tục hoàn thiện trong các bản cập nhật tiếp theo.
4. Tính Năng Ngừng Hỗ Trợ: Anti-Raid
Thông báo thay đổi cấu trúc tính năng: Tính năng Anti-Raid (chống spam, chống nuke, bảo vệ máy chủ cơ bản) không tiếp tục phát triển trên Booking Bot V2.
- Lý do điều chỉnh: Nhằm tối ưu hóa tài nguyên máy chủ, độ phản hồi realtime và sự ổn định cao nhất cho hệ thống giao dịch tài chính, Booking Bot V2 được tái cấu trúc để tập trung chuyên sâu 100% vào các nghiệp vụ cốt lõi: Booking, Quản lý Hóa đơn, Tính Lương, Điều hành Phòng Voice và Cổng Thanh toán.
- Giải pháp cho máy chủ: Các tính năng bảo vệ máy chủ, an ninh thành viên và kiểm duyệt tự động sẽ được chuyển giao sang bot tiện ích bảo mật độc lập của Motional Hub, giúp tách biệt hoàn toàn giữa bảo mật và vận hành dịch vụ thương mại.
5. Các Luồng Nghiệp Vụ Quen Thuộc Giữ Nguyên
Để giúp đội ngũ nhân sự và supporter không bị bỡ ngỡ, Booking Bot V2 vẫn giữ nguyên hoàn toàn quy trình xử lý của các nghiệp vụ quen thuộc:
- Tạo bill bằng lệnh
/book: Quy trình nhập supporter, khách hàng, số giờ và chọn phương thức thanh toán giữ nguyên thói quen vận hành cũ. - Quy trình Donate: Lệnh
/donategiữ nguyên công thức phân chia phần trăm giữa player và máy chủ. - Hệ thống Cửa hàng & Kho đồ (Shop & Inventory): Các lệnh mua bán vật phẩm (
shop,buy,/item,gift,inventory) giữ nguyên logic giao dịch. - Tiền tệ nội bộ: Các lệnh quản lý số dư ví cọc (
b.cash,b.addcash,b.subcash,b.give,b.topcash) hoạt động hoàn toàn giống như phiên bản V1. - Autoresponder cơ bản: Cú pháp kích hoạt tin nhắn theo từ khóa và phản hồi cơ bản giữ nguyên cách dùng.
- Hệ thống Ticket: Thao tác đóng, lưu trữ transcript và mở lại ticket giữ nguyên trải nghiệm thuận tiện.
6. Quy Trình Chuyển Đổi Dữ Liệu An Toàn
Để chuyển từ V1 sang V2 mà không làm gián đoạn hoạt động của máy chủ hay thất thoát số dư của khách hàng:
Bước 1: Chốt Kỳ & Sao Lưu Dữ Liệu Trên Bot V1
Trước thời điểm chuyển đổi, ban quản trị nên chạy lệnh b.totalsalary trên bot V1 để lưu lại bảng tổng kết lương và số dư cọc của các thành viên.
Bước 2: Kích Hoạt Booking Bot V2 & Đồng Bộ Dữ Liệu
Kỹ thuật viên của Motional Hub sẽ hỗ trợ kích hoạt công cụ chuyển giao dữ liệu (Data Migration). Toàn bộ số dư ví cọc của khách hàng, lịch sử làm việc của player và cấu hình máy chủ sẽ được chuyển giao nguyên vẹn sang hệ thống V2.
Bước 3: Chạy Wizard Cài Đặt /setup
Chủ máy chủ thực hiện lệnh /setup trên V2 để bot đồng bộ lại hệ thống vai trò và các kênh ghi nhận lịch sử mới.
Bước 4: Gửi Panel Khách Hàng
Thực hiện lệnh /config selfservice send vào kênh đặt lịch để khách hàng bắt đầu trải nghiệm giao diện đặt lịch tự phục vụ thế hệ mới.
Đội ngũ kỹ thuật hỗ trợ trực tiếp: Quá trình chuyển đổi dữ liệu từ V1 lên V2 luôn có kỹ thuật viên của Motional Hub túc trực hỗ trợ tại Discord Hỗ Trợ để đảm bảo an toàn 100% cho dữ liệu máy chủ của bạn.