Bot analityki serwera na Discordzie zamienia surowe dane o dołączeniach członków, otwartych ticketach i opłaconych fakturach w raport, który można odczytać jednym spojrzeniem - jako embed na Discordzie albo na panelu internetowym. Noxyr robi to za pomocą dwóch komend z ukośnikiem, /status i /sales, strony Przegląd w panelu oraz API serwera tylko do odczytu, które udostępnia te same liczby na twojej stronie. Ten przewodnik opisuje, co dokładnie pokazuje każde z nich.
/status: statystyki członków, ticketów i społeczności
/status to komenda dostępna tylko dla administratorów, z pięcioma widokami: all, invite, sales, tickets i community. Każdy widok przyjmuje opcję days (7, 14 lub 30, domyślnie 30) i zwraca embed z dołączonym wykresem liniowym, więc działa zarówno jako szybkie sprawdzenie liczb, jak i widok trendu.
- /status invite: dołączenia i wyjścia z dzisiaj, z ostatnich 7 dni i wybranego okresu, pokazane jako zmiana netto z surowymi liczbami plusów i minusów pod spodem.
- /status tickets: otwarte tickety, zamknięte tickety i ile jest teraz otwartych. To analityka ticketów, o którą administratorzy Discorda pytają najczęściej: czy tickety się piętrzą, czy zespół nadąża.
- /status sales: liczba faktur i łączna wartość. Suma jest zwykłym dodawaniem, bez przeliczania walut, bo faktury mogą być wystawiane w więcej niż jednej walucie, a przeliczanie oznaczałoby zgadywanie kursu wymiany.
- /status community: liczba recenzji i wolumen wiadomości, do oceny ogólnej aktywności, a nie wsparcia czy przychodów.
- /status all: wszystkie powyższe pola w jednym embedzie, do poniedziałkowego podsumowania.
Wykres jest rysowany po stronie serwera i dołączany jako obrazek. Jeśli renderowanie wykresu się nie powiedzie z jakiegokolwiek powodu, komenda i tak odpowie liczbami w formie tekstu zamiast całkowicie się wysypać. Liczenie członków i wiadomości zaczyna się dopiero od dnia, w którym Noxyr dołączył do serwera, więc bot dodany w zeszłym miesiącu nie pokaże lat historii.
/sales: przychody, najlepsi kupujący i stylizacja raportów
/sales obejmuje statystyki sprzedaży, których bot Discorda potrzebuje ponad pojedynczą sumę. Ma trzy podkomendy, wszystkie dostępne tylko dla administratorów, każda może być odpowiedzią prywatną albo publikowana na kanale z opcją post.
- /sales report: przychód za okres, liczba opłaconych zamówień, sprzedane sztuki, liczba faktur, podział według statusu (Successful, Pending, Failed) i według metody płatności, a także najlepiej sprzedające się produkty. Dostępne okresy to ostatnie 7 dni, ostatnie 30 dni, ostatnie 90 dni lub cały czas.
- /sales top: ranking kupujących, sortowany według liczby zamówień lub wydanej kwoty, z filtrem według waluty, pokazujący do 25 kupujących.
- /sales style: ustawia kolor embedu, obrazki banera i miniatury, własne tytuły raportu i rankingu, tekst stopki, domyślny rozmiar rankingu, to czy nazwy kupujących pokazują się obok wzmianki oraz które statusy faktur liczą się jako przychód. Wyłączenie wszystkich trzech statusów jest odrzucane, bo raport, który nigdy nic nie liczy jako przychód, nikomu się nie przyda.
Obie komendy sprawdzają przed uruchomieniem uprawnienie Administrator lub skonfigurowaną rolę administracyjną - ta sama bramka dostępu, której używa panel.
Co pokazuje Przegląd w panelu
Strona Przegląd w panelu nie jest tym samym raportem co /status. To pierwsza strona, na którą trafiasz dla serwera, i podsumowuje część sklepową oraz wsparcie: liczbę kategorii, produktów i aktywnych voucherów, łączną liczbę faktur, łączną liczbę recenzji, pięć ostatnich faktur i pięć ostatnich recenzji, a także listę kontrolną konfiguracji dla wszystkiego, co włączyłeś, ale jeszcze nie dokończyłeś ustawiać. Podczas gdy /status i /sales to raporty z konkretnego momentu, które pobierasz na żądanie na Discordzie, Przegląd to zawsze aktualne podsumowanie, które sprawdzasz w przeglądarce, bez konieczności siedzenia przy klawiaturze w trakcie rozmowy.
Odczyt tych samych liczb z własnej strony: API serwera
Jeśli chcesz mieć statystyki serwera Discord na własnej stronie, stronie statusu lub w arkuszu, most stanowi API serwera. Jest tylko do odczytu, ograniczone do jednego serwera i zwraca JSON z tymi samymi danymi, które już śledzą /status i panel:
- GET /api/v1/server: nazwa, ikona, liczba członków, liczba online, boosty.
- GET /api/v1/tickets: sumy, liczba otwartych i zamkniętych, wolumen z 7 i 30 dni, średnia ocena.
- GET /api/v1/activity?days=30: dzienne wiadomości, dołączenia i wyjścia, do 90 dni wstecz.
- GET /api/v1/invoices: liczba faktur i przychód według waluty i statusu.
- GET /api/v1/reviews: średnia ocena, rozkład gwiazdek i najnowsze publiczne recenzje.
- GET /api/v1/giveaways: liczba aktywnych i zakończonych giveaway oraz łączna liczba wpisów.
Wygeneruj klucz na stronie API serwera w panelu, wyślij go jako token Bearer, a każdy endpoint jest objęty własnym zakresem uprawnień, więc możesz udostępnić klucz, który czyta np. tylko tickety, bez ujawniania danych o fakturach. Klucze są ograniczone do 60 żądań na minutę, co w zupełności wystarcza, bo sumy ticketów i sprzedaży nie muszą być odpytywane częściej niż raz na minutę.
Najczęstsze pytania
Czy potrzebuję API, by widzieć analitykę? Nie. /status i /sales działają bez żadnej konfiguracji, a strona Przegląd w panelu wymaga tylko zalogowania. API służy do przenoszenia liczb do czegoś poza Discordem.
Czy /status kosztuje? Nie. Noxyr nie ma planu premium, więc każdy widok /status i /sales jest dostępny dla każdego serwera.
Czy członkowie mogą widzieć te statystyki? Obie komendy wymagają uprawnienia Administrator lub skonfigurowanej roli administracyjnej, więc zwykli członkowie nie mogą ich uruchomić.
Dlaczego suma sprzedaży nie przelicza walut? Faktury mogą być wystawiane w USD, INR, EUR lub GBP, a raport sumuje te waluty, w których faktycznie sprzedawałeś, zamiast wymyślać kurs wymiany.
Pełna lista komend znajduje się pod adresem /commands, a porównanie działań z poziomu Discorda i panelu znajdziesz w artykule Panel a komendy. Dodaj Noxyr za darmo, by mieć analitykę, tickety i sklep na jednym bocie.