Comment ajouter un bot sur Discord (guide pour débutants)

L'ajout d'un bot semble se faire en un seul clic, et c'est généralement le cas — mais deux étapes invisibles se déroulent juste après le clic et déterminent si cela fonctionne réellement : l'octroi des autorisations par Discord et la place qu'occupe le rôle du bot dans la hiérarchie de votre serveur. Si vous négligez de vérifier l'un ou l'autre de ces éléments, le bot peut sembler « ajouté » tout en étant incapable d'effectuer la plupart des tâches qu'il est censé accomplir.

En cliquant sur un lien d'invitation officiel, vous accédez à l'écran d'autorisation OAuth2 propre à Discord : vous choisissez à quel(s) de vos serveurs ajouter le bot (seuls ceux pour lesquels votre compte peut autoriser des intégrations sont répertoriés), vous vérifiez les autorisations demandées, puis vous donnez votre accord. Discord ajoute alors le bot en tant que membre et lui attribue un rôle, placé par défaut en bas de votre liste de rôles.

D'un point de vue technique, tous les bots fonctionnent de la même manière : Discord ne propose pas de procédure d'installation spécifique garantissant un bon fonctionnement. Ce qui fait la différence entre une installation qui fonctionne et une qui ne fonctionne pas, ce sont les actions que vous effectuez au cours de ces deux étapes.

1. Ouvrez le lien officiel « Ajouter à Discord » et sélectionnez le serveur souhaité — Discord n'affiche que les serveurs sur lesquels votre compte peut autoriser des intégrations.
2. Vérifiez les autorisations demandées sur l'écran d'autorisation avant de donner votre accord.
3. Retournez sur le serveur et vérifiez que le bot figure bien dans la liste des membres.
4. Ouvrez « Paramètres du serveur » → « Rôles » et placez le rôle du bot au-dessus de tous les rôles de membre, de compte vérifié ou soumis à modération qu’il devra gérer, tout en conservant les rôles de propriétaire et d’administrateur au-dessus de celui-ci.
5. Exécutez une commande inoffensive (comme /help) pour vérifier que le système répond bien avant de procéder à toute autre configuration.

• Autoriser un lien d'invitation provenant d'une source non officielle — commencez toujours par le site web du bot lui-même.
• Laisser le rôle du bot en bas de la liste et ne pas comprendre pourquoi les fonctionnalités liées aux rôles ne fonctionnent pas.
• Placez le rôle du bot au-dessus de vos propres rôles d'administrateur — veillez à ce que les rôles humains privilégiés se situent au-dessus de celui-ci, et non en dessous.
• En partant du principe que l'installation a fonctionné puisque le bot apparaît comme étant en ligne, sans avoir testé de commande ou de fonctionnalité concrète.