Un bot d'analyse de serveur Discord transforme les arrivées de membres, les ouvertures de tickets et les paiements de factures en un rapport lisible d'un seul coup d'œil, soit sous forme d'embed Discord, soit sur un tableau de bord web. Noxyr le fait avec deux commandes slash, /status et /sales, une page Vue d'ensemble du tableau de bord, et une API serveur en lecture seule qui expose les mêmes chiffres à votre propre site. Ce guide présente ce que chacune affiche réellement.
/status : statistiques des membres, des tickets et de la communauté
/status est une commande réservée aux administrateurs, avec cinq vues : all, invite, sales, tickets et community. Chaque vue accepte une option days (7, 14 ou 30, 30 par défaut) et renvoie un embed accompagné d'un graphique en courbes. Elle sert donc à la fois de contrôle rapide des chiffres et d'aperçu des tendances.
- /status invite : arrivées et départs du jour, des 7 derniers jours et de la période choisie, affichés sous forme de variation nette, avec les totaux bruts plus et moins en dessous.
- /status tickets : tickets ouverts, tickets fermés et nombre de tickets actuellement ouverts. C'est l'analyse de tickets que les administrateurs Discord demandent le plus souvent : les tickets s'accumulent-ils, ou l'équipe suit-elle le rythme ?
- /status sales : nombre de factures et valeur totale. Le total est une simple somme, sans conversion de devises. Les factures pouvant être émises dans plusieurs devises, les convertir reviendrait à deviner un taux de change.
- /status community : nombre d'avis et volume de messages, pour suivre l'activité générale plutôt que le support ou le chiffre d'affaires.
- /status all : tous les champs ci-dessus dans un seul embed, pour un résumé du lundi matin.
Le graphique est généré côté serveur et joint sous forme d'image. Si la génération du graphique échoue pour une raison quelconque, la commande répond tout de même avec les chiffres en texte, au lieu de tomber en erreur. Les compteurs de membres et de messages ne commencent qu'à partir du jour où Noxyr a rejoint le serveur : un bot ajouté le mois dernier n'affichera donc pas des années d'historique.
/sales : chiffre d'affaires, meilleurs acheteurs et présentation des rapports
/sales couvre les statistiques de vente dont un bot Discord a besoin au-delà d'un simple total. Elle comporte trois sous-commandes, toutes réservées aux administrateurs, et toutes peuvent répondre en privé ou être publiées dans le salon avec l'option post.
- /sales report : chiffre d'affaires de la période, nombre de commandes payées, unités vendues, nombre de factures, répartition par statut (Réussi, En attente, Échoué) et par moyen de paiement, ainsi que les produits les plus vendus. Les périodes proposées sont les 7 derniers jours, les 30 derniers jours, les 90 derniers jours ou depuis toujours.
- /sales top : un classement des acheteurs, trié par nombre de commandes ou par montant dépensé, filtrable par devise, affichant jusqu'à 25 acheteurs.
- /sales style : définit la couleur de l'embed, les images de bannière et de miniature, les titres personnalisés du rapport et du classement, le texte du pied de page, la taille par défaut du classement, l'affichage ou non du nom des acheteurs à côté de la mention, et les statuts de facture qui comptent comme chiffre d'affaires. Désactiver les trois statuts est refusé, car un rapport qui ne compte jamais rien comme chiffre d'affaires n'est utile à personne.
Les deux commandes vérifient la permission Administrateur ou un rôle administrateur configuré avant de s'exécuter. C'est le même contrôle d'accès que celui utilisé par le tableau de bord.
Ce qu'affiche la Vue d'ensemble du tableau de bord
La page Vue d'ensemble du tableau de bord n'est pas le même rapport que /status. C'est la première page que vous voyez pour un serveur, et elle résume la partie boutique et support : nombre de catégories, de produits et de codes promo actifs, total des factures, total des avis, les cinq factures les plus récentes et les cinq avis les plus récents, ainsi qu'une liste de configuration pour tout ce que vous avez activé sans en finir le paramétrage. Là où /status et /sales sont des rapports ponctuels que vous demandez à la demande dans Discord, la Vue d'ensemble est le résumé toujours à jour que vous consultez dans un navigateur, sans avoir besoin d'être devant votre clavier au milieu d'une conversation.
Lire les mêmes chiffres depuis votre propre site : l'API serveur
Si vous voulez afficher les statistiques de votre serveur Discord sur votre propre site, une page de statut ou un tableur, l'API serveur fait le lien. Elle est en lecture seule, limitée à un seul serveur, et renvoie du JSON pour les mêmes données que /status et le tableau de bord suivent déjà :
- GET /api/v1/server : nom, icône, nombre de membres, nombre de membres en ligne, boosts.
- GET /api/v1/tickets : totaux, nombre de tickets ouverts et fermés, volume sur 7 et 30 jours, note moyenne.
- GET /api/v1/activity?days=30 : messages, arrivées et départs par jour, jusqu'à 90 jours en arrière.
- GET /api/v1/invoices : nombre de factures et chiffre d'affaires par devise et par statut.
- GET /api/v1/reviews : note moyenne, répartition par étoiles et derniers avis publics.
- GET /api/v1/giveaways : nombre de concours actifs et terminés, et total des participations.
Générez une clé depuis la page API du serveur sur le tableau de bord, envoyez-la comme jeton Bearer, et chaque point d'accès est contrôlé par son propre périmètre. Vous pouvez ainsi partager une clé qui ne lit que les tickets, par exemple, sans exposer les données de facturation. Les clés sont limitées à 60 requêtes par minute, ce qui suffit largement, car les totaux de tickets et de ventes n'ont pas besoin d'être interrogés plus d'une fois par minute.
Questions fréquentes
Ai-je besoin de l'API pour voir les analyses ? Non. /status et /sales fonctionnent sans aucune configuration, et la page Vue d'ensemble du tableau de bord ne nécessite qu'une connexion. L'API sert à transférer les chiffres vers un outil extérieur à Discord.
Le /status coûte-t-il quelque chose ? Non. Noxyr n'a pas d'offre payante : chaque vue de /status et de /sales est disponible pour tous les serveurs.
Les membres peuvent-ils voir ces statistiques ? Les deux commandes exigent la permission Administrateur ou un rôle administrateur configuré. Les membres ordinaires ne peuvent donc pas les exécuter.
Pourquoi le total des ventes ne convertit-il pas les devises ? Les factures peuvent être émises en USD, INR, EUR ou GBP. Le rapport additionne les devises réellement vendues, plutôt que d'inventer un taux de change.
Consultez la liste complète des commandes sur /commands, ou comparez les actions depuis Discord et depuis le tableau de bord dans Tableau de bord ou commandes. Ajoutez Noxyr gratuitement pour disposer des analyses, des tickets et d'une boutique sur un seul bot.