艾克索拉Discord机器人

概述

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

在Discord中的用户流程：

1. 用户在机器人连接的任何频道中输入/shop。商店会显示给使用该命令的用户——频道中的其他用户不会看到。

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

如果用户想浏览其他商品，可以点击按钮打开网页商城。机器人会将用户重定向到网页商城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. 拥有一个完全配置的网页商城。这也包括您可以手动、通过API或从JSON文件或外部平台导入的商品目录创建。
3. 配置以下webhooks以验证用户并向用户授予购买：
   • 网页商城中的用户验证
   • 订单的成功支付
   • 订单取消
4. 与艾克索拉签署许可协议。

如何设置

创建机器人

1. 在您的项目的发布商帐户中，进入Storefront > Xsolla Bot in Discord部分。
2. 点击Create。

3. 上传Logo并指定机器人名称。
4. 点击Create。
5. 进入Settings选项卡完成机器人配置：
   1. 在Player ID help configurator块中，点击Set up并提供用户如何找到其玩家ID的简要说明。当用户点击How to find player ID时，它将在Discord用户界面中显示。

2. API密钥会自动生成。如果您想更新它，点击Generate key。
3. 机器人令牌会自动生成。如果您已经在Discord中有一个机器人，点击Change并在相应字段中提供其令牌。

在Discord中查找机器人令牌的说明

1. 进入Discord开发者门户中的应用页面。
2. 进入Overview > Bot部分。
3. 在Token部分，点击Reset token。您可能需要通过验证。
4. 复制新的令牌值。

要检查您是否成功添加了令牌，请在发布商帐户中重新加载页面。如果您在页面顶部看到邀请链接，配置即成功。按照此链接将机器人添加到您的Discord服务器。

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

一旦您配置了所有必需的设置，机器人的状态将更改为Active。

配置商品

要配置出售的商品：

1. 进入Shop选项卡并点击Build your shop。
2. 在Shop items选项卡上：
   1. 上传商店封面图片。
   2. 指定商店标题（必填）。
   3. 勾选您想通过Discord出售的商品旁边的框（必填）。
   4. 点击Confirm。

之后，您可以进入您的Discord服务器检查机器人是否正常工作。

配置奖励商品

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

• 登录奖励——用户首次登录商店时可获得的奖励。
• 每日奖励——每天可领取一次的独家商品。

设置方法：

1. 进入Shop选项卡并点击Build your shop。

2. 设置奖励商品：
   1. 在Login rewards选项卡上，选择一个免费商品并点击Confirm。
   2. 在Daily rewards选项卡上，选择免费商品并点击Confirm。要在正确的顺序中重新排列商品，请在主设置页面上拖放它们。

之后，您可以进入您的Discord服务器检查机器人是否正常工作。