Discord
Anyy utilise un jeton de bot Discord avec le profil officiel de connexion Gateway. L’adaptateur prend en charge les messages privés, les canaux de serveur, les fils Discord, les pièces jointes entrantes, l’association et les contrôles de santé en direct.
1. Créer l’application Discord
Dans le Discord Developer Portal :
- Créez une application et ajoutez un utilisateur bot.
- Copiez le jeton du bot dans un gestionnaire de mots de passe sûr.
- Configurez les intents Gateway pour les conversations activées.
- Installez le bot sur le serveur voulu avec les autorisations de consulter et d’envoyer des messages.
Anyy calcule les intents nécessaires à partir des règles. Les messages privés exigent l’intent correspondant ; les messages de serveur activés exigent celui des messages de serveur. La règle de groupe open ou allowlist exige également l’intent Message Content. Dashboard indique les prérequis externes correspondants.
2. Ajouter Discord à Anyy
Ouvrez Dashboard → Channel → Add → Discord. L’entrée par défaut utilise Bot Gateway ; ajoutez le jeton du bot. Définissez les règles des messages privés et des groupes dans l’assistant CLI ; ces champs ne figurent pas dans ce formulaire Dashboard.
Configuration CLI :
anyy setup channel
Le jeton du bot est enregistré comme secret du profil. À l’activation, Anyy vérifie l’identité authentifiée du bot et celle de l’application avant d’accepter la connexion.
3. Définir les règles
Discord utilise par défaut pairing pour les messages privés et mention pour les groupes. La configuration propose les choix suivants :
| Règle | Message privé | Groupe |
|---|---|---|
pairing | Oui | — |
allowlist | Oui | Oui |
open | Oui | Oui |
mention | — | Oui |
disabled | Oui | Oui |
Choisissez Discord dans l’assistant CLI pour modifier ces règles. Les listes d’autorisation existantes utilisent les identités Discord des utilisateurs/canaux ; la configuration actuelle ne permet pas d’en modifier les entrées. Consultez Plateformes de messagerie.
4. Vérifier la connexion
anyy channel reload
anyy channel doctor discord
Envoyez un message privé ou mentionnez le bot dans un canal de serveur autorisé. Approuvez tout nouvel expéditeur privé lorsque Pairing est actif :
anyy channel pairing list --channel discord
anyy channel pairing approve --request REQUEST_ID
Fils et pièces jointes
L’identité du fil Discord est conservée dans la route de conversation : les réponses reviennent donc dans le même fil. Les pièces jointes entrantes sont téléchargées dans la session Anyy concernée si elles respectent les limites de médias.
N’accordez au bot que les autorisations Discord nécessaires. Anyy contrôle les autorisations des outils et du modèle, mais les autorisations Discord déterminent où le bot peut lire ou publier.
Si vous élargissez la règle des groupes, mettez à jour les intents Discord Gateway correspondants et rechargez Anyy. Un jeton valide ne garantit pas à lui seul la livraison des événements de message.
Dépannage
| Symptôme | Points à vérifier |
|---|---|
| Le bot s’authentifie mais ne reçoit aucun message de serveur | Intents des serveurs/messages, installation du bot, autorisations du canal et règle des groupes |
| Seules les mentions fonctionnent | Comportement attendu avec la règle mention par défaut |
| Le message privé attend une association | Approuvez la demande, puis envoyez un nouveau message privé |
| Les réponses arrivent au mauvais endroit | Vérifiez que l’événement contient l’identité du canal/fil voulu |
| Une pièce jointe manque | Accès à l’URL Discord, taille du fichier, limite des médias et sortie de diagnostic |
Pour le fonctionnement commun de l’association et du rechargement, consultez Plateformes de messagerie.