Xsolla Bot в Discord

Обзор

Бот работает непосредственно на вашем сервере Discord и позволяет пользователям входить в систему, получать награды и совершать покупки, не покидая среды Discord. Кроме того, бот поддерживает исходящие сообщения в каналы.

Сценарий пользователя в Discord:

1. Пользователь вводит /shop в любом канале, к которому подключен бот. Магазин появляется только у пользователя, который использовал команду — другие пользователи в канале его не увидят.

2. Пользователь входит в систему, используя свой идентификатор игрока.
3. Пользователь просматривает каталог.
4. Пользователь нажимает кнопку покупки рядом с нужным товаром.
5. Пользователь перенаправляется на платёжный интерфейс.
6. После успешного платежа пользователь возвращается в канал Discord, и товар предоставляется пользователю в игре.

Если пользователь хочет просмотреть другие товары, он может нажать кнопку для открытия Web Shop. Бот перенаправит пользователя на URL Web Shop, где он сможет изучить весь каталог товаров.

  %%{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. Подписать лицензионное соглашение с Xsolla.

Как настроить

Создание бота

1. В вашем проекте в Личном кабинете перейдите в раздел Storefront > Xsolla Bot in Discord.
2. Нажмите Create.

3. Загрузите логотип и укажите имя бота.
4. Нажмите Create.
5. Перейдите на вкладку Settings, чтобы завершить настройку бота:
   1. В блоке Player ID help configurator нажмите Set up и предоставьте краткие инструкции о том, как пользователи могут найти свой идентификатор игрока. Они будут отображаться в интерфейсе Discord после того, как пользователь нажмет How to find player ID.

2. Ключ API генерируется автоматически. Если вы хотите обновить его, нажмите Generate key.
3. Токен бота генерируется автоматически. Если у вас уже есть бот в Discord, нажмите Change и укажите его токен в соответствующем поле.

Инструкции по поиску токена бота в Discord

1. Перейдите на страницу вашего приложения в портале разработчиков Discord.
2. Перейдите в раздел Overview > Bot.
3. В разделе Token нажмите Reset token. Возможно, вам потребуется пройти проверку.
4. Скопируйте новое значение токена.

Чтобы проверить, успешно ли вы добавили токен, перезагрузите страницу в Личном кабинете. Если вы видите ссылку-приглашение в верхней части страницы, конфигурация успешна. Перейдите по этой ссылке, чтобы добавить бота на ваш сервер Discord.

4. В блоке User authentication webhook нажмите Change и укажите URL вебхука из раздела Project settings > Webhooks.
5. В строке Web Shop URL нажмите Change. В открывшемся модальном окне укажите URL вашего Web Shop и нажмите Save.

После настройки всех необходимых параметров статус бота изменится на Активен.

Настройка товаров

Чтобы настроить товары для продажи:

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, чтобы проверить, правильно ли работает бот.