Bot Xsolla sur Discord

Aperçu

Le bot s’exécute directement sur votre serveur Discord et permet aux utilisateurs de s’authentifier, de réclamer des récompenses et d’effectuer des achats sans quitter l’environnement Discord. Il prend également en charge l’envoi de messages vers les canaux du serveur.

Flux utilisateur dans Discord :

1. L’utilisateur saisit la commande /shop dans n’importe quel canal auquel le bot est connecté. Le magasin s’affiche uniquement pour l’utilisateur ayant exécuté la commande ; il n’est pas visible aux autres utilisateurs du canal.

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

Si l’utilisateur souhaite parcourir d’autres objets, il appuie sur le bouton pour ouvrir le Web Shop. Le bot le redirige alors vers l’URL du Web Shop, où il peut consulter l’ensemble du catalogue des objets.

  %%{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. Disposer d’un Web Shop entièrement configuré. Cela inclut également la création du catalogue des objets que vous pouvez effectuer manuellement, via API, ou en important à partir de fichiers JSON ou de plateformes externes.
3. Configurer les webhooks suivants afin de valider les utilisateurs et de leur attribuer leurs achats :
   • Validation utilisateur dans Web Shop
   • Paiement de commande réussi
   • Annulation de commande
4. Signer le contrat de licence avec Xsolla.

Comment configurer

Créez un bot

1. Dans le projet dans le Compte éditeur, accédez à la section Storefront > Xsolla Bot in Discord.
2. Appuyez sur Create.

3. Téléchargez le logo et spécifiez le nom du bot.
4. Appuyez sur Create.
5. Accédez à l’onglet Settings pour finaliser la configuration du bot :
   1. Dans le bloc Player ID help configurator, appuyez sur Set up et fournissez des instructions concises expliquant comment les utilisateurs peuvent trouver leur ID de joueur. Ces instructions seront affichées dans l’interface Discord lorsque l’utilisateur appuiera sur How to find player ID.

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

Instructions pour trouver le jeton du bot dans Discord

1. Accédez à la page de votre application dans le portail des développeurs Discord.
2. Accédez à la section Overview > Bot.
3. Dans la section Token, appuyez sur Reset token. Passez la vérification si nécessaire.
4. Copiez la nouvelle valeur du jeton.

Pour vérifier que le jeton a bien été ajouté, actualisez la page dans le Compte éditeur. Si un lien d’invitation apparaît en haut de la page, la configuration est réussie. Appuyez sur ce lien pour ajouter le bot à votre serveur Discord.

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

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

Configurez des objets

Pour configurer les objets à vendre :

1. Accédez à l’onglet Shop et appuyez 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 objets que vous souhaitez vendre via Discord (obligatoire).
   4. Appuyez sur Confirm.

Après cette étape, rendez-vous sur votre serveur Discord pour vérifier que le bot fonctionne correctement.

Configurer les récompenses

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

• Login reward : récompenses disponibles pour l’utilisateur lors de sa première connexion au magasin.
• Daily rewards : objets exclusifs pouvant être réclamés une fois par jour.

Pour configurer :

1. Accédez à l’onglet Shop et appuyez sur Build your shop.

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

Après cette étape, rendez-vous sur votre serveur Discord pour vérifier que le bot fonctionne correctement.