Créer le token de votre bot

Votre bot a besoin de son propre compte Discord. Ce compte se crée sur le portail développeur de Discord, et il donne un token : une longue suite de caractères qui sert de mot de passe au bot.

Ce guide vous montre comment le créer. Les boutons sont nommés comme le portail les affiche en français ; s'il s'affiche en anglais chez vous, leur nom anglais est indiqué entre parenthèses.

Étape 1 : créer l'application

1. Ouvrez le portail développeur de Discord dans votre navigateur. Connectez-vous avec votre compte Discord si on vous le demande.
2. Cliquez sur Nouvelle application (New Application), en haut à droite.
3. Donnez-lui le nom de votre bot (vous pourrez le changer plus tard), acceptez les conditions et validez.

Étape 2 : le nom et la photo du bot

Vous arrivez sur la page de votre application. Dans le menu de gauche, ouvrez l'onglet Bot (sur téléphone, ce menu s'ouvre avec le bouton ☰ en haut à gauche).

C'est dans l'onglet Bot que vous choisissez le nom et la photo que vos membres verront. Ceux de la première page, Informations générales (General Information), n'apparaissent que sur la page d'invitation du bot.

Étape 3 : autoriser le bot à voir votre serveur

Toujours dans l'onglet Bot, descendez jusqu'aux interrupteurs (repère 1 sur l'image) :

• laissez Bot public (Public Bot) activé ;
• laissez Requiert un code d'accès OAuth2 (Requires OAuth2 Code Grant) désactivé : sinon, personne ne pourra inviter le bot ;
• laissez Obfuscation des salons privés (Private Channel Obfuscation) désactivé ;
• sous Privileged Gateway Intents (qui garde son nom anglais), activez les trois : Presence Intent, Server Members Intent et Message Content Intent. Sans eux, le bot ne voit ni les membres ni les messages, et la plupart de ses fonctions ne marchent pas.

Cliquez ensuite sur Enregistrer les modifications (Save Changes, repère 2).

Étape 4 : obtenir le token

1. Dans l'onglet Bot, sous Token, cliquez sur Réinitialiser le token (Reset Token, repère 3), puis confirmez.
2. Le token s'affiche une seule fois : copiez-le tout de suite.
3. Transmettez-le à l'équipe CrowBots pour qu'elle installe votre bot, comme indiqué lors de votre commande.

C'est terminé : une fois le bot installé, passez à votre code de récupération.

Changer d'application

Si vous créez une nouvelle application pour un bot déjà installé, son token change, et son compte aussi : ajoutez-le à nouveau sur vos serveurs. Ses réglages restent, mais les panneaux que l'ancien compte avait postés (tickets, rolemenus, formulaires, vérification) ne peuvent plus être modifiés par le nouveau.

Pour tout reprendre, exportez tout le bot avant de changer d'application (+export en message privé au bot), puis importez ce fichier une fois le nouveau compte sur vos serveurs : les panneaux qui en ont besoin sont republiés par le nouveau compte. Toutes les étapes : après un changement d'application.

Si vous avez un doute

• Vous avez montré le token à quelqu'un, ou vous l'avez collé quelque part par erreur : cliquez à nouveau sur Réinitialiser le token. L'ancien token ne marche plus aussitôt, ce qui déconnecte votre bot : donnez le nouveau à CrowBots. Si vous avez déjà récupéré votre bot, la commande /changetoken du serveur CrowBots met le nouveau token en place.
• Le bot est en ligne mais ne réagit à rien : vérifiez que les trois intents de l'étape 3 sont bien activés et enregistrés.
• Personne n'arrive à inviter le bot : vérifiez que Requiert un code d'accès OAuth2 est désactivé.