Bot Xsolla sur Discord

Aperçu

Le bot fonctionne directement au sein de votre serveur Discord et permet aux utilisateurs de se connecter, de réclamer des récompenses et d’effectuer des achats sans quitter l’environnement Discord. De plus, le bot prend en charge l’envoi de messages sortants vers les canaux.

Flux utilisateur dans Discord :

1. L’utilisateur tape /shop dans n’importe quel canal où le bot est connecté. Le magasin apparaît uniquement pour l’utilisateur qui a utilisé la commande — les autres utilisateurs du canal ne le verront pas.

2. L’utilisateur se connecte avec son identifiant de joueur.
3. L’utilisateur parcourt le catalogue.
4. L’utilisateur clique sur le bouton d’achat à côté de l’article souhaité.
5. L’utilisateur est redirigé vers l’interface de paiement.
6. Après un paiement réussi, l’utilisateur retourne dans le canal Discord, et l’article est accordé à l’utilisateur dans le jeu.

Si l’utilisateur souhaite parcourir d’autres articles, il peut cliquer sur le bouton pour ouvrir le Web Shop. Le bot redirige l’utilisateur vers l’URL du Web Shop, où il peut explorer l’ensemble du catalogue d’articles.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant U as User
    participant D as Discord Bot
    participant X as Xsolla
    activate U
    U->>D: /shop command
    activate D
    D-->>U: Shop UI appears
    deactivate D
    U->>D: Log in with Player ID
    activate D
    D-->>U: Catalog displayed
    deactivate D
    U->>D: Click purchase on desired item
    activate D
    D->>X: Player ID + Item SKU
    activate X
    X-->>D: Return link to Payment UI
    D-->>U: Redirect to Payment UI
    deactivate D
    U->>X: Complete payment
    activate X
    note right of X: Grant item to player inventory
    deactivate X
    X->>D: Webhook: item granted notification
    deactivate X
    activate D
    D-->>U: Confirmation of successful purchase
    deactivate D
    deactivate U

Prérequis

Pour vendre vos objets en jeu à l’aide du bot, vous devez :

1. Utiliser Discord pour communiquer avec les utilisateurs.
2. Avoir un Web Shop entièrement configuré. Cela inclut également la création du catalogue d’articles que vous pouvez faire manuellement, via l’API, ou en important à partir de fichiers JSON ou de plateformes externes.
3. Configurer les webhooks suivants pour valider les utilisateurs et accorder les achats aux utilisateurs :
   • Validation utilisateur dans le Web Shop
   • Paiement réussi pour la commande
   • Annulation de commande
4. Signer le contrat de licence avec Xsolla.

Comment le configurer

Créer un bot

1. Dans votre projet dans le Compte éditeur, allez à la section Storefront > Xsolla Bot in Discord.
2. Cliquez sur Create.

3. Téléchargez le logo et spécifiez le nom du bot.
4. Cliquez sur Create.
5. Allez à l’onglet Settings pour compléter la configuration du bot :
   1. Dans le bloc Player ID help configurator, cliquez sur Set up et fournissez des instructions concises sur la façon dont les utilisateurs peuvent trouver leur identifiant de joueur. Cela sera affiché dans l’interface Discord une fois que l’utilisateur cliquera sur How to find player ID.

2. La clé API est générée automatiquement. Si vous souhaitez la mettre à jour, cliquez sur Generate key.
3. Le jeton du bot est généré automatiquement. Si vous avez déjà un bot dans Discord, cliquez sur Change et fournissez son jeton dans le champ correspondant.

Instructions pour trouver le jeton du bot dans Discord

1. Allez sur la page de votre application dans le portail des développeurs Discord.
2. Allez à la section Overview > Bot.
3. Dans la section Token, cliquez sur Reset token. Il se peut que vous deviez passer une vérification.
4. Copiez la nouvelle valeur du jeton.

Pour vérifier si vous avez ajouté le jeton avec succès, rechargez la page dans le Compte éditeur. Si vous voyez un lien d’invitation en haut de la page, la configuration est réussie. Suivez ce lien pour ajouter le bot à votre serveur Discord.

4. Dans le bloc User authentication webhook, cliquez sur Change et spécifiez l'URL du webhook depuis la section Project settings > Webhooks.
5. Dans la ligne Web Shop URL, cliquez sur Change. Dans la fenêtre modale qui s'ouvre, spécifiez votre URL du Web Shop et cliquez sur Save.

Une fois que vous avez configuré tous les paramètres requis, le statut du bot passera à Active.

Configurer les articles

Pour configurer les articles à vendre :

1. Allez à l’onglet Shop et cliquez sur Build your shop.
2. Dans l’onglet Shop items :
   1. Téléchargez l’image de couverture du magasin.
   2. Spécifiez le titre du magasin (obligatoire).
   3. Cochez les cases à côté des articles que vous souhaitez vendre via Discord (obligatoire).
   4. Cliquez sur Confirm.

Après cela, vous pouvez aller sur votre serveur Discord pour vérifier si le bot fonctionne correctement.

Configurer les récompenses

Pour inciter les utilisateurs à visiter votre magasin plus souvent, vous pouvez configurer les récompenses suivantes :

• Récompense de connexion — récompenses disponibles pour l’utilisateur lorsqu’il se connecte au magasin pour la première fois.
• Récompenses quotidiennes — articles exclusifs pouvant être réclamés une fois par jour.

Pour le configurer :

1. Allez à l’onglet Shop et cliquez sur Build your shop.

2. Configurez les articles de récompense :
   1. Dans l’onglet Login rewards, sélectionnez un objet gratuit et cliquez sur Confirm.
   2. Dans l’onglet Daily rewards, sélectionnez des objets gratuits et cliquez sur Confirm. Pour réorganiser les articles dans le bon ordre, faites-les glisser et déposez-les sur la page principale des paramètres.

Après cela, vous pouvez aller sur votre serveur Discord pour vérifier si le bot fonctionne correctement.