Activer les intents privilégiés de ton bot Discord
Les intents privilégiés sont trois interrupteurs du Developer Portal qui autorisent un bot à voir des informations sensibles : les membres, le texte des messages et les présences. Ils s’activent dans l’onglet Bot, partie Privileged Gateway Intents, puis Save Changes. N’active que ceux que ton bot utilise : sur discbot.net, Publier te dit lesquels.
Mis à jour le
Quels intents sont privilégiés, et à quoi servent-ils ?
- Server Members Intent : voir les arrivées, les départs et les changements des membres, et lister les membres du serveur.
- Message Content Intent : lire le texte des messages écrits par les membres.
- Presence Intent : savoir qui est en ligne et à quoi il joue. Un bot discbot.net n’en a jamais besoin.
Les autres informations, comme les commandes slash, les clics sur les boutons, les réactions ou les salons vocaux, n’ont besoin d’aucun intent privilégié. Discord en explique la raison dans sa documentation des intents (en anglais).
Mon bot en a-t-il besoin ?
| Ce que fait ton bot | Intent à activer |
|---|---|
| Accueillir les nouveaux membres | Server Members Intent |
| Annoncer les départs | Server Members Intent |
| Supprimer la pub ou répondre à un mot | Message Content Intent |
| Commandes avec préfixe, comme !aide | Message Content Intent |
| Commandes slash, boutons, menus, formulaires | Aucun |
| Rôles par réaction | Aucun |
Même sans Message Content Intent, un bot lit les messages qui le mentionnent. Si tes besoins tiennent dans des commandes slash, c’est souvent la solution la plus simple, comme Discord le conseille dans You might not need a privileged intent.
Comment activer un intent dans le Developer Portal ?
- Ouvre ton application
Sur discord.com/developers/applications, clique sur l’application de ton bot. Prends bien celle dont le token est dans discbot.net.
- Va dans l’onglet Bot
Dans le menu de gauche, clique sur Bot, puis descends jusqu’à Privileged Gateway Intents.
- Active l’interrupteur demandé
Server Members Intent, Message Content Intent, ou les deux. Laisse Presence Intent désactivé.
- Enregistre
Clique sur Save Changes dans la barre qui apparaît en bas. Sans cette étape, rien n’est pris en compte.
- Reviens dans Publier
La ligne Accès spéciaux relit les réglages toute seule toutes les 30 secondes. Quand elle est validée, tu peux publier.
À quoi ressemble un bot qui a besoin de Message Content Intent ?
Quand quelqu’un écrit « bonjour » dans #général, réponds-lui en le saluant par son pseudo.
discbot.netC’est fait. Le bot répond aux bonjours dans #général.
Faut-il une autorisation de Discord ?
Pas pour commencer. Les interrupteurs s’activent librement tant que ton application n’a pas atteint 10 000 utilisateurs. Au-delà, Discord demande une vérification de l’application et une demande d’accès justifiée pour garder chaque intent privilégié. Le centre d’aide développeurs détaille la procédure (en anglais).
Quelles sont les erreurs fréquentes ?
- ProblèmePublier indique toujours qu’un accès spécial manque.
- SolutionL’intent a été activé sans cliquer sur Save Changes, ou sur une autre application. Vérifie que l’application ouverte est celle dont le token est dans Réglages › Discord.
- ProblèmeLe bot ignore les messages malgré l’intent.
- SolutionIl lui manque peut-être Voir le salon ou Voir les anciens messages dans ce salon. Vérifie les permissions du salon pour son rôle.
- ProblèmeUn bot hébergé ailleurs s’arrête avec « Used disallowed intents ».
- SolutionSon code demande un intent qui n’est pas activé dans le portail. Active-le, ou retire-le du code. Sur discbot.net, Publier repère ce cas avant la publication.
Questions fréquentes
Activer un intent rend-il mon bot moins sûr ?
Il donne à ton bot accès à plus d’informations sur les membres. Active seulement ce qui sert, et le bot ne lit rien de plus que ce que son code utilise.
Pourquoi Presence Intent n’est-il jamais demandé ?
Les présences ne sont pas disponibles pour les bots discbot.net. Laisse cet interrupteur désactivé.
Dois-je refaire ces réglages à chaque publication ?
Non. Les intents restent activés sur ton application. Publier vérifie seulement à chaque fois qu’ils sont toujours en place.
Gratuit pour l’instant. Crée ton compte discbot.net : pendant la bêta privée, Publier te guide dès que ton accès est approuvé.