Discord
Connectez votre propre bot Discord à une application MeDo : publiez dans un canal les alertes de commandes, de réservations et de formulaires, affichez les derniers messages d'un canal, et listez les serveurs et canaux que le bot peut atteindre.
Discord est un connecteur qui fonctionne avec votre propre bot Discord. Vous créez le bot dans le Discord Developer Portal, vous l'ajoutez à votre serveur, puis vous enregistrez son jeton dans MeDo. Les fonctions serveur de l'application appellent ensuite Discord avec ce jeton : elles publient des messages dans des canaux, lisent les messages récents d'un canal, et listent les serveurs et canaux que le bot a rejoints. Les messages apparaissent sous le nom de votre bot. Le bot ne voit que les serveurs auxquels vous l'ajoutez, et ne peut publier que dans les canaux où il dispose de Send Messages.
Ce que vous pouvez construire
- Des alertes de commandes et de réservations. Publiez le numéro de commande, les articles et le total — ou les détails de la réservation — dans un canal d'équipe à chaque nouvelle arrivée.
- Des formulaires transmis à un canal. Envoyez chaque formulaire de contact ou de support dans un canal où votre équipe le prend en charge.
- Un tableau d'annonces. Affichez sur une page publique les derniers messages d'un canal d'annonces.
- Un outil privé de notes de version. Rédigez une mise à jour, prévisualisez-la et publiez-la dans le canal de votre choix, derrière votre propre connexion.
D'autres actions de bot — modifier ses propres messages, ajouter des réactions, épingler, ouvrir des fils, créer des canaux — peuvent être construites à la demande, et certaines exigent des permissions de bot supplémentaires, voir Limites.
Exemples de construction
Copiez l'un de ces exemples dans la zone de saisie. Le premier est le plus petit point de départ utile.
Préparer et connecter
Il vous faut un compte Discord qui peut gérer le serveur dans lequel l'application publiera. La configuration prend quelques minutes et se fait une seule fois par bot.
- Ouvrez le Discord Developer Portal, cliquez sur New Application et donnez-lui un nom. Les membres du serveur voient ce nom sur chaque message publié par l'application.
- Ouvrez Bot, cliquez sur Reset Token, puis copiez le jeton. Discord ne l'affiche qu'une seule fois. Traitez le jeton comme un mot de passe : quiconque le possède peut publier au nom de votre bot. Si l'application doit afficher ou lire les messages d'un canal, activez Message Content Intent sur la même page et enregistrez ; sans cela, Discord renvoie les messages des membres avec un texte vide.
- Ouvrez OAuth2 → URL Generator, sélectionnez le scope bot et les permissions View Channels, Send Messages et Read Message History. Ouvrez le lien généré et ajoutez le bot à votre serveur. Répétez pour chaque serveur que l'application doit utiliser.
- Dans MeDo, enregistrez le jeton dans la configuration Discord. La carte de configuration apparaît généralement juste sous la réponse de MeDo ; vous pouvez aussi ouvrir l'onglet Skill dans la barre latérale gauche de l'éditeur, trouver Discord et le configurer depuis là.
MeDo vérifie le jeton auprès de Discord avant de l'enregistrer. Si la vérification échoue, copiez un nouveau jeton depuis la page Bot et enregistrez à nouveau. Le jeton est stocké pour cette application uniquement et est masqué lorsqu'il est réaffiché ; ne le collez jamais dans le contenu d'une page et ne demandez pas à MeDo de le mettre dans le code. Chaque application utilise un seul bot ; pour changer de bot, enregistrez le jeton de l'autre bot au même endroit, il remplace l'ancien. Vous pouvez commencer à construire avant d'enregistrer le jeton — l'application affiche des instructions de configuration tant qu'il manque.
Utilisation dans votre application
- L'application publie au nom de votre bot, depuis votre serveur. Les visiteurs ne se connectent jamais à Discord et ne choisissent jamais le canal. Le canal est fixé dans la fonction de l'application ou choisi par l'administrateur de l'application sur un écran de réglages.
- @everyone et @here ne notifient jamais personne. Un message construit à partir d'une saisie de visiteur ne peut pas alerter tout le serveur. L'application ne peut mentionner des utilisateurs ou des rôles précis que lorsqu'elle construit elle-même cette mention.
- Les applications privées sont réservées à l'administrateur. Pour une application privée, interne ou personnelle, MeDo ajoute une connexion et seul l'administrateur de l'application peut utiliser les fonctions Discord. Les comptes créés ensuite n'y ont pas accès.
- Les soumissions restent dans votre application. Un formulaire public enregistre d'abord chaque réservation ou message dans la base de données de l'application, puis publie un résumé. Les visiteurs peuvent soumettre, mais ne peuvent pas lire les soumissions des autres.
- Chaque enregistrement est publié une seule fois. L'application mémorise les enregistrements déjà envoyés à Discord, si bien qu'une requête relancée ne publie pas deux fois.
Limites et dépannage
L'application indique que Discord n'est pas configuré. Enregistrez le jeton du bot dans la configuration Discord, puis rechargez la page.
L'application indique que le jeton est invalide. Le jeton a été réinitialisé ou copié de façon incomplète. Réinitialisez-le à nouveau sur la page Bot et enregistrez le nouveau.
L'application indique que le bot n'a pas la permission. Ajoutez le bot au serveur, ou accordez-lui la permission manquante pour ce canal, puis réessayez.
Les messages s'affichent avec un texte vide. Activez Message Content Intent sur la page Bot et enregistrez.
Aucun serveur ni canal n'est listé. Le bot n'a pas encore été ajouté à un serveur. Ouvrez le lien d'invitation de l'étape 3 et ajoutez-le.
Voir aussi
- Catalogue des connecteurs — les autres connecteurs et leur usage.
- Clés et sécurité des données — comment les secrets de l'application, comme le jeton du bot, sont stockés.