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

⫸ Accéder au panel de DraftBot

Créer un salon

Pour créer un salon de statistiques, il suffit de cliquer sur le bouton "Créer un salon". Vous pouvez ensuite choisir une cible.

Configurer les salons

Lorsque vous décidez de modifier un salon de statistiques, une série de paramètres apparaît. Vous pourrez Modifier ou Supprimer les salons de votre choix.

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 placé 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 placé avant le " – ".

Faites bien attention à ne pas toucher au compteur de membres, sinon vous serez obligé de refaire la 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 points importants à noter :

  • 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