Discordでのエクソーラボット設定ガイド

概要

Discordは、ゲームコミュニティがセッションの合間に時間を過ごし、調整し、アップデートを共有し、繋がりを保つ主要なスペースの一つです。Discord内のエクソーラボットは、ストアフロントを直接サーバーに持ち込み、プレイヤーがアイテムを閲覧し、報酬を受け取り、Discordを離れることなくスラッシュコマンドを通じて購入を完了できるようにします。

このガイドでは、Discord開発者ポータルでのボットアプリケーションの作成、エクソーラパブリッシャーアカウントへの接続、ストアと報酬の設定、プレイヤー向けの体験のテストまで、完全なセルフサービス設定を説明します。

このガイドを終えると、Discordサーバー内で動作するエクソーラボットが完成します。プレイヤーは/shopコマンドでストアフロントを開き、ゲーム内のプレイヤーIDでログインし、エクソーラ決済UIを通じて購入を完了できます。

ガイドでは、参考としてJ-Clashというサンプルプロジェクトを使用していますが、手順はアクティブなアイテムカタログを持つ任意のプロジェクトに適用されます。

前提条件

エクソーラ側で必要なもの：

• パブリッシャーアカウントでのアクティブなプロジェクト
• エクソーラとの署名済みライセンス契約
• 仮想アイテムが既に作成され、利用可能としてマークされたアイテムカタログの設定

Discord側で必要なもの：

• ボットアプリケーションを作成するためのDiscord開発者ポータルへのアクセス（オプション）

利用可能な購入フロー

Discord内のエクソーラボットは2つの購入フローをサポートしています。違いを理解することで、プロジェクトに適したものを選択できます：

• 直接購入。 プレイヤーがアイテムを選択すると、エクソーラ決済UIが即座に起動し、アイテムがチェックアウトの準備が整います。中間ステップやリダイレクトはありません。これがデフォルトのフローであり、このガイドでカバーされています。
• ウェブショップフロー。 プレイヤーがアイテムを選択すると、ユーザーログインとアイテムが事前入力された状態でウェブショップが開き、その後エクソーラ決済UIが起動します。このフローには、既に設定されたウェブショップと、ボット設定で構成されたウェブショップURLが必要です。詳細情報はこちらの手順を参照してください。

設定手順

ステップ 1. Discordボットアプリケーションの作成

1. Discord開発者ポータルにアクセスし、New Applicationをクリックします。
2. ゲームやブランドを反映した名前をボットに付けます。このデモではNewBotを使用しています。
3. アプリケーションが作成されたら、Botセクションを開きます。ここでアイコンやバナーをアップロードするのが良いタイミングです。これらはDiscord内でボットがアクティブなときにプレイヤーに表示されます。

4. Discordアプリケーションをエクソーラ設定にリンクするボットトークンを取得します：
   1. Botセクションで、Reset Tokenをクリックします。これがトークンを表示する唯一の方法です。
   2. トークンをすぐにコピーし、安全な場所に保管します。ステップ 2で必要になります。

お知らせ

ボットトークンは一度しか表示されません。紛失した場合は、このページに戻って新しいトークンを生成し、パブリッシャーアカウントで更新してください。ボットトークンを公開したり共有したりしないでください。

ステップ 2. パブリッシャーアカウントでのボット設定

1. パブリッシャーアカウントのプロジェクトで、Storefront > Xsolla Bot in Discordセクションに移動します。
2. Createをクリックします。待ち時間はなく、設定UIがすぐに利用可能です。
3. ボットに名前を付け、オプションでロゴを追加します。
4. Createをクリックします。

5. Shopセクションを開き、以下を設定します：
   • ログイン報酬 — プレイヤーが初めてログインしたときに授与されるアイテム。
   • デイリー報酬 — 毎日授与されるアイテム。
   • ショップアイテム — 購入可能なアイテム。

お知らせ

デイリー報酬とショップアイテムセクションにはセクションタイトルが必要です。これらのフィールドは空白にできません。

6. Settingsタブに移動してボット設定を完了します：

   1. Player ID helpを設定します。ボットは各プレイヤーのゲーム内プレイヤーIDをログイン方法として使用します。各ゲームがそのIDを異なる方法で表示するため、プレイヤーが特定のゲームでそれを見つける方法を示す画像をアップロードします。プレイヤーはDiscord内からいつでもこの画像にアクセスできます。
   2. APIキーはデフォルトで自動的に生成されます。アクションは不要です。
   3. ボットトークンを指定します。Discord開発者ポータルからコピーしたトークンをステップ 1で貼り付けます。これにより、Discordボットアプリケーションがエクソーラボットに接続されます。
   4. ユーザー認証ウェブフックを指定します。ゲーム内プレイヤーIDを使用してプレイヤーを識別および認証するバックエンドのエンドポイントです。このウェブフックは自分で設定し、ホストします。

7. 直接購入フローを使用している場合、Web Shop URLフィールドは空白のままにします。このフィールドはウェブショップフローを使用している場合にのみ必要です。

ステップ 3. Discordサーバーへのボット招待

ボットをDiscordサーバーに追加するには：

1. Xsolla Bot in Discordセクションのページ上部で、Inviteをクリックします。

2. 要求された権限を確認し、承認します。

ボットはサーバーに接続されました。

ステップ 4. /shopコマンドのテスト

サーバーでボットがライブになったら、Discordを開いて/shopを実行します。これは主なプレイヤー向けコマンドであり、統合が正しく機能していることを確認する最も明確な方法です。

ストアUIは以下の順序で読み込まれます：

1. 設定したPlayer ID helpセクション。プレイヤーが報酬を受け取ったり購入を行う前に、ログインする必要があります。いずれかのオプションと対話するとすぐに、プレイヤーIDの入力を求められます。成功すると、UIはすぐにログイン状態を反映するように更新されます。
2. 設定したログインまたはデイリー報酬。
3. 設定した名前とアイテムを持つShopセクション。

プレイヤーが報酬を受け取ったり購入を行う前に、ログインする必要があります。いずれかのオプションと対話するとすぐに、プレイヤーIDの入力を求められます。成功すると、インターフェースはすぐにログイン状態を反映するように更新されます。直接購入フローでは、アイテムを選択するとすぐに決済UIが起動し、アイテムがチェックアウトの準備が整います。

次のステップ

これで、Discordでのエクソーラボットの完全なセルフサービス設定が完了しました。Discord開発者ポータルからサーバー内の動作するストアフロントまで、全プロセスは数分で完了します。

ここからさらに進めるためのいくつかの方向性：

• 報酬を拡大する: Shopセクションでログイン報酬とデイリー報酬を設定し、Discordから直接エンゲージメントフックを追加します。
• ストアをカスタマイズする: パブリッシャーアカウントでアイテム選択、セクションタイトル、Player ID help画像をいつでも更新できます。ボットを再招待する必要はありません。
• ウェブショップ＋ペイステーション: チェックアウト前にプレイヤーがウェブショップを通過する必要がある場合、このフローが利用可能です。プロジェクトの設定についてはエクソーラチームにお問い合わせください。