Intents privilégiés de Discord : présence, membres et contenu des messages
Les intents privilégiés sont les trois intents de passerelle qui donnent accès à des données sensibles : mises à jour de présence, liste des membres du serveur et contenu des messages. Un bot doit activer chacun d'eux dans le Portail développeur, et une fois qu'il dépasse 100 serveurs, il doit aussi être vérifié et approuvé par Discord pour continuer à les utiliser.
Les trois intents
- Présence : indique si les membres sont en ligne, inactifs ou hors ligne, ainsi que leur statut d'activité.
- Membres du serveur : événements d'arrivée et de départ des membres, et liste complète des membres. Nécessaire pour les messages de bienvenue, la vérification et les rôles automatiques.
- Contenu des messages : le texte réel, les embeds et les pièces jointes des messages. Nécessaire pour lire les commandes à préfixe et pour tout ce qui analyse du texte.
Sans le contenu des messages, un bot reçoit toujours les messages qui le mentionnent, les messages privés et ses propres messages, ainsi que les interactions comme les commandes slash. C'est pourquoi les bots modernes s'appuient sur les commandes slash.
Fonctionnement de l'approbation
Pour un bot présent sur moins de 100 serveurs, il suffit de cocher l'interrupteur sur la page du bot dans le Portail développeur. Lorsqu'un bot atteint 100 serveurs, Discord exige sa vérification, et les intents privilégiés doivent alors être approuvés avec une raison écrite. Sans cela, le bot les perd. Discord décide au cas par cas, donc une explication claire de la fonctionnalité qui a besoin de ces données aide.
Si un bot se connecte en demandant un intent privilégié qu'il n'a pas activé, Discord ferme la connexion avec l'erreur 4014. C'est une cause fréquente de bot hors ligne juste après sa configuration. Voir l'explication de l'erreur 4014.
Pourquoi les propriétaires de serveur s'en soucient
Ces intents sont la partie d'un bot qui touche aux données de vos membres. Le contenu des messages est celui qui mérite le plus d'attention : un bot qui lit les messages peut filtrer le spam et les liens, mais il voit aussi tout ce qui est dit là où il a accès. Vous pouvez limiter cela en retirant au bot la permission Voir les salons dans les espaces privés.
Cela touche aussi à la fiabilité. Un bot qui perd un intent approuvé peut cesser discrètement d'accueillir les membres ou de faire respecter les règles.
Noxyr et les intents privilégiés
Pour un bot personnalisé Noxyr utilisant votre propre application, la configuration exige d'activer l'intent des membres du serveur et l'intent de contenu des messages dans le Portail développeur. Les fonctionnalités de Noxyr qui s'appuient dessus incluent les messages de bienvenue, la vérification et l'anti-spam. Lisez le guide complet sur les intents de passerelle privilégiés, et l'idée plus générale dans intents de passerelle.
Vérifiez avant d'installer un bot
Demandez quels intents privilégiés un bot utilise et pour quoi faire. Un bot de musique a rarement besoin des données de présence, et un bot de sondage a rarement besoin de lire tous les messages. Si la réponse est floue, choisissez un autre bot.
Questions fréquentes
Quels intents sont privilégiés ?
La présence, les membres du serveur et le contenu des messages.
Pourquoi mon bot se déconnecte-t-il avec l'erreur 4014 ?
Il a demandé un intent privilégié qui n'est pas activé dans le Portail développeur. Activez-le puis redémarrez le bot.
Quels intents un bot personnalisé Noxyr doit-il avoir ?
L'intent des membres du serveur et l'intent de contenu des messages doivent être activés pour votre propre application.