Bot Xsolla sur Discord

Vue d’ensemble

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 ID de joueur.
3. L’utilisateur parcourt le catalogue.
4. L’utilisateur clique 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 retourne dans le canal Discord, et l’objet est accordé à l’utilisateur dans le jeu.

  %%{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. Créer un catalogue d’objets. Vous pouvez le 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
   • 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 ID 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 à 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. Vous pourriez être invité à 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 Paramètres de projet > Webhooks.
5. Si vous n'avez pas besoin de connecter votre Web Shop, laissez le bloc Web Shop URL inchangé.

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

Configurer les objets

Pour configurer les objets à 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 objets 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 motiver 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 — objets 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 objets 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 objets 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.