Bot pro analytiku serveru na Discordu promění surová data o připojených členech, otevřených tiketech a zaplacených fakturách v přehled, který přečtete na první pohled, a to buď jako embed na Discordu, nebo na webovém dashboardu. Noxyr to dělá dvěma slash příkazy, /status a /sales, stránkou Přehled na dashboardu a veřejným serverovým API, které stejná čísla zpřístupní na vašem vlastním webu. Tento návod popisuje, co každý z nich skutečně ukazuje.
/status: statistiky členů, tiketů a komunity
/status je příkaz jen pro administrátory s pěti pohledy: all, invite, sales, tickets a community. Každý pohled přijímá volbu days (7, 14 nebo 30, výchozí 30) a vrací embed s připojeným spojnicovým grafem, takže funguje jak pro rychlou kontrolu čísel, tak pro přehled trendu.
- /status invite: připojení a odchody za dnešek, posledních 7 dní a zvolené období, zobrazené jako čistá změna se surovými počty plus a minus pod ní.
- /status tickets: otevřené tikety, zavřené tikety a kolik jich je právě teď otevřených. Tohle je analytika tiketů, o kterou se administrátoři Discordu ptají nejčastěji: kupí se tikety, nebo tým stíhá?
- /status sales: počet faktur a jejich celková hodnota. Součet je prostý, bez přepočtu měn, protože faktury lze vystavovat ve více měnách a jejich přepočítávání by znamenalo odhadovat směnný kurz.
- /status community: počet recenzí a objem zpráv, pro přehled celkové aktivity spíš než podpory nebo tržeb.
- /status all: všechna pole výše v jednom embedu pro pondělní ranní shrnutí.
Graf se vykresluje na serveru a připojí se jako obrázek. Pokud se vykreslení grafu z jakéhokoli důvodu nepovede, příkaz přesto odpoví čísly v textu a nezhroutí se. Počty členů a zpráv se začnou počítat až od dne, kdy se Noxyr připojil k serveru, takže bot přidaný před měsícem nezobrazí roky historie.
/sales: tržby, nejlepší kupující a styl reportů
/sales pokrývá prodejní statistiky, které bot na Discordu potřebuje nad rámec jednoho celkového čísla. Má tři podpříkazy, všechny jen pro administrátory, všechny lze odpovědět soukromě nebo zveřejnit do kanálu volbou post.
- /sales report: tržby za období, počet zaplacených objednávek, prodaných kusů, počet faktur, rozpad podle stavu (Úspěšné, Čekající, Neúspěšné) a podle způsobu platby, plus nejprodávanější produkty. Na výběr jsou poslední 7 dní, poslední 30 dní, poslední 90 dní nebo celé období.
- /sales top: žebříček kupujících seřazený podle počtu objednávek nebo utracené částky, filtrovatelný podle měny, zobrazuje až 25 kupujících.
- /sales style: nastavuje barvu embedu, obrázky banneru a miniatury, vlastní nadpisy reportu a žebříčku, text patičky, výchozí velikost žebříčku, zda se jména kupujících zobrazují vedle zmínky, a které stavy faktur se počítají jako tržby. Vypnutí všech tří stavů se odmítne, protože report, který nic nepočítá jako tržbu, není nikomu k užitku.
Oba příkazy před spuštěním kontrolují oprávnění Administrátor nebo nastavenou roli správce, stejnou bránu pro administrátory jako dashboard.
Co ukazuje Přehled na dashboardu
Stránka Přehled na dashboardu není stejný report jako /status. Je to první stránka, na kterou se u serveru dostanete, a shrnuje část obchodu a podpory: počty kategorií, produktů a aktivních voucherů, celkový počet faktur, celkový počet recenzí, pět nejnovějších faktur a pět nejnovějších recenzí a také kontrolní seznam nastavení pro všechno, co jste zapnuli, ale ještě nedokončili. Zatímco /status a /sales jsou reporty pro konkrétní okamžik, které vyvoláváte na Discordu, Přehled je vždy aktuální souhrn, který zkontrolujete v prohlížeči, aniž byste uprostřed rozhovoru museli sedět u klávesnice.
Čtení stejných čísel z vlastního webu: Server API
Pokud chcete statistiky serveru na Discordu na vlastním webu, ve stavové stránce nebo v tabulce, je most Server API. Je pouze pro čtení, omezený na jeden server a vrací JSON pro stejná data, která už sledují /status a dashboard:
- GET /api/v1/server: název, ikona, počet členů, počet online, boosty.
- GET /api/v1/tickets: součty, počty otevřených a zavřených, objem za 7 a 30 dní, průměrné hodnocení.
- GET /api/v1/activity?days=30: denní zprávy, připojení a odchody, až 90 dní zpětně.
- GET /api/v1/invoices: počty faktur a tržby podle měny a stavu.
- GET /api/v1/reviews: průměrné hodnocení, rozpad podle hvězdiček a nejnovější veřejné recenze.
- GET /api/v1/giveaways: počty aktivních a ukončených soutěží a celkový počet účastí.
Klíč vygenerujete na stránce API serveru na dashboardu, pošlete ho jako Bearer token a každý endpoint je omezen vlastním oprávněním (scope), takže můžete sdílet klíč, který čte jen tikety, a neodhalíte tak data o fakturách. Klíče jsou omezeny na 60 požadavků za minutu, což stačí, protože součty tiketů a prodejů nepotřebují dotazování častěji než jednou za minutu.
Časté otázky
Potřebuju API, abych viděl analytiku? Ne. /status a /sales fungují bez jakéhokoli nastavení a stránka Přehled na dashboardu potřebuje jen přihlášení. API slouží k tomu, abyste čísla dostali někam mimo Discord.
Stojí /status něco? Ne. Noxyr nemá prémiovou úroveň, takže každý pohled /status a /sales je dostupný na každém serveru.
Můžou tyto statistiky vidět členové? Oba příkazy vyžadují oprávnění Administrátor nebo nastavenou roli správce, takže běžní členové je spustit nemohou.
Proč součet tržeb nepřepočítává měny? Faktury lze vystavovat v USD, INR, EUR nebo GBP a report sčítá měny, ve kterých jste skutečně prodávali, místo aby si vymýšlel směnný kurz.
Úplný seznam příkazů najdete na stránce /commands, nebo porovnejte spouštění věcí z Discordu a z dashboardu v článku Dashboard versus příkazy. Přidejte Noxyr zdarma a získejte analytiku, tikety a obchod na jednom botovi.