Bot phân tích máy chủ Discord biến dữ liệu thô về lượt thành viên tham gia, ticket mở và thanh toán hóa đơn thành một báo cáo bạn có thể đọc chỉ trong một lần nhìn, dưới dạng embed Discord hoặc trên bảng điều khiển web. Noxyr làm điều này bằng hai lệnh gạch chéo, /status và /sales, một trang Tổng quan trên bảng điều khiển, và một Server API chỉ đọc để đưa cùng những con số đó sang website của bạn. Hướng dẫn này giải thích từng công cụ thực sự hiển thị gì.
/status: thống kê thành viên, ticket và cộng đồng
/status là lệnh chỉ dành cho quản trị viên với năm chế độ xem: all, invite, sales, tickets và community. Mỗi chế độ đều có tùy chọn days (7, 14 hoặc 30, mặc định 30) và trả về một embed kèm biểu đồ đường, nên vừa dùng để kiểm tra nhanh con số vừa xem xu hướng.
- /status invite: số lượt tham gia và rời đi của hôm nay, 7 ngày gần nhất và khoảng thời gian đã chọn, hiển thị dưới dạng thay đổi ròng với số cộng/trừ thô bên dưới.
- /status tickets: số ticket đã mở, số ticket đã đóng và số ticket đang mở ngay lúc này. Đây là phần phân tích ticket mà quản trị viên Discord hỏi nhiều nhất: ticket có đang chất đống không, hay đội ngũ đang theo kịp.
- /status sales: số hóa đơn và tổng giá trị. Tổng là phép cộng thông thường, không quy đổi tiền tệ, vì hóa đơn có thể được xuất bằng nhiều loại tiền và quy đổi sẽ đồng nghĩa với việc phải đoán tỷ giá.
- /status community: số lượt đánh giá và khối lượng tin nhắn, để xem mức độ hoạt động chung thay vì hỗ trợ hay doanh thu.
- /status all: mọi trường ở trên trong một embed, dùng cho bản tóm tắt sáng thứ Hai.
Biểu đồ được vẽ phía máy chủ và đính kèm dưới dạng hình ảnh. Nếu việc hiển thị biểu đồ thất bại vì bất kỳ lý do gì, lệnh vẫn trả lời bằng các con số dưới dạng văn bản thay vì lỗi hoàn toàn. Số lượng thành viên và tin nhắn chỉ bắt đầu được đếm từ ngày Noxyr tham gia máy chủ, nên một bot được thêm vào tháng trước sẽ không hiển thị lịch sử nhiều năm.
/sales: doanh thu, người mua hàng đầu và kiểu báo cáo
/sales bao quát các thống kê bán hàng mà một bot Discord cần ngoài một con số tổng duy nhất. Lệnh này có ba lệnh con, đều chỉ dành cho quản trị viên, đều có thể trả lời riêng tư hoặc đăng vào kênh với tùy chọn post.
- /sales report: doanh thu trong kỳ, số đơn đã thanh toán, số sản phẩm đã bán, số hóa đơn, phân tích theo trạng thái (Thành công, Đang chờ, Thất bại) và theo phương thức thanh toán, cùng các sản phẩm bán chạy nhất. Các lựa chọn kỳ là 7 ngày qua, 30 ngày qua, 90 ngày qua hoặc toàn bộ thời gian.
- /sales top: bảng xếp hạng người mua, sắp theo số đơn hoặc số tiền đã chi, có thể lọc theo loại tiền tệ, hiển thị tối đa 25 người mua.
- /sales style: đặt màu embed, ảnh banner và ảnh thu nhỏ, tiêu đề tùy chỉnh cho báo cáo và bảng xếp hạng, nội dung chân trang, số lượng mặc định trong bảng xếp hạng, có hiện tên người mua bên cạnh thẻ đề cập hay không, và trạng thái hóa đơn nào được tính là doanh thu. Việc tắt cả ba trạng thái sẽ bị từ chối, vì một báo cáo không bao giờ tính gì là doanh thu thì chẳng ích lợi cho ai.
Cả hai lệnh đều kiểm tra quyền Quản trị viên hoặc vai trò quản trị đã cấu hình trước khi chạy, cùng cơ chế kiểm soát quyền quản trị mà bảng điều khiển dùng.
Trang Tổng quan trên bảng điều khiển hiển thị gì
Trang Tổng quan của bảng điều khiển không phải là cùng một báo cáo với /status. Đây là trang đầu tiên bạn thấy khi vào một máy chủ, và nó tóm tắt phần cửa hàng và hỗ trợ: số danh mục, sản phẩm và voucher đang hoạt động, tổng số hóa đơn, tổng số đánh giá, năm hóa đơn gần nhất và năm đánh giá gần nhất, cùng một danh sách kiểm tra thiết lập cho những gì bạn đã bật nhưng chưa cấu hình xong. Nếu /status và /sales là các báo cáo tại một thời điểm mà bạn lấy theo yêu cầu trong Discord, thì Tổng quan là bản tóm tắt luôn cập nhật mà bạn kiểm tra trên trình duyệt mà không cần phải ngồi trước bàn phím giữa một cuộc trò chuyện.
Đọc cùng những con số từ website của riêng bạn: Server API
Nếu bạn muốn thống kê máy chủ Discord trên website, trang trạng thái hoặc bảng tính của riêng mình, Server API là cầu nối. Nó chỉ đọc, giới hạn trong một máy chủ, và trả về JSON cho cùng dữ liệu mà /status và bảng điều khiển đã theo dõi:
- GET /api/v1/server: tên, biểu tượng, số thành viên, số người online, số lượt boost.
- GET /api/v1/tickets: tổng số, số đang mở và đã đóng, khối lượng trong 7 và 30 ngày, đánh giá trung bình.
- GET /api/v1/activity?days=30: tin nhắn, lượt tham gia và rời đi theo ngày, lùi về tối đa 90 ngày.
- GET /api/v1/invoices: số lượng hóa đơn và doanh thu theo loại tiền tệ và trạng thái.
- GET /api/v1/reviews: đánh giá trung bình, phân bố số sao và các đánh giá công khai mới nhất.
- GET /api/v1/giveaways: số lượng đang diễn ra và đã kết thúc, cùng tổng số lượt tham gia.
Tạo một khóa từ trang API của máy chủ trên bảng điều khiển, gửi nó dưới dạng Bearer token, và mỗi endpoint được kiểm soát bởi phạm vi quyền riêng, nên bạn có thể chia sẻ một khóa chỉ đọc ticket chẳng hạn mà không lộ dữ liệu hóa đơn. Khóa bị giới hạn ở 60 yêu cầu mỗi phút, điều này là quá đủ vì tổng ticket và doanh số không cần được truy vấn nhanh hơn mỗi phút một lần.
Câu hỏi thường gặp
Tôi có cần API để xem phân tích không? Không. /status và /sales hoạt động không cần thiết lập gì, và trang Tổng quan trên bảng điều khiển chỉ cần đăng nhập. API dành cho việc đưa các con số ra ngoài Discord.
/status có tốn phí không? Không. Noxyr không có gói trả phí, nên mọi chế độ xem của /status và /sales đều có sẵn cho mọi máy chủ.
Thành viên có thể xem những thống kê này không? Cả hai lệnh đều yêu cầu quyền Quản trị viên hoặc vai trò quản trị đã cấu hình, nên thành viên thường không thể chạy chúng.
Tại sao tổng doanh số không quy đổi tiền tệ? Hóa đơn có thể được xuất bằng USD, INR, EUR hoặc GBP, và báo cáo cộng theo đúng các loại tiền tệ bạn thực sự đã bán thay vì tự bịa ra tỷ giá.
Xem danh sách lệnh đầy đủ tại /commands, hoặc so sánh việc chạy mọi thứ từ Discord với bảng điều khiển trong Bảng điều khiển so với lệnh. Thêm Noxyr miễn phí để có phân tích, ticket và cửa hàng cùng chạy trên một bot.