Salons de statistiques

Les salons de statistiques permettent d’afficher en temps réel différentes informations sur votre serveur (membres, bots, rôles, salons…), directement dans des salons vocaux ou des catégories.

Apparence des salons de statistiques

Salons vocaux

Aperçu d'un salon vocal de statistiques
Aperçu d'un salon vocal de statistiques

Catégorie

Aperçu d'une catégorie de statistiques
Aperçu d'une catégorie de statistiques

Les salons de statistiques s'actualisent toutes les 15 minutes. Les serveurs premium <:icon_premium_:1096140508625125417> ont une actualisation de 10 minutes.

Créer un salon de statistiques

Créer un salon

Pour créer un salon de statistique, il vous suffira d'aller dans le menu Salons de statistiques de la commande /config. Si vous n'avez pas d'autres salons de statistiques configurés, DraftBot vous proposera de cliquer sur deux boutons :

  • Configuration rapide
  • Configuration avancée

Si vous choisissez la Catégorie comme type de salon et que vous souhaitez prendre une catégorie existante, vous devrez remettre à DraftBot l'identifiant de cette catégorie.

Une fois la méthode choisie (rapide ou avancée), vous devrez sélectionner la cible du compteur (membres, bots, rôle spécifique, etc.).

Lorsque vous avez créé votre salon, vous pourrez alors configurer vos salons.

Personnaliser le format du nom

Salon

Aperçu d'un salon vocal de statistiques
Aperçu d'un salon vocal de statistiques

Vous pouvez modifier le nom d'un salon vocal en mettant ce que vous souhaitez, à condition qu'il soit mis avant le " : ".

Catégorie

Aperçu d'une catégorie de statistiques
Aperçu d'une catégorie de statistiques

Vous pouvez modifier le nom d'une catégorie en mettant ce que vous souhaitez, à condition qu'il soit mis avant le " – ".

Faites bien attention à ne pas toucher au compteur de membres, sinon vous serez obligé de refaire une nouvelle configuration.

API personnalisée

Cette fonctionnalité est réservée aux serveurs premium <:icon_premium_:1096140508625125417>.

La cible API personnalisée permet d’afficher une statistique provenant d’un service externe, via une requête HTTP/HTTPS vers une API web.

Pour configurer une API personnalisée, il faut tout d'abord renseigner :

  • L'URL de l'API : par exemple https://api.exemple.com/stats
  • Chemin vers la valeur numérique : par exemple dataCount

Cela peut servir par exemple à afficher :

  • Le nombre d’utilisateurs inscrits sur un site
  • Toute autre valeur numérique accessible via une API

Quelques petits points à savoir / faire attention :

  • L’API doit être accessible via une requête HTTP GET. Les identifiants peuvent être inclus directement dans l’URL, mais les headers personnalisés ne sont pas pris en charge à ce jour.
  • Vérifiez que la réponse contient bien une valeur numérique.
  • Un délai de 10 minutes est imposé entre chaque actualisation.

Format

L’API doit renvoyer un objet JSON contenant une valeur exploitable.

Exemple de réponse valide

{"count": 42}

Dans cet exemple, DraftBot affichera 42 dans le salon de statistiques.

La valeur doit être un nombre et les chaînes de caractères ou objets complexes ne sont pas pris en charge.

Exemple concret

Si votre API est accessible à l’adresse :

https://api.draftbot.fr/base/stats

et renvoie :

{"guilds":1008140,"users":53253590}

Le salon pourra afficher par exemple :

👤 Serveurs : 1008140