Commencer avec les Bots Discord Gamma

À propos

Nos bots Discord peuvent être ajoutés et configurés en quelques minutes et n'ont pas de coûts ni de maintenance. Ce guide de configuration vous guidera à travers le processus.

Pour commencer

Nous vous recommandons de lire les instructions ci-dessous dans leur intégralité avant de poursuivre. Ensuite, l'étape 1 vous demandera de visiter un lien pour installer le bot sur votre serveur.

1. Installez le bot sur le serveur Discord de votre communauté en visitant ce lien : Installer Bot
2. Sélectionnez un channel existant ou créez un channel que vous souhaitez utiliser pour le feed du bot. Cela pourrait être quelque chose comme #sales ou #marketplace-events ou similaire. Vous pouvez publier sur plusieurs channels si vous souhaitez diviser différents flux en différents channels. Assurez-vous que votre bot a la permission d'accéder et de poster sur le channel. Si vous ne voyez pas le bot dans la barre latérale du channel, il est probable qu'il n'ait pas la permission d'y accéder.
3. Vérifiez que le bot a les permissions suffisantes pour publier sur le channel sélectionné. Vous pouvez le faire en exécutant la commande suivante :

   1. /check-bot-permissions

4. Une fois que le bot fait partie de la channel, le serveur peut taper /ordinals-sales (ou n'importe quelle autre commande /-watch), et pourra sélectionner la collection et le feed auxquels s'abonner.

Exemple de configuration d'abonnement

Vous pouvez regarder un exemple d'abonnement à un feed de bot spécifique dans la vidéo ci-dessous.

Commandes d'abonnement disponibles

Ordinals 

/ordinals-listings
/ordinals-sales
/view-channel-subscriptions
/remove-channel-subscription

Stacks

/stacks-watch-listings
/stacks-watch-sales
/stacks-watch-unlistings
/stacks-watch-offers
/stacks-watch-auctions
/stacks-watch-dao
/stacks-watch-stacks-blocks
/view-channel-subscriptions
/remove-channel-subscription

Vérification du compte Discord

Ordinals

La vérification du compte Discord sera bientôt disponible pour les adresses ordinals/Bitcoin. Nous travaillons avec les wallet pour assurer la signature de messages afin de prouver l'identité d'une adresse Bitcoin contenant des ordinaux.

Stacks

Les propriétaires de serveurs Discords et les membres de la communauté peuvent utiliser le processus de vérification de compte Discord pour lier leur compte Discord à leurs adresses Stacks et profils Gamma.

Ce processus utilise Discord OAuth pour partager de façon sécurisée les informations de propriété du compte Discord et les informations de base de profil avec Gamma. Vous serez informé(e) exactement des données partagées lorsque vous commencerez le processus ci-dessous. De même, le processus utilise votre wallet connecté à Gamma et la signature sécurisée des messages pour vérifier la propriété de votre adresse Stacks, de votre profil Gamma et de vos actifs sur la blockchain.

Ce processus permet aux propriétaires de serveurs de valider les membres de la communauté en fonction de leurs actifs, ce qui permet de créer des communautés contrôlées par les NFT et de partager des informations sur Discord.

Comment lier les comptes Discord aux adresses Stacks

1. Pour connecter un compte Discord à une adresse Stacks, les administrateurs et les utilisateurs de Discord utiliseront la même commande, décrite ci-dessous : 

   /verify

2. Un message du bot apparaîtra pour indiquer à l'utilisateur de commencer le processus, qui nécessitera d'abord que l'utilisateur vérifie les informations partagées entre Discord et Gamma.
3. L'utilisateur sera redirigé vers une page Gamma pour effectuer le même processus pour son adresse Stacks et son profil Gamma. Si l'utilisateur n'est pas actuellement connecté avec son wallet à Gamma, il lui sera demandé de se connecter et de signer un message authentifiant sa session.
4. Une fois l'opération terminée, l'utilisateur sera informé que le processus s'est déroulé avec succès et qu'il peut fermer la fenêtre de son navigateur en toute sécurité.

Affectation de rôles basées sur les actifs vérifiés

Après avoir configuré le bot Gamma sur votre serveur Discord, vous pouvez utiliser la fonction de mapping des rôles du bot pour créer des communautés fermées basées sur les actifs NFT. Nous sommes également favorables à un mapping plus granulaire des rôles basé sur la présence d'un trait donné dans les fonds NFT d'un utilisateur, par exemple, "Fond rouge".

Les étapes ci-dessous supposent également que vous avez déjà créé des rôles Discord et des channels associés à des rôles. Vous trouverez des informations sur la manière de procéder dans cet article de la base de connaissances Discord.

Gestion des mappings de rôles (holdings NFT)

1. Pour créer un nouveau mapping de rôle, appelez la commande ci-dessous dans n'importe quel canal pour commencer le processus de mapping :

   /create-role-mapping

2. Ensuite, vous saisirez le rôle, la collection et le nombre de NFT qui atteignent le seuil de qualification pour le rôle sélectionné. Lorsque vous avez terminé, vous pouvez appuyer sur la touche Entrée pour créer le mapping de rôle.
3. Pour revoir et supprimer les mappings de rôles existants, vous suivrez un processus similaire mais en utilisant les commandes ci-dessous : 

   /view-role-mappings
   /remove-role-mapping

Gestion des mappings de rôles basés sur des traits (holdings NFT d'un trait donné)

1. Pour créer un nouveau mapping de rôle basé sur les traits, appelez la commande ci-dessous dans n'importe quel canal pour commencer le processus de mapping :

   /create-trait-role-mapping

2. Ensuite, vous saisirez le rôle, la collection, la catégorie et le nom du trait, et le nombre de NFT qui atteignent le seuil de qualification pour le rôle sélectionné. Lorsque vous avez terminé, vous pouvez appuyer sur la touche Entrée pour créer le mapping de rôle.
   
3. Pour revoir et supprimer les mappings de rôles existants, vous suivrez un processus similaire mais en utilisant les commandes ci-dessous : 

   /view-role-mappings
   /remove-role-mapping

Synchronisation des rôles des utilisateurs en fonction des mappings de rôles

Même si un utilisateur détient activement les NFTs requis pour se voir attribuer un rôle mappé, son statut de détenteur doit être synchronisé avec le bot pour que les rôles soient attribués. Ce processus fonctionne de la même manière en sens inverse si l'utilisateur vend ou transfère ses actifs autrefois vérifiés.

Un propriétaire de serveur peut synchroniser les rôles pour tous les utilisateurs de son serveur, ou un utilisateur individuel peut synchroniser ses propres rôles en utilisant la même commande. Après qu'un utilisateur ait réussi à lier son compte Discord à son adresse Stacks, il sera automatiquement invité à exécuter la commande sync roles. 

1. Pour synchroniser les rôles, un propriétaire de serveur ou un utilisateur individuel peut appeler cette commande

   /sync-roles

Gestion des permissions pour voir et interagir avec les commandes du bot

Par défaut, les commandes admin du bot (par exemple /watch-listings) apparaîtront à tous les utilisateurs du serveur. Cependant, seuls les administrateurs de serveur pourront exécuter ces commandes avec succès.

Si un utilisateur de Discord ou un membre du serveur tente d'utiliser les commandes du bot, celui-ci envoie un message d'erreur indiquant que l'utilisateur n'est pas autorisé à exécuter la commande. Cela ne s'applique pas aux commandes de la communauté telles que /floor qui sont disponibles pour tous les utilisateurs dans un channel où l'utilisateur et le bot peuvent poster tous les deux.

Si vous souhaitez restreindre l'interaction avec le bot dans certains channels (y compris les commandes de la communauté), vous pouvez permettre au bot de ne poster que sur un channel qui est en lecture seule pour les membres de la communauté. Vous pouvez ensuite supprimer l'accès du bot aux channels où il n'est pas nécessaire. Si un utilisateur ne peut pas poster sur le channel, il n'aura pas la possibilité d'appeler la fonction d'un bot.

Masquer toutes les commandes aux utilisateurs (non recommandé)

Si vous voulez masquer les commandes pour les utilisateurs, vous pouvez supprimer la permission “Commandes d'Application” au niveau du serveur Discord pour les utilisateurs. Ceci se trouve dans les paramètres du serveur principal. Veuillez noter que ce paramètre empêche toutes les commandes slash sur tous les bots de votre serveur.

Aide et dépannage

Voir les commandes disponibles

Appuyez sur la touche slash ( / ) pour afficher et faire défiler une liste de toutes les commandes disponibles. Lorsque vous commencez à taper les mots de la commande que vous recherchez, cela filtrera instantanément les commandes qui ne correspondent pas à votre recherche.

Permission de gestion des rôles manquante

Si vous demandez au bot une action qui nécessite des autorisations élevées (par exemple, l'autorisation de gérer les rôles), le bot renvoie une erreur indiquant que des autorisations élevées sont nécessaires. Vous pouvez cliquer sur le lien fourni pour accorder au bot les autorisations nécessaires.

Autres problèmes ou questions

Si vous avez besoin d'aide supplémentaire pour démarrer ou résoudre des problèmes avec votre bot, nous vous recommandons d'envoyer une demande au service clientèle.