Настройка Xsolla Bot в Discord

Обзор

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

Это руководство описывает полный процесс самостоятельной настройки: создание приложения бота в портале разработчиков Discord, подключение его к вашему Личному кабинету Xsolla, настройка вашего магазина и наград, а также тестирование пользовательского опыта от начала до конца.

К концу этого руководства у вас будет работающий Xsolla Bot на вашем сервере Discord. Игроки смогут открыть storefront с помощью команды /shop, войти в систему с использованием своего игрового ID и завершить покупки через платежный интерфейс Xsolla.

В руководстве используется демонстрационный проект под названием J-Clash для примера, но шаги применимы к любому проекту с активным каталогом предметов.

Предварительные условия

На стороне Xsolla вам необходимо иметь следующее:

• активный проект в Личном кабинете
• подписанное лицензионное соглашение с Xsolla
• настроенный каталог предметов с виртуальными предметами, уже созданными и отмеченными как доступные

На стороне Discord вам необходимо иметь доступ к порталу разработчиков Discord для создания приложения бота (опционально).

Доступные потоки покупок

Xsolla Bot в Discord поддерживает два потока покупок. Понимание различий поможет вам решить, какой из них подходит для вашего проекта:

• Прямая покупка. Когда игрок выбирает предмет, платежный интерфейс Xsolla запускается сразу с готовым к оформлению предметом. Нет промежуточных шагов или перенаправлений. Это поток по умолчанию, который описан в этом руководстве.
• Поток Web Shop. Когда игрок выбирает предмет, открывается ваш Web Shop с предварительно заполненными данными пользователя и предметом, затем запускается платежный интерфейс Xsolla. Этот поток требует уже настроенного Web Shop и URL Web Shop, настроенного в настройках бота. Обратитесь к этим инструкциям для получения подробной информации.

Шаги настройки

Шаг 1. Создание приложения бота в Discord

1. Перейдите в портал разработчиков Discord и нажмите New Application.
2. Дайте боту имя, которое отражает вашу игру или бренд. Для этого демо мы используем NewBot.
3. После создания приложения откройте раздел Bot. Это хорошее время для загрузки иконки и баннера, так как они будут видны игрокам, когда бот активен в Discord.

4. Получите токен вашего бота, который связывает ваше приложение Discord с конфигурацией Xsolla:
   1. В разделе Bot нажмите Reset Token. Это единственный способ, которым Discord позволяет вам просмотреть токен.
   2. Скопируйте токен сразу и сохраните его в безопасном месте. Он понадобится вам на Шаге 2.

Внимание

Токен бота можно просмотреть только один раз. Если вы его потеряли, вернитесь на эту страницу и сгенерируйте новый, а затем обновите его в Личном кабинете. Никогда не передавайте и не раскрывайте свой токен бота публично.

Шаг 2. Настройка бота в Личном кабинете

1. В вашем проекте в Личном кабинете перейдите в раздел Storefront > Xsolla Bot в Discord.
2. Нажмите Create. Период ожидания отсутствует, интерфейс конфигурации доступен сразу.
3. Назовите вашего бота и, при необходимости, добавьте логотип.
4. Нажмите Create.

5. Откройте раздел Shop, чтобы настроить следующее:
   • Награды за вход — предметы, выдаваемые при первом входе игрока.
   • Ежедневные награды — предметы, выдаваемые ежедневно.
   • Предметы магазина — предметы, доступные для покупки.

Внимание

Для разделов Daily rewards и Shop items обязательны заголовки. Эти поля нельзя оставить пустыми.

6. Перейдите на вкладку Settings, чтобы завершить настройку бота:

   1. Настройте Player ID help. Бот использует игровой ID каждого игрока в качестве метода входа. Поскольку каждая игра отображает этот ID по-разному, загрузите изображение, показывающее игрокам, как его найти в вашей конкретной игре. Игроки могут получить доступ к этому изображению из Discord в любое время, когда они открывают бота.
   2. Ключ API генерируется автоматически по умолчанию. Действий не требуется.
   3. Укажите токен бота. Вставьте токен, который вы скопировали из портала разработчиков Discord на Шаге 1. Это соединяет ваше приложение бота Discord с Xsolla Bot.
   4. Укажите вебхук аутентификации пользователя. Это конечная точка на вашем бэкенде, которая идентифицирует и аутентифицирует игроков, используя их игровой ID. Вы настраиваете и размещаете этот вебхук самостоятельно.

7. Если вы используете поток прямой покупки, оставьте поле Web Shop URL пустым. Это поле требуется только в случае использования потока Web Shop.

Шаг 3. Приглашение бота на ваш сервер Discord

Чтобы добавить бота на ваш сервер Discord:

1. В разделе Xsolla Bot в Discord в верхней части страницы нажмите Invite.

2. Просмотрите и одобрите запрашиваемые разрешения.

Бот теперь подключен к вашему серверу.

Шаг 4. Тестирование команды /shop

Когда бот активен на вашем сервере, откройте Discord и выполните команду /shop. Это основная команда, с которой взаимодействуют игроки, и выполнение ее — самый простой способ подтвердить, что интеграция работает правильно.

Интерфейс магазина загружается в следующем порядке:

1. Раздел Player ID help, который вы настроили. Прежде чем игрок сможет получить награды или совершить покупку, ему нужно войти в систему. Как только он взаимодействует с любой опцией, его просят ввести свой игровой ID. После успешного ввода интерфейс сразу обновляется, чтобы отразить его состояние входа.
2. Любые награды за вход или ежедневные награды, которые вы настроили.
3. Раздел Shop с именем и предметами, которые вы настроили.

Прежде чем игрок сможет получить награды или совершить покупку, ему нужно войти в систему. Как только он взаимодействует с любой опцией, его попросят ввести свой игровой ID. После успешного ввода интерфейс сразу обновляется, чтобы отразить его состояние входа. В потоке прямой покупки выбор предмета запускает платежный интерфейс сразу с готовым к оформлению предметом.

Следующие шаги

Это полная самостоятельная настройка Xsolla Bot в Discord. От портала разработчиков Discord до работающего storefront внутри вашего сервера весь процесс занимает всего несколько минут.

Несколько направлений для дальнейшего развития:

• Расширьте ваши награды: Настройте Login rewards и Daily rewards в разделе Shop, чтобы добавить элементы вовлечения прямо из Discord.
• Настройте ваш магазин: Обновляйте выбор предметов, названия разделов и изображения Player ID help в Личном кабинете в любое время — нет необходимости повторно приглашать бота.
• Web Shop + Pay Station: Если ваша настройка требует, чтобы игроки проходили через Web Shop перед оформлением заказа, этот поток доступен. Обратитесь к команде Xsolla, чтобы настроить это для вашего проекта.