Discordのエクソーラボット

概要

このボットは、Discordサーバー内で直接動作し、ユーザーがDiscord環境を離れることなくサインイン、報酬の受け取り、購入を行えるようにします。さらに、ボットはチャンネルへのアウトバウンドメッセージもサポートしています。

Discordでのユーザーフロー：

1. ユーザーは、ボットが接続されている任意のチャンネルで/shopと入力します。ショップはコマンドを使用したユーザーにのみ表示され、他のユーザーには表示されません。

2. ユーザーはプレイヤーIDでログインします。
3. ユーザーはカタログを閲覧します。
4. ユーザーは希望するアイテムの横にある購入ボタンをクリックします。
5. ユーザーは決済UIにリダイレクトされます。
6. 支払いが成功すると、ユーザーはDiscordチャンネルに戻り、ゲーム内でアイテムがユーザーに付与されます。

他のアイテムを閲覧したい場合は、Web Shopを開くボタンをクリックできます。ボットはユーザーをWeb ShopのURLにリダイレクトし、ユーザーは全アイテムカタログを探索できます。

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

前提条件

ボットを使用してゲーム内アイテムを販売するには、以下が必要です：

1. Discordを使用してユーザーとコミュニケーションを取ること。
2. 完全に設定されたWeb Shopを持っていること。これには、手動、API、JSONファイルや外部プラットフォームからのインポートによるアイテムカタログの作成が含まれます。
3. ユーザーを検証し、購入をユーザーに付与するための以下のウェブフックを設定すること：
   • Web Shopでのユーザー検証
   • 注文の成功した支払い
   • 注文のキャンセル
4. エクソーラとのライセンス契約を締結すること。

設定方法

ボットの作成

1. パブリッシャーアカウントのプロジェクトで、Storefront > Xsolla Bot in Discordセクションに移動します。
2. Createをクリックします。

3. ロゴをアップロードし、ボット名を指定します。
4. Createをクリックします。
5. Settingsタブに移動し、ボットの設定を完了します：
   1. Player ID help configuratorブロックでSet upをクリックし、ユーザーがプレイヤーIDを見つける方法について簡潔な指示を提供します。ユーザーがHow to find player IDをクリックすると、Discord UIに表示されます。

2. APIキーは自動的に生成されます。更新したい場合は、Generate keyをクリックします。
3. ボットトークンは自動的に生成されます。すでにDiscordにボットがある場合は、Changeをクリックして、対応するフィールドにそのトークンを入力します。

Discordでのボットトークンの見つけ方

1. Discord developers portalでアプリケーションのページに移動します。
2. Overview > Botセクションに移動します。
3. TokenセクションでReset tokenをクリックします。確認を求められる場合があります。
4. 新しいトークンの値をコピーします。

トークンを正常に追加したか確認するには、パブリッシャーアカウントでページをリロードします。ページの上部に招待リンクが表示されていれば、設定は成功です。このリンクをクリックして、ボットをDiscordサーバーに追加します。

4. User authentication webhookブロックでChangeをクリックし、Project settings > WebhooksセクションからウェブフックURLを指定します。
5. Web Shop URL行でChangeをクリックします。開いたモーダルウィンドウでWeb Shop URLを指定し、Saveをクリックします。

すべての必要な設定を完了すると、ボットのステータスがActiveに変更されます。

アイテムの設定

販売するアイテムを設定するには：

1. Shopタブに移動し、Build your shopをクリックします。
2. Shop itemsタブで：
   1. ショップのカバー画像をアップロードします。
   2. ショップタイトルを指定します（必須）。
   3. Discordで販売したいアイテムの横にあるボックスにチェックを入れます（必須）。
   4. Confirmをクリックします。

その後、Discordサーバーに移動して、ボットが正しく動作するか確認できます。

報酬アイテムの設定

ユーザーがストアをより頻繁に訪れるよう促すために、以下の報酬を設定できます：

• ログイン報酬 — ストアに初めてログインした際にユーザーに提供される報酬。
• デイリー報酬 — 1日1回受け取れる限定アイテム。

設定するには：

1. Shopタブに移動し、Build your shopをクリックします。

2. 報酬アイテムを設定します：
   1. Login rewardsタブで無料アイテムを選択し、Confirmをクリックします。
   2. Daily rewardsタブで無料アイテムを選択し、Confirmをクリックします。正しい順序にアイテムを並べ替えるには、メイン設定ページでドラッグ＆ドロップします。

その後、Discordサーバーに移動して、ボットが正しく動作するか確認できます。