Création d’un compte de Bot¶
Dans le but de travailler avec la bibliothèque et l’API de Discord en général, nous devons d’abord créer un compte de Bot Discord.
Créer un compte de Bot est un processus plutôt simple.
Assurez-vous d’être connecté au site Discord <https://discord.com>.
Allez sur la page application
Cliquez sur le bouton « New Application ».
Donnez un nom à votre application et cliquez sur « Create ».
Créer un bot en cliquant sur « Bot » puis sur « Ajouter un bot ».
Cliquez sur « Oui » pour continuer.
Assurez-vous que Public Bot est coché si vous souhaitez que d’autres personnes puissent inviter votre bot.
Vous devriez également vous assurer que la case Require OAuth2 Code Grant est décochée, sauf si vous développez un service qui le nécessite. Si vous n’êtes pas sûr, laissez la case décochée.
Copiez le token en utilisant le bouton « copier ».
Il ne s’agit pas du token qui figure sur la page des informations générales.
Avertissement
Il est important de noter que ce token est le mot de passe de votre bot. Vous ne devez jamais le partager à qui que ce soit. En le partageant, quelqu’un pourrait se connecter à votre bot et réaliser des actions malveillantes avec celui-ci comme quitter certains serveurs, bannir des membres dans un serveur ou réaliser des mentions everyone avec des intentions malveillantes.
Les possibilités sont infinies donc ne partagez pas ce token.
Si vous avez fait fuiter accidentellement ce token, cliquez sur le bouton « Régénérer » dès que possible. Cela révoque votre ancien token et en génère un nouveau. Vous aurez alors besoins de ce nouveau token pour pouvoir vous connecter.
Et c’est tout. Vous avez maintenant un compte de Bot et vous pouvez vous y connecter avec le jeton d’authentification.
Inviter Son Bot¶
Vous avez créé votre utilisateur Bot mais il n’est pas sur votre serveur.
Si vous voulez inviter votre bot, vous devez créer un lien d’invitation.
Assurez-vous d’être connecté au site Discord <https://discord.com>.
Allez sur la page application
Cliquez sur la page du Bot.
Dépliez l’onglet « OAuth2 » et cliquez sur « URL Generator ».
Sous « scopes », cochez les cases « bot » et « applications.commands ».
Cochez les permissions nécessaires pour le bon fonctionnement de votre bot sous « Bot Permissions ».
Prenez conscience des conséquences en demandant la permission « Administrateur ».
Les propriétaires de bots doivent activer l’authentification à deux facteurs (2FA) pour certaines actions et permissions lorsque leur bots sont ajoutés sur des serveurs où la 2FA est activée à l’échelle du serveur. Consultez la page de support 2FA pour plus d’informations.
Le lien résultant peut être utilisé pour ajouter votre bot à votre serveur. Copiez et collez le lien dans votre navigateur internet, choisissez le serveur sur lequel inviter votre bot et cliquez sur « Autoriser ».
Note
La personne qui souhaite inviter le bot sur un serveur a besoin de la permission « Gérer le serveur » pour le faire.
Si vous voulez générer ce lien dynamiquement avec votre bot pendant son exécution en utilisant l’interface discord.Permissions, vous pouvez utiliser discord.utils.oauth_url().