Xsolla Bot в Discord

Основная информация

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

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

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

2. Пользователь авторизуется в магазине с помощью ID игрока.
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. В проекте в Личном кабинете перейдите в раздел Каналы продаж > Xsolla Bot в Discord.
2. Нажмите Создать.

3. Загрузите логотип и укажите название бота.
4. Нажмите Создать.
5. Перейдите на вкладку Настройки, чтобы завершить настройку бота:
   1. В блоке Мастер настройки ID игрока нажмите Настроить и укажите краткую инструкцию по поиску ID в игре. Эта подсказка будет отображаться в интерфейсе Discord после того, как пользователь нажмет How to find player ID.

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

Как получить токен бота в Discord

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

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

4. В блоке Вебхук аутентификации нажмите Изменить и укажите URL-адрес сервера для получения вебхуков из раздела Настройки проекта > Вебхуки.
5. В строке Web Shop URL нажмите Изменить. В открывшемся модальном окне укажите URL-адрес вашего Web Shop и нажмите Сохранить.

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

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

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

1. Перейдите на вкладку Магазин и нажмите Настройте ваш магазин.
2. На вкладке Товары в магазине:
   1. Загрузите изображение для шапки магазина.
   2. Укажите название магазина (обязательно).
   3. Установите флажки рядом с товарами, которые вы хотите продавать через Discord (обязательно).
   4. Нажмите Подтвердить.

После этого вы можете перейти на ваш сервер Discord, чтобы проверить работу бота.

Настройка наград

Чтобы мотивировать пользователей чаще посещать ваш магазин, вы можете настроить следующие награды:

• Награда за вход — награды, которые становятся доступны пользователю при первом входе в магазин.
• Ежедневные награды — эксклюзивные товары, которые можно получить один раз в день.

Чтобы настроить награды:

1. Перейдите на вкладку Магазин и нажмите Настройте ваш магазин.

2. Настройте награды:
   1. На вкладке Награды за вход выберите бесплатный товар и нажмите Подтвердить.
   2. На вкладке Ежедневные награды выберите бесплатные товары и нажмите Подтвердить. Чтобы расположить товары в правильном порядке, перетащите их на главной странице настроек.

После этого вы можете перейти на ваш сервер Discord, чтобы проверить работу бота.