Discord 서버 분석 봇은 멤버 입장, 티켓 열림, 인보이스 결제 같은 원시 데이터를 한눈에 읽을 수 있는 보고서로 바꿉니다. Discord 임베드로 보거나 웹 대시보드에서 볼 수 있습니다. Noxyr는 이 기능을 /status와 /sales 두 개의 슬래시 명령어, 대시보드의 개요 페이지, 그리고 같은 숫자를 자체 사이트에 보여 줄 수 있는 읽기 전용 서버 API로 제공합니다. 이 가이드에서는 각각이 실제로 무엇을 보여 주는지 설명합니다.
/status: 멤버, 티켓, 커뮤니티 통계
/status는 관리자만 쓸 수 있는 명령어이며 다섯 가지 보기를 제공합니다. all, invite, sales, tickets, community입니다. 모든 보기는 days 옵션(7, 14, 30 중 선택, 기본값 30)을 받으며, 꺾은선 차트가 첨부된 임베드를 반환합니다. 그래서 빠르게 숫자를 확인할 때도, 추세를 볼 때도 쓸 수 있습니다.
- /status invite: 오늘, 최근 7일, 선택한 기간의 입장과 퇴장. 순증감을 먼저 보여 주고, 그 아래 원래의 증가 및 감소 수를 표시합니다.
- /status tickets: 열린 티켓 수, 닫힌 티켓 수, 지금 열려 있는 수. Discord 관리자들이 가장 많이 묻는 티켓 분석입니다. 티켓이 쌓이고 있는지, 아니면 팀이 따라가고 있는지를 알려 줍니다.
- /status sales: 인보이스 수와 총액. 합계는 단순 합산이며 통화 환산은 하지 않습니다. 인보이스가 두 개 이상의 통화로 발행될 수 있고, 환산하려면 환율을 추측해야 하기 때문입니다.
- /status community: 리뷰 수와 메시지량. 지원이나 매출이 아니라 전반적인 활동을 파악하는 용도입니다.
- /status all: 위의 모든 항목을 하나의 임베드에 담습니다. 월요일 아침 요약용입니다.
차트는 서버 쪽에서 그려져 이미지로 첨부됩니다. 어떤 이유로든 차트 렌더링이 실패해도 명령어는 실패하지 않고, 숫자를 텍스트로 답합니다. 멤버 수와 메시지 수는 Noxyr가 서버에 들어온 날부터 집계하므로, 지난달에 추가한 봇은 몇 년치 기록을 보여 주지 않습니다.
/sales: 매출, 상위 구매자, 보고서 스타일
/sales는 단일 합계 이상으로 Discord 봇에 필요한 판매 통계를 다룹니다. 하위 명령어 세 개가 있으며, 모두 관리자만 쓸 수 있습니다. 모두 비공개로 응답하거나, post 옵션을 사용해 채널에 게시할 수 있습니다.
- /sales report: 기간의 매출, 결제된 주문 수, 판매 수량, 인보이스 수, 상태별(Successful, Pending, Failed) 및 결제 수단별 분류, 그리고 상위 상품. 기간은 최근 7일, 최근 30일, 최근 90일, 전체 기간 중에서 고를 수 있습니다.
- /sales top: 구매자 순위표. 주문 수 또는 총 결제액 기준으로 정렬하며, 통화별로 필터링할 수 있고, 최대 25명의 구매자를 보여 줍니다.
- /sales style: 임베드 색상, 배너와 썸네일 이미지, 보고서와 순위표의 맞춤 제목, 바닥글 텍스트, 기본 순위표 크기, 멘션 옆에 구매자 이름 표시 여부, 그리고 어떤 인보이스 상태를 매출로 칠지 설정합니다. 세 가지 상태를 모두 끄는 것은 거부됩니다. 아무것도 매출로 집계하지 않는 보고서는 누구에게도 쓸모가 없기 때문입니다.
두 명령어 모두 실행 전에 관리자 권한이나 설정된 관리자 역할을 확인합니다. 대시보드가 사용하는 것과 같은 관리자 제한입니다.
대시보드 개요에 표시되는 내용
대시보드의 개요 페이지는 /status와 같은 보고서가 아닙니다. 서버에 들어갔을 때 처음 보이는 페이지이며, 샵과 지원 쪽을 요약합니다. 카테고리, 상품, 활성 바우처 수, 총 인보이스 수, 총 리뷰 수, 최근 인보이스 다섯 건과 최근 리뷰 다섯 건, 그리고 켜 두었지만 설정을 끝내지 않은 항목의 설정 체크리스트가 있습니다. /status와 /sales가 Discord에서 필요할 때 꺼내 보는 특정 시점의 보고서라면, 개요는 대화 중에 키보드 앞에 있지 않아도 브라우저에서 언제든 확인할 수 있는 항상 최신 요약입니다.
자체 웹사이트에서 같은 숫자 읽기: 서버 API
자체 사이트, 상태 페이지, 스프레드시트에 Discord 서버 통계를 보여 주고 싶다면 서버 API가 연결 고리입니다. 읽기 전용이며, 서버 하나에 한정되고, /status와 대시보드가 이미 추적하는 데이터를 JSON으로 반환합니다.
- GET /api/v1/server: 이름, 아이콘, 멤버 수, 온라인 수, 부스트.
- GET /api/v1/tickets: 총계, 열린 수와 닫힌 수, 7일 및 30일 건수, 평균 평점.
- GET /api/v1/activity?days=30: 일별 메시지, 입장, 퇴장. 최대 90일 전까지 조회할 수 있습니다.
- GET /api/v1/invoices: 인보이스 수와 통화 및 상태별 매출.
- GET /api/v1/reviews: 평균 평점, 별점 분포, 최신 공개 리뷰.
- GET /api/v1/giveaways: 진행 중과 종료된 이벤트 수, 총 참여 수.
대시보드의 서버 API 페이지에서 키를 생성하고 Bearer 토큰으로 보내세요. 각 엔드포인트는 자체 권한 범위로 제한되므로, 예를 들어 인보이스 데이터를 노출하지 않고 티켓만 읽을 수 있는 키를 공유할 수 있습니다. 키당 분당 요청 수는 60회로 제한됩니다. 티켓과 판매 총계는 1분에 한 번보다 자주 조회할 필요가 없으므로 이 정도면 충분합니다.
자주 묻는 질문
분석을 보려면 API가 필요한가요? 아니요. /status와 /sales는 설정 없이 작동하고, 대시보드 개요 페이지는 로그인만 하면 됩니다. API는 Discord 밖의 무언가로 숫자를 가져오기 위한 것입니다.
/status는 비용이 드나요? 아니요. Noxyr에는 유료 등급이 없으므로, /status와 /sales의 모든 보기는 모든 서버에서 쓸 수 있습니다.
멤버도 이 통계를 볼 수 있나요? 두 명령어 모두 관리자 권한이나 설정된 관리자 역할이 필요하므로, 일반 멤버는 실행할 수 없습니다.
판매 합계는 왜 통화를 환산하지 않나요? 인보이스는 USD, INR, EUR, GBP로 발행될 수 있으며, 보고서는 환율을 지어내는 대신 실제로 판매한 통화를 그대로 합산합니다.
전체 명령어 목록은 /commands에서 확인하고, Discord에서 실행하는 것과 대시보드를 비교하려면 대시보드 vs 명령어를 읽어 보세요. Noxyr를 무료로 추가하면 하나의 봇에서 분석, 티켓, 샵을 함께 운영할 수 있습니다.