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. В блоке Селектор интерфейса нажмите Изменить. Выберите способ отображения товаров в магазине и нажмите Сохранить:
   • Выпадающий список (по умолчанию) — в магазине отображается раскрывающийся список с доступными товарами. Чтобы купить товар, пользователь сначала выбирает товар из списка, переходит в карточку товара и затем нажимает кнопку покупки.
   • Кнопки покупки — в магазине отображается сразу весь список товаров и рядом с каждым из них — кнопка для перехода к оплате товара.
3. Ключ API генерируется автоматически. Если вы хотите обновить его, нажмите Сгенерировать ключ.
4. Токен бота генерируется автоматически. Если у вас уже есть бот в Discord, нажмите Изменить, укажите токен в соответствующем поле и нажмите Изменить. Обратите внимание, что после сохранения изменений нельзя будет вернуться к использованию предыдущего токена.

Как найти токен бота в Discord

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

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

Чтобы добавить бота в ваш сервер Discord, перейдите по ссылке-приглашению в верхней части страницы.

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

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

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

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

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

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

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

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

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

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

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