Configuration de CorpBot sur ServerPrism

CorpBot est un bot Discord basé sur Python avec diverses fonctionnalités. Ce guide vous expliquera comment configurer votre instance CorpBot sur ServerPrism, de la configuration du portail des développeurs Discord au démarrage initial.

Créez votre bot dans le portail des développeurs Discord

1. Accédez au portail des développeurs Discord.
2. Cliquez sur New Application.
3. Donnez un nom à votre application (par exemple, CorpBot Instance) et cliquez sur Create.
4. Accédez à l'onglet Bot dans la barre latérale gauche.
5. Cliquez sur Add Bot, puis sur Yes, Do It!.
6. Sous TOKEN, cliquez sur Reset Token, puis sur Yes, Do It!.
7. Copiez le jeton affiché. Vous en aurez besoin pour votre panneau ServerPrism.
8. Faites défiler jusqu'à Privileged Gateway Intents.
9. Activez Message Content Intent. CorpBot s'appuie sur la lecture du contenu des messages pour bon nombre de ses commandes.

Invitez le bot sur votre serveur

1. Accédez à l'onglet OAuth2, puis cliquez sur URL Generator.
2. Sous SCOPES, sélectionnez bot.
3. Sous BOT PERMISSIONS, sélectionnez les permissions dont votre bot a besoin. Pour un bot polyvalent comme CorpBot, les choix courants incluent :
   • Read Messages/View Channels
   • Send Messages
   • Embed Links
   • Attach Files
   • Manage Messages (si le bot a des fonctionnalités de modération)
   • Kick Members / Ban Members (si vous prévoyez d'utiliser des commandes de modération)
4. Copiez l'URL générée en bas de la page.
5. Collez cette URL dans votre navigateur et appuyez sur Entrée.
6. Sélectionnez le serveur Discord auquel vous souhaitez ajouter le bot et cliquez sur Authorize.

Commande sur ServerPrism

Vous avez déjà commandé votre produit ServerPrism Discord Bots et sélectionné CorpBot. L'allocation typique de 1 Go de RAM est généralement suffisante pour CorpBot. Votre serveur est déployé dans la région que vous avez choisie, prêt pour la configuration.

Configurez les variables de démarrage

1. Connectez-vous à votre panneau ServerPrism.
2. Accédez à votre instance de serveur CorpBot.
3. Cliquez sur l'onglet Startup.
4. Vous verrez des champs pour les variables d'environnement. Configurez les éléments suivants :
   • BOT_TOKEN : Collez le jeton de bot que vous avez copié depuis le portail des développeurs Discord.
   • PREFIX : Définissez le préfixe de commande pour votre bot (par exemple, !, /, cb!). C'est ce que les utilisateurs taperont avant les commandes.
   • OWNER_ID : Entrez votre ID d'utilisateur Discord. Cela vous accorde des permissions spéciales de niveau propriétaire pour le bot. Pour trouver votre ID d'utilisateur, activez le mode développeur dans Discord (Paramètres utilisateur > Avancé), puis faites un clic droit sur votre nom d'utilisateur et sélectionnez Copy ID.
   • MONGODB_URI : CorpBot peut utiliser MongoDB pour le stockage des données. Si vous prévoyez d'utiliser des fonctionnalités nécessitant des données persistantes, fournissez une chaîne de connexion MongoDB ici. Si vous n'en avez pas, vous pouvez laisser ce champ vide, mais certaines fonctionnalités pourraient ne pas fonctionner. Vous pouvez le configurer plus tard si nécessaire.

Premier démarrage

1. Après avoir configuré vos variables de démarrage, accédez à l'onglet Console dans votre panneau ServerPrism.
2. Cliquez sur le bouton Start.
3. Surveillez la sortie de la console. Un démarrage réussi affichera des messages indiquant que le bot se connecte à Discord et se connecte. Vous devriez voir une sortie similaire à :

   [INFO] CorpBot.py started!
   [INFO] Logged in as CorpBot Instance#1234 (123456789012345678)
   

4. Vérifiez votre serveur Discord. Votre bot devrait apparaître en ligne dans la liste des membres.

Problèmes courants

• Jeton de bot rejeté/Jeton invalide : Vérifiez à nouveau le BOT_TOKEN dans votre onglet Startup. Assurez-vous qu'il n'y a pas d'espaces supplémentaires et que c'est le bon jeton du portail des développeurs Discord.
• Bot en ligne mais ne répond pas aux commandes : Vérifiez que Message Content Intent est activé dans le portail des développeurs Discord sous les paramètres de votre bot. Assurez-vous également que votre variable PREFIX est correctement définie et que vous l'utilisez dans Discord (par exemple, !help). Vérifiez la console pour tout message d'erreur lié à l'analyse des commandes.
• Le bot se déconnecte immédiatement après le démarrage : Examinez la console pour les erreurs de trace Python. Cela indique souvent une mauvaise configuration ou une dépendance manquante, bien que ServerPrism pré-installe les dépendances courantes pour CorpBot. Si vous voyez des erreurs liées à pymongo, assurez-vous que votre MONGODB_URI est correct ou supprimez-le si vous n'avez pas l'intention d'utiliser MongoDB.

Prochaines étapes

Maintenant que votre CorpBot est opérationnel, vous pouvez commencer à utiliser ses commandes sur votre serveur Discord. Référez-vous au dépôt GitHub de CorpBot.py pour une liste des commandes disponibles et des options de configuration supplémentaires. Explorez les fonctionnalités du bot et personnalisez-le selon les besoins de votre serveur.