Discord

Comment fonctionne Discord ici

Les membres atteignent le bot avec une commande slash, et non en discutant normalement. Taper /ask combien coûte la livraison ? obtient une réponse ; taper combien coûte la livraison ? dans le canal ne fait rien.

C'est volontaire. Un bot qui lit chaque message d'un serveur a besoin d'un accès bien plus large aux conversations de votre communauté, et il consommerait vos crédits pour des échanges auxquels il n'a jamais été invité. La commande slash garde le reste de votre serveur privé et laisse vos membres décider du moment où le bot écoute.

Ajouter au serveur (un clic)

Ouvrez Configurations → Canaux dans la barre latérale du tableau de bord, puis sur la carte Discord, choisissez Autoriser. Le dialogue s'ouvre avec Ajoutez le bot ProxyAI à votre serveur et son bouton Ajouter au serveur.

1. Choisissez Ajouter au serveur. L'écran d'autorisation de Discord s'ouvre dans un nouvel onglet.
2. Choisissez un serveur. Il vous faut la permission Gérer le serveur sur ce serveur : c'est la règle de Discord pour ajouter toute application, pas la nôtre.
3. Choisissez Autoriser. Vous revenez à votre tableau de bord ProxyAI.

Les membres peuvent alors utiliser /ask sur ce serveur. Rien à créer, rien à configurer, aucun site développeur à visiter.

Le bot demande deux permissions : Voir les canaux et Envoyer des messages. La commande slash fonctionne sans l'une ni l'autre ; elles permettent à une personne de votre équipe de répondre dans le canal depuis la boîte de réception de ProxyAI.

Pour ajouter un second serveur, choisissez de nouveau Ajouter au serveur et sélectionnez-le. Pour retirer le bot, expulsez-le du serveur dans Discord.

Une particularité mérite d'être connue : l'élément Revérifier du menu de la carte ne regarde que les réglages avancés ci-dessous. Après une installation en un clic, il affiche donc « Non configuré ». La connexion est correcte ; confirmez-le en exécutant /ask sur votre serveur.

Avancé : utiliser votre propre bot

Choisissez cette option lorsque vous voulez que le bot porte votre propre nom et votre image, une commande autre que ask, ou qu'il réponde aux messages privés. Cela suppose de créer une application sur le site développeurs de Discord, donc cela demande un peu plus d'efforts.

1. Ouvrez le Portail développeurs Discord et choisissez New Application. Le nom que vous lui donnez est celui que verront les membres.
2. Ouvrez l'onglet Bot, choisissez Reset Token et copiez le Bot Token. Discord ne l'affiche qu'une seule fois.
3. Ouvrez General Information et copiez la Public Key. ProxyAI l'utilise pour confirmer que les requêtes viennent bien de Discord.
4. Dans le dialogue ProxyAI, sous Avancé, apportez votre propre bot, collez les deux valeurs.
5. Vous pouvez éventuellement définir un nom de Commande slash : minuscules, sans espaces. Laissez vide pour ask.
6. Choisissez Enregistrer.

Le dialogue affiche aussi une URL de point de terminaison des interactions avec un bouton de copie. Vous n'en avez pas besoin : l'enregistrement vérifie votre bot, crée la commande slash et oriente votre application vers ProxyAI automatiquement.

Invitez ensuite votre bot :

1. Portail développeurs → Installation.
2. Sous Installation Contexts, activez Guild Install pour les serveurs, et User Install également si le bot doit répondre aux messages privés.
3. Sous Default Install Settings, attribuez les scopes applications.commands et bot, ainsi que la permission Envoyer des messages.
4. Copiez le Install Link, ouvrez-le et choisissez votre serveur.

Les deux valeurs sont des secrets. Si l'une d'elles est divulguée, réinitialisez le jeton sur le site de Discord et enregistrez le nouveau ici.

Testez

Sur un serveur où le bot est installé, tapez /ask et envoyez une question. Discord affiche que le bot réfléchit, et la réponse arrive quelques secondes plus tard.

• La commande n'apparaît pas : une commande nouvellement créée peut mettre jusqu'à une heure à atteindre tous les serveurs, et Discord met en cache la liste par appareil. Patientez, puis rechargez avec Ctrl+R (Cmd+R sur Mac). Vérifiez que le bot a été invité avec le scope applications.commands.
• « Ce serveur n'est pas encore connecté à un assistant » : le bot est sur le serveur, mais aucun bot ProxyAI ne l'a revendiqué. Lancez Ajouter au serveur depuis votre tableau de bord.
• « Cet assistant fonctionne dans un serveur » : vous avez écrit en privé au bot ProxyAI partagé. Le bot partagé ne répond que dans les serveurs ; les messages privés exigent votre propre bot avec User Install activé.
• « L'application n'a pas répondu » : la réponse a pris trop de temps ou la connexion a été refusée. Sur la voie avancée, enregistrez à nouveau les réglages Discord.
• L'enregistrement échoue avec une erreur de jeton invalide : le jeton a été réinitialisé après votre copie. Réinitialisez-le une nouvelle fois et collez la valeur fraîche.
• Une réponse humaine n'arrive jamais : le bot n'a pas la permission Envoyer des messages dans ce canal précis. Vérifiez les permissions propres à ce canal, pas seulement le rôle du serveur.

Conversations et confidentialité

Dans la boîte de réception d'agent, une conversation appartient à un canal Discord, et non à un membre en particulier. Dans un canal partagé, tous ceux qui utilisent la commande là-bas partagent un même historique, et une réponse humaine est visible par tout le canal. Les messages privés, si vous les avez activés, restent privés pour chaque membre.

Le bot ne voit que le texte saisi dans la commande. Tout le reste de ce qui se dit sur votre serveur reste hors de ProxyAI.