Xsolla Bot в Discord

Обзор

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

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

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

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

  %%{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. Настроить следующие вебхуки для проверки существования пользователей и предоставления покупок пользователям:
   • Проверка существования пользователя
   • Успешный платеж за заказ
   • Отмена заказа
4. Подписать лицензионное соглашение с Xsolla.

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

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

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

3. Загрузите логотип и укажите имя бота.
4. Нажмите Create.
5. Перейдите на вкладку Settings для завершения настройки бота:
   1. В блоке Player ID help configurator нажмите Set up и предоставьте краткие инструкции о том, как пользователи могут найти свой ID игрока. Они будут отображаться в интерфейсе 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, оставьте блок Web Shop URL без изменений.

После настройки всех необходимых параметров статус бота изменится на 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, чтобы проверить, работает ли бот правильно.