Relier Discord à Agora : connexion, bot et rôles

En bref. Ton application Discord sert à deux choses. La connexion (obligatoire) permet à tes membres de se connecter à ton Hub avec leur compte Discord. Le bot (facultatif) donne automatiquement le bon rôle Discord quand un membre entre dans un groupe, et envoie un message privé quand sa candidature est tranchée.

Avant de commencer #

• La mise en route est faite : ton application Discord existe déjà.
• Tu es administrateur du Hub (ton site Agora). Pour changer l'identifiant et le secret de la connexion, il faut en plus être le propriétaire de l'installation.
• Pour inviter le bot, tu as la permission Gérer le serveur sur ton serveur Discord.
• Un mot t'arrête ? Il est expliqué dans le glossaire.

La connexion (OAuth), déjà réglée à la mise en route #

L'OAuth est la façon standard de « se connecter avec Discord » : Discord confirme à Agora qui est le membre, sans mot de passe à créer.

Elle se règle à la mise en route. Tu la retrouves dans Administration → Configuration → Connexion Discord, bloc Connexion Discord (OAuth) : Client ID (l'identifiant public de ton application) et Client Secret (son secret). La valeur enregistrée ici s'applique sans redémarrage.

<!-- CAPTURE C-020 -->

Agora demande deux autorisations à Discord, identify (ton nom, ton avatar et ton identifiant) et email (ton courriel), rien d'autre : la présence d'un membre sur ton serveur Discord se vérifie par le bot, pas par sa connexion.

Seul le propriétaire de l'installation peut changer l'ID et le secret de cette application, car elle décide qui se connecte au site. Le bot reste réglable par tout administrateur. Voir Gérer les membres.

L'URL de redirection doit être déclarée chez Discord au caractère près : même protocole, même hôte, même port. Discord accepte http:// et les adresses IP. Voir Connexion Discord impossible.

Relier le bot (facultatif) #

Sans bot, tout fonctionne ; seule la synchronisation des rôles est coupée. Chaque étape ci-dessous est détaillée, captures à l'appui, dans Créer et configurer ton bot Discord.

1. Dans le portail des développeurs Discord, ouvre ta même application, onglet Bot, puis Reset Token. Copie le token du bot, un secret montré une seule fois.
2. Toujours dans Bot, active Server Members Intent. C'est la case qui autorise le bot à voir la liste des membres de ton serveur Discord.
3. Invite le bot : OAuth2 → URL Generator, coche la portée bot et la permission Manage Roles, puis ouvre l'URL générée et choisis ton serveur.
4. Dans Discord : Paramètres du serveur → Rôles, glisse le rôle du bot au-dessus de tous les rôles qu'il doit donner.
5. Copie l'ID du serveur : Paramètres utilisateur → Avancés → Mode développeur, puis clic droit sur le serveur et Copier l'identifiant du serveur (aide officielle de Discord).
6. Dans Agora, Administration → Configuration → Connexion Discord, bloc Bot Discord (rôles + messages) : colle le Token du bot et l'ID du serveur (guild), puis Enregistrer.

La bannière passe à « ● Bot connecté : nom sur serveur · N rôle(s) visibles ». Le bouton Tester vérifie le token, le serveur et ce que Discord refuserait à la prochaine synchronisation (rôle du bot trop bas, rôle supprimé…), sans rien modifier sur Discord.

Relier chaque rôle du site à un rôle Discord #

Une fois le bot connecté, la section Rôles Discord reliés aux rôles se déverrouille.

1. Pour chaque rôle du site (Whitelist, Police…), choisis le rôle Discord dans la liste.
2. Enregistre.

Désormais, donner un rôle du site à un membre (candidature acceptée ou geste d'un administrateur) lui donne aussi le rôle Discord. Retirer le rôle du site retire le rôle Discord.

Un rôle que le bot ne pourra pas donner (placé au-dessus du sien, ou géré par une intégration) est grisé avec la raison et refusé à l'enregistrement. Si tu réordonnes les rôles plus tard, la liste rouge Correspondances que Discord refusera te le montre, avec un bouton Ouvrir dans l'app Discord pour corriger.

<!-- CAPTURE C-021 -->

Tu sais que c'est réussi quand… #

• La bannière affiche « ● Bot connecté : … ».
• Le bouton Tester répond « Aucun problème : la synchro des rôles peut fonctionner ».
• Tu donnes un rôle du site à un compte de test et il reçoit le rôle Discord correspondant.

Si ça ne marche pas #

Pour aller plus loin #

• Dans l'autre sens. Pour un groupe dont les rôles sont déjà gérés dans Discord (un autre bot, un rôle d'abonné), coche Synchroniser Discord → Agora sous sa correspondance : le membre qui reçoit le rôle sur Discord entre dans le groupe, celui qui le perd en sort. Cette écoute demande Server Members Intent (étape 2) ; sans lui, Agora se replie sur le journal d'audit et le rôle du bot a besoin de la permission Voir les logs du serveur. Tout est expliqué dans Rôles Discord, synchronisation et « Membre suspendu ».

• Membre suspendu. Le réglage Membre suspendu décide de ce qui arrive aux rôles Discord d'un membre suspendu : les garder (par défaut), les retirer pendant la suspension, ou les retirer et refuser sa connexion au serveur de jeu.

  <!-- CAPTURE C-022 -->

• La règle d'or. Un bot ne peut jamais donner un rôle placé plus haut que le sien : c'est la première cause d'échec.