Xsolla Bot in Discord

Überblick

Der Bot arbeitet direkt in Ihrem Discord-Server und ermöglicht es Benutzern, 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 Benutzer gibt /shop in einem Kanal ein, in dem der Bot verbunden ist. Der Shop erscheint nur für den Benutzer, der den Befehl verwendet hat – andere Benutzer im Kanal sehen ihn nicht.

2. Der Benutzer meldet sich mit seiner Spieler-ID an.
3. Der Benutzer durchsucht den Katalog.
4. Der Benutzer klickt auf die Kaufen-Schaltfläche neben dem gewünschten Artikel.
5. Der Benutzer wird zum Zahlungsportal weitergeleitet.
6. Nach erfolgreicher Zahlung kehrt der Benutzer zum Discord-Kanal zurück, und der Artikel wird dem Benutzer 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

Um Ihre In-Game-Artikel mit dem Bot zu verkaufen, benötigen Sie:

1. Verwenden Sie Discord, um mit Benutzern zu kommunizieren.
2. Erstellen Sie einen Artikelkatalog. Sie können dies manuell, über die API oder durch Importieren von JSON-Dateien oder externen Plattformen tun.
3. Konfigurieren Sie die folgenden Webhooks, um Benutzer zu validieren und Käufe zu gewähren:
   • Benutzervalidierung
   • Erfolgreiche Zahlung für Bestellung
   • Bestellstornierung
4. Unterzeichnen Sie die Lizenzvereinbarung mit Xsolla.

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 Settings-Registerkarte, um die Bot-Konfiguration abzuschließen:
   1. Klicken Sie im Block Player ID help configurator auf Set up und geben Sie prägnante Anweisungen, wie Benutzer ihre Spieler-ID finden können. Diese wird in der Discord-Benutzeroberfläche angezeigt, sobald der Benutzer 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 müssen Sie eine Verifizierung durchfü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 oben auf der Seite einen Einladungslink 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. Wenn Sie Ihren Web Shop nicht verbinden müssen, lassen Sie den Block Web Shop URL unverändert.

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

Artikel konfigurieren

Um Artikel zum Verkauf zu konfigurieren:

1. Gehen Sie zur Shop-Registerkarte und klicken Sie auf Build your shop.
2. Auf der Shop items-Registerkarte:
   1. Laden Sie das Shop-Cover-Bild hoch.
   2. Geben Sie den Shop-Titel an (erforderlich).
   3. Markieren Sie die Kä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 Benutzer zu motivieren, Ihren Shop häufiger zu besuchen, können Sie die folgenden Belohnungen einrichten:

• Anmeldebelohnung – Belohnungen, die dem Benutzer 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 Shop-Registerkarte und klicken Sie auf Build your shop.

2. Richten Sie Belohnungsartikel ein:
   1. Wählen Sie auf der Login rewards-Registerkarte einen kostenlosen Artikel aus und klicken Sie auf Confirm.
   2. Wählen Sie auf der Daily rewards-Registerkarte 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.