Xsolla Bot in Discord

Überblick

Der Bot arbeitet direkt in Ihrem Discord-Server und ermöglicht es den Nutzern, sich anzumelden, Belohnungen zu beanspruchen und Käufe zu tätigen, ohne die Discord-Umgebung zu verlassen. Zusätzlich unterstützt der Bot ausgehende Nachrichten an Kanäle.

Ablauf für den Nutzer in Discord:

1. Der Nutzer gibt /shop in einem beliebigen Kanal ein, in dem der Bot verbunden ist. Der Shop erscheint nur für den Nutzer, der den Befehl verwendet hat – andere Nutzer im Kanal sehen ihn nicht.

2. Der Nutzer meldet sich mit seiner Spieler-ID an.
3. Der Nutzer durchsucht den Katalog.
4. Der Nutzer klickt auf die Kaufen-Schaltfläche neben dem gewünschten Artikel.
5. Der Nutzer wird zum Zahlungsportal weitergeleitet.
6. Nach erfolgreicher Zahlung kehrt der Nutzer zum Discord-Kanal zurück, und der Artikel wird dem Nutzer im Spiel gewährt.

Wenn der Nutzer andere Artikel durchsuchen möchte, kann er auf die Schaltfläche klicken, um den Web Shop zu öffnen. Der Bot leitet den Nutzer zur URL des Web Shops weiter, wo der Nutzer den gesamten Artikelkatalog erkunden kann.

  %%{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

Voraussetzungen

Um Ihre In-Game-Artikel über den Bot zu verkaufen, müssen Sie:

1. Discord verwenden, um mit den Nutzern zu kommunizieren.
2. Einen vollständig konfigurierten Web Shop haben. Dies beinhaltet auch die Erstellung eines Artikelkatalogs, die Sie manuell, über die API oder durch Importieren von JSON-Dateien oder externen Plattformen durchführen können.
3. Die folgenden Webhooks konfigurieren, um Nutzer zu validieren und Käufe den Nutzern zu gewähren:
   • Benutzervalidierung im Web Shop
   • Erfolgreiche Zahlung für Bestellung
   • Bestellstornierung
4. Die Lizenzvereinbarung mit Xsolla unterzeichnen.

Einrichtung

Bot erstellen

1. Gehen Sie in Ihrem Projekt im Kundenportal zum Abschnitt Storefront > Xsolla Bot in Discord.
2. Klicken Sie auf Create.

3. Laden Sie das Logo hoch und geben Sie den Bot-Namen an.
4. Klicken Sie auf Create.
5. Gehen Sie zur Registerkarte Settings, um die Bot-Konfiguration abzuschließen:
   1. Klicken Sie im Block Player ID help configurator auf Set up und geben Sie kurze Anweisungen, wie Nutzer ihre Spieler-ID finden können. Diese wird in der Discord-Benutzeroberfläche angezeigt, sobald der Nutzer auf How to find player ID klickt.

2. Der API-Schlüssel wird automatisch generiert. Wenn Sie ihn aktualisieren möchten, klicken Sie auf Generate key.
3. Das Bot-Token wird automatisch generiert. Wenn Sie bereits einen Bot in Discord haben, klicken Sie auf Change und geben Sie dessen Token im entsprechenden Feld ein.

Anleitung zum Finden des Bot-Tokens in Discord

1. Gehen Sie zur Seite Ihrer Anwendung im Discord-Entwicklerportal.
2. Gehen Sie zum Abschnitt Overview > Bot.
3. Klicken Sie im Abschnitt Token auf Reset token. Möglicherweise werden Sie aufgefordert, eine Verifizierung durchzuführen.
4. Kopieren Sie den neuen Token-Wert.

Um zu überprüfen, ob Sie das Token erfolgreich hinzugefügt haben, laden Sie die Seite im Kundenportal neu. Wenn Sie einen Einladungslink oben auf der Seite sehen, war die Konfiguration erfolgreich. Folgen Sie diesem Link, um den Bot zu Ihrem Discord-Server hinzuzufügen.

4. Klicken Sie im Block User authentication webhook auf Change und geben Sie die Webhook-URL aus dem Abschnitt Project settings > Webhooks an.
5. Klicken Sie in der Zeile Web Shop URL auf Change. Geben Sie im sich öffnenden Modalfenster Ihre Web Shop-URL an und klicken Sie auf Save.

Sobald Sie alle erforderlichen Einstellungen konfiguriert haben, ändert sich der Bot-Status zu Aktiv.

Artikel konfigurieren

Um Artikel zum Verkauf zu konfigurieren:

1. Gehen Sie zur Registerkarte Shop und klicken Sie auf Build your shop.
2. Auf der Registerkarte Shop items:
   1. Laden Sie das Shop-Coverbild hoch.
   2. Geben Sie den Shop-Titel an (erforderlich).
   3. Markieren Sie die Kontrollkästchen neben den Artikeln, die Sie über Discord verkaufen möchten (erforderlich).
   4. Klicken Sie auf Confirm.

Danach können Sie zu Ihrem Discord-Server gehen, um zu überprüfen, ob der Bot korrekt funktioniert.

Belohnungsartikel konfigurieren

Um Nutzer zu motivieren, Ihren Shop häufiger zu besuchen, können Sie die folgenden Belohnungen einrichten:

• Anmeldebelohnung – Belohnungen, die dem Nutzer zur Verfügung stehen, wenn er sich zum ersten Mal im Shop anmeldet.
• Tägliche Belohnungen – exklusive Artikel, die einmal pro Tag beansprucht werden können.

Um dies einzurichten:

1. Gehen Sie zur Registerkarte Shop und klicken Sie auf Build your shop.

2. Belohnungsartikel einrichten:
   1. Wählen Sie auf der Registerkarte Login rewards einen kostenlosen Artikel aus und klicken Sie auf Confirm.
   2. Wählen Sie auf der Registerkarte Daily rewards kostenlose Artikel aus und klicken Sie auf Confirm. Um die Artikel in der richtigen Reihenfolge anzuordnen, ziehen Sie sie auf der Hauptseite der Einstellungen per Drag & Drop.

Danach können Sie zu Ihrem Discord-Server gehen, um zu überprüfen, ob der Bot korrekt funktioniert.