艾克索拉Discord机器人

概述

该Bot直接在您的Discord服务器中运行，用户无需离开Discord环境即可登录、领取奖励并完成购买。此外，该Bot还支持向频道发送外部消息。

Discord中的用户流程如下：

1. 用户在Bot已连接的任意频道中输入/shop。商店仅会显示给使用该命令的用户⸺频道中的其他用户不可见。

2. 用户使用自己的玩家ID登录。
3. 用户浏览商品目录。
4. 用户点击所需商品旁边的购买按钮。
5. 用户被重定向到支付UI。
6. 支付成功后，用户返回Discord频道，商品会在游戏中发放给该用户。

如果用户想浏览其他商品，可以点击按钮打开网页商城。Bot会将用户重定向到网页商城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

先决条件

要使用Bot销售游戏内商品，您需要：

1. 使用Discord与用户沟通。
2. 拥有一个已完成配置的网页商城。这也包括创建商品目录，您可以手动、通过API，或从JSON文件或外部平台导入商品目录。
3. 配置以下Webhook，以验证用户并向用户发放购买的商品：
   • 网页商城中的用户验证
   • 订单成功支付
   • 订单取消
4. 签署与艾克索拉的许可协议。

设置方法

创建Bot

1. 在发布商帐户的项目中，前往商店 > 艾克索拉Discord机器人部分。
2. 点击创建。

3. 上传Logo并指定Bot名称。
4. 点击创建。
5. 前往设置选项卡，完成Bot配置：
   1. 在Player ID help configurator区块中，点击Set up，并简要说明用户如何查找自己的玩家ID。当用户点击How to find player ID时，该说明会显示在Discord UI中。

2. API密钥会自动生成。如需更新，请点击Generate key。
3. Bot令牌会自动生成。如果您已在Discord中创建Bot，请点击Chang，并在相应字段中填写该Bot的令牌。

在Discord中查找Bot令牌的说明

1. 前往Discord开发者门户中的应用程序页面。
2. 前往Overview > Bot部分。
3. 在Token部分，点击Reset token。系统可能会要求您完成验证。
4. 复制新的令牌值。

要检查令牌是否添加成功，请在发布商帐户中重新加载页面。如果页面顶部显示邀请链接，则表示配置成功。点击该链接即可将Bot添加到您的Discord服务器。

4. 在User authentication webhook区块中，点击Change，并指定项目设置 > Webhooks部分的Webhook URL。
5. 在Web Shop URL行中，点击Change。在打开的模态窗口中，指定您的网页商城URL，并点击Save。

完成所有必需设置后，Bot状态将变更为活动中。

配置商品

要配置待售商品：

1. 前往商店选项卡，并点击搭建您的商店。
2. 在商店商品选项卡中：
   1. 上传商店封面图。
   2. 指定商店标题（必填）。
   3. 勾选您希望通过Discord销售的商品旁边的复选框（必填）。
   4. 点击确认。

之后，您可以前往自己的Discord服务器，检查Bot是否正常运行。

配置奖励商品

为了激励用户更频繁地访问您的商店，您可以设置以下奖励：

• 登录奖励⸺用户首次登录商店时可领取的奖励。
• 每日奖励⸺每天可领取一次的专属商品。

设置步骤如下：

1. 前往商店选项卡，并点击搭建您的商店。

2. 设置奖励商品：
   1. 在登录奖励选项卡中，选择一个免费商品，并点击确认。
   2. 在每日奖励选项卡中，选择免费商品并点击确认。要按正确顺序重新排列商品，请在主设置页面拖放这些商品。

之后，您可以前往自己的Discord服务器，检查Bot是否正常运行。