Configuration d'Aoede sur ServerPrism

Aoede est un bot musical Discord unique qui diffuse directement depuis Spotify, en utilisant Spotify lui-même comme interface principale. Ce guide couvre la configuration de votre bot Aoede sur ServerPrism.

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

1. Rendez-vous sur le portail des développeurs Discord.
2. Cliquez sur New Application.
3. Donnez un nom à votre application (par exemple, "Aoede Music Bot") 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. C'est la clé secrète de votre bot ; gardez-la en sécurité. Vous en aurez besoin pour votre panneau ServerPrism.
8. Faites défiler jusqu'à Privileged Gateway Intents.
9. Activez le bouton Message Content Intent. Aoede en a besoin pour traiter les liens Spotify et les commandes dans les messages.

Invitez le bot sur votre serveur

1. Dans le portail des développeurs Discord, allez dans l'onglet OAuth2, puis URL Generator.
2. Sous SCOPES, sélectionnez bot.
3. Sous BOT PERMISSIONS, sélectionnez les éléments suivants :
   • Read Messages/View Channels
   • Send Messages
   • Connect
   • Speak
   • Use Voice Activity
4. Copiez l'URL générée en bas de la page.
5. Collez l'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.

Commandez sur ServerPrism

Lorsque vous commandez votre serveur de bot Discord sur ServerPrism :

1. Sélectionnez le produit "Discord Bots".
2. Choisissez Aoede comme runtime de votre bot.
3. Un plan de 1 Go de RAM est généralement suffisant pour Aoede.
4. Sélectionnez votre région de serveur préférée.
5. Terminez le processus de déploiement.

Configurez les variables de démarrage

Une fois votre serveur déployé, vous devez configurer les variables d'environnement du bot. Allez dans l'onglet Startup de votre panneau ServerPrism.

Définissez les variables suivantes :

• BOT_TOKEN : Collez le jeton du bot que vous avez copié depuis le portail des développeurs Discord.
• PREFIX : Le préfixe de commande pour votre bot (par exemple, !). Aoede utilise principalement les liens Spotify directement, mais un préfixe peut être utilisé pour d'autres commandes si elles sont implémentées.
• SPOTIFY_CLIENT_ID : L'ID client de votre application Spotify. Créez une application sur Spotify for Developers pour l'obtenir.
• SPOTIFY_CLIENT_SECRET : Le secret client de votre application Spotify. Également depuis votre application Spotify for Developers.

Référez-vous à l'onglet Startup de votre panneau pour toute autre variable spécifique dont votre bot pourrait avoir besoin.

Premier démarrage

1. Après avoir défini vos variables d'environnement, accédez à l'onglet Console de 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 Spotify, se terminant généralement par un message comme "Aoede is online!" ou une confirmation similaire.
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 que BOT_TOKEN dans votre onglet Startup est exactement le jeton copié depuis le portail des développeurs Discord, sans espaces ou caractères supplémentaires.
• Bot en ligne mais ne répond pas : Assurez-vous d'avoir activé le Message Content Intent dans le portail des développeurs Discord sous les paramètres de votre bot. Vérifiez également que le bot dispose des permissions nécessaires (Connect, Speak, Send Messages) sur votre serveur Discord.
• Problèmes de connexion Spotify : Confirmez que SPOTIFY_CLIENT_ID et SPOTIFY_CLIENT_SECRET sont corrects et proviennent d'une application Spotify valide. Assurez-vous que votre application Spotify a http://localhost:8888/callback comme URI de redirection si cela est requis par le flux d'authentification spécifique du bot (vérifiez la documentation d'Aoede si les problèmes persistent).

Prochaines étapes

Une fois qu'Aoede est en cours d'exécution, vous pouvez commencer à l'utiliser en collant des liens de chansons ou de playlists Spotify directement dans votre canal Discord où le bot est présent. Pour une utilisation plus avancée ou un dépannage, consultez le dépôt GitHub officiel d'Aoede ou sa documentation pour les commandes et fonctionnalités spécifiques.