Un bot di analytics per server Discord trasforma i dati grezzi di ingressi dei membri, ticket aperti e fatture pagate in un report che puoi leggere con un solo sguardo, sotto forma di embed su Discord o di dashboard web. Noxyr lo fa con due comandi slash, /status e /sales, una pagina Panoramica nella dashboard e un'API del server di sola lettura che espone gli stessi numeri al tuo sito. Questa guida spiega cosa mostra davvero ciascuno di essi.
/status: statistiche su membri, ticket e community
/status è un comando riservato agli amministratori con cinque viste: all, invite, sales, tickets e community. Ogni vista accetta un'opzione days (7, 14 o 30, predefinito 30) e restituisce un embed con un grafico a linee allegato, quindi funziona sia come controllo rapido dei numeri sia come analisi dell'andamento.
- /status invite: ingressi e uscite di oggi, degli ultimi 7 giorni e del periodo scelto, mostrati come variazione netta con sotto i conteggi grezzi di aggiunte e rimozioni.
- /status tickets: ticket aperti, ticket chiusi e quanti ne sono aperti in questo momento. Sono le analytics dei ticket che gli amministratori Discord chiedono più spesso: i ticket si stanno accumulando, o il team tiene il passo?
- /status sales: numero di fatture e valore totale. Il totale è una semplice somma, non una conversione di valuta, perché le fatture possono essere emesse in più valute e convertirle significherebbe indovinare un tasso di cambio.
- /status community: numero di recensioni e volume di messaggi, per una lettura generale dell'attività piuttosto che del supporto o dei ricavi.
- /status all: tutti i campi sopra in un unico embed, per un riepilogo del lunedì mattina.
Il grafico viene generato sul server e allegato come immagine. Se per qualsiasi motivo la generazione del grafico fallisce, il comando risponde comunque con i numeri in forma testuale invece di fallire del tutto. I conteggi di membri e messaggi iniziano a contare solo dal giorno in cui Noxyr è entrato nel server, quindi un bot aggiunto il mese scorso non mostrerà anni di storico.
/sales: ricavi, migliori acquirenti e stile dei report
/sales copre le statistiche di vendita che un bot Discord deve offrire oltre a un unico totale. Ha tre sottocomandi, tutti riservati agli amministratori, tutti con risposta privata oppure pubblicabili nel canale con l'opzione post.
- /sales report: ricavi del periodo, numero di ordini pagati, unità vendute, numero di fatture, suddivisione per stato (Riuscito, In attesa, Fallito) e per metodo di pagamento, più i prodotti migliori. Le scelte di periodo sono ultimi 7 giorni, ultimi 30 giorni, ultimi 90 giorni o tutto il tempo.
- /sales top: una classifica degli acquirenti, ordinata per numero di ordini o per importo speso, filtrabile per valuta, con un massimo di 25 acquirenti.
- /sales style: imposta il colore dell'embed, le immagini del banner e della miniatura, titoli personalizzati per il report e la classifica, il testo del piè di pagina, la dimensione predefinita della classifica, se mostrare i nomi degli acquirenti accanto alla menzione e quali stati delle fatture contano come ricavi. Disattivare tutti e tre gli stati viene rifiutato, perché un report che non considera mai nulla come ricavo non serve a nessuno.
Entrambi i comandi verificano il permesso Amministratore o un ruolo admin configurato prima di essere eseguiti, lo stesso controllo di accesso usato dalla dashboard.
Cosa mostra la Panoramica della dashboard
La pagina Panoramica della dashboard non è lo stesso report di /status. È la prima pagina che vedi per un server e riassume il lato negozio e supporto: numero di categorie, prodotti e buoni attivi, fatture totali, recensioni totali, le cinque fatture più recenti e le cinque recensioni più recenti, più una checklist di configurazione per tutto ciò che hai attivato ma non ancora completato. Mentre /status e /sales sono report istantanei che richiami su Discord quando servono, la Panoramica è il riepilogo sempre aggiornato che controlli dal browser senza doverti trovare davanti alla tastiera nel mezzo di una conversazione.
Leggere gli stessi numeri dal tuo sito: l'API del server
Se vuoi le statistiche del server Discord sul tuo sito, su una pagina di stato o in un foglio di calcolo, l'API del server è il ponte. È di sola lettura, limitata a un solo server, e restituisce JSON per gli stessi dati che /status e la dashboard già tracciano:
- GET /api/v1/server: nome, icona, numero di membri, numero di online, boost.
- GET /api/v1/tickets: totali, conteggi di aperti e chiusi, volume degli ultimi 7 e 30 giorni, valutazione media.
- GET /api/v1/activity?days=30: messaggi giornalieri, ingressi e uscite, fino a 90 giorni indietro.
- GET /api/v1/invoices: numero di fatture e ricavi per valuta e per stato.
- GET /api/v1/reviews: valutazione media, distribuzione delle stelle e le ultime recensioni pubbliche.
- GET /api/v1/giveaways: conteggi di giveaway attivi e conclusi e numero totale di partecipazioni.
Genera una chiave dalla pagina API del server nella dashboard, inviala come token Bearer, e ogni endpoint è protetto dal proprio scope, così puoi condividere una chiave che legge solo i ticket, ad esempio, senza esporre i dati delle fatture. Le chiavi sono limitate a 60 richieste al minuto, più che sufficienti, dato che i totali di ticket e vendite non hanno bisogno di essere interrogati più di una volta al minuto.
Domande frequenti
Ho bisogno dell'API per vedere le analytics? No. /status e /sales funzionano senza alcuna configurazione, e la pagina Panoramica della dashboard richiede solo l'accesso. L'API serve per portare i numeri in qualcosa di esterno a Discord.
/status ha un costo? No. Noxyr non ha un piano a pagamento, quindi ogni vista di /status e /sales è disponibile per ogni server.
I membri possono vedere queste statistiche? Entrambi i comandi richiedono il permesso Amministratore o un ruolo admin configurato, quindi i membri normali non possono eseguirli.
Perché il totale delle vendite non converte le valute? Le fatture possono essere emesse in USD, INR, EUR o GBP, e il report somma le valute in cui hai effettivamente venduto, invece di inventare un tasso di cambio.
Trovi l'elenco completo dei comandi su /commands, oppure confronta l'esecuzione dei comandi da Discord con la dashboard in Dashboard vs. comandi. Aggiungi Noxyr gratis per avere analytics, ticket e uno shop gestiti da un unico bot.