Xsolla Bot in Discord

Überblick

Der Bot läuft direkt auf Ihrem Discord-Server und ermöglicht es den Nutzern, sich anzumelden, Belohnungen zu sichern und Käufe zu tätigen, ohne Discord verlassen zu müssen. Darüber hinaus unterstützt der Bot das Versenden von Nachrichten an Kanäle.

Ablauf für den Nutzer auf Discord:

1. Der Nutzer gibt in einem beliebigen Kanal, in dem der Bot eingebunden ist, den Befehl /shop ein. Der Shop wird nur genau dem Nutzer angezeigt, der den Befehl eingegeben hat – andere Nutzer im Kanal sehen den Shop nicht.

2. Der Nutzer meldet sich mit seiner Spieler-ID an.
3. Der Nutzer durchstöbert 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.

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

Folgende Voraussetzungen müssen erfüllt sein, bevor Sie Ingame-Items mit dem Bot verkaufen:

1. Verwenden Sie Discord zur Kommunikation mit den Nutzern.
2. Erstellen Sie einen Artikelkatalog, entweder manuell, über die API oder durch den Import aus JSON-Dateien oder von externen Plattformen.
3. Konfigurieren Sie die folgenden Webhooks, um Nutzer zu validieren und Käufe zu gewähren:
   • Benutzervalidierung
   • Erfolgreiche Bezahlung der Bestellung
   • Stornierung der Bestellung
4. Unterzeichnen Sie die Xsolla-Lizenzvereinbarung.

Einrichtung

Bot erstellen

1. Navigieren Sie in Ihrem Kundenportal-Projekt zum Menüpunkt Storefront > Xsolla Bot in Discord.
2. Klicken Sie auf Erstellen.

3. Laden Sie ein Logo hoch, und vergeben Sie einen Namen für den Bot.
4. Klicken Sie auf Erstellen.
5. Wechseln Sie zur Registerkarte Einstellungen, um die Bot-Konfiguration abzuschließen:
   1. Klicken Sie im Block Spieler-ID-Hilfe-Konfigurator auf Einrichten, und beschreiben Sie kurz, wie Nutzer ihre Spieler-ID finden können. Die Anleitung wird auf der Discord-Benutzeroberfläche angezeigt, sobald der Nutzer auf So findest du die Spieler-ID klickt.

2. Der API-Schlüssel wird automatisch generiert. Wenn Sie ihn aktualisieren möchten, klicken Sie auf Schlüssel generieren.
3. Der Bot-Token wird automatisch generiert. Wenn Sie bereits einen Bot auf Discord haben, klicken Sie auf Ändern, und geben Sie den Token im entsprechenden Feld ein.

Anleitung zum Finden des Bot-Tokens auf Discord

1. Öffnen Sie im Discord-Entwicklerportal die Seite Ihrer Anwendung.
2. Navigieren Sie zum Menüpunkt Übersicht > Bot.
3. Scrollen Sie zum Abschnitt Token, und klicken Sie auf Token zurücksetzen. Möglicherweise werden Sie aufgefordert, sich zu verifizieren.
4. Kopieren Sie den neuen Tokenwert.

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

4. Klicken Sie im Block Benutzerauthentifizierungs-Webhook auf Ändern, und geben Sie die Webhook-URL aus dem Abschnitt Projekteinstellungen > Webhooks ein.
5. Wenn Sie Ihren Web Shop nicht verknüpfen müssen, können Sie den Block Web Shop URL unverändert lassen.

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

Artikel konfigurieren

So konfigurieren Sie Artikel für den Verkauf:

1. Wechseln Sie zur Registerkarte Shop, und klicken Sie auf Shop erstellen.
2. Gehen Sie auf der Registerkarte Artikel im Shop wie folgt vor:
   1. Laden Sie ein Cover-Bild für den Shop hoch.
   2. Vergeben Sie einen Titel für den Shop (erforderlich).
   3. Markieren Sie die Kästchen neben den Artikeln, die Sie über Discord verkaufen möchten (erforderlich).
   4. Klicken Sie auf Bestätigen.

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

Belohnungsartikel konfigurieren

Damit Nutzer Ihren Shop häufiger besuchen, können Sie folgende Belohnungen einrichten:

• Login-Belohnung: Belohnungen, die der Nutzer erhält, wenn er sich zum ersten Mal im Shop anmeldet.
• Tägliche Belohnungen: exklusive Artikel, die der Nutzer einmal pro Tag erhalten kann.

Einrichtung:

1. Wechseln Sie zur Registerkarte Shop, und klicken Sie auf Shop erstellen.

2. Richten Sie Belohnungsartikel ein:
   1. Wählen Sie auf der Registerkarte Login-Belohnung einen kostenlosen Artikel aus, und klicken Sie auf Bestätigen.
   2. Wählen Sie auf der Registerkarte Tägliche Belohnungen kostenlose Artikel aus, und klicken Sie auf Bestätigen. Auf der Hauptseite der Einstellungen können Sie die Artikel per Drag-and-drop verschieben und so in die gewünschte Reihenfolge bringen.

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