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

Общая информация

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

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

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

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

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

• подписанное лицензионное соглашение с Xsolla

• настроенный каталог предметов с уже созданными виртуальными предметами и отмеченными как доступные

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

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

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

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

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

Внимание

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

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

2. Нажмите Создать. Период ожидания отсутствует, интерфейс конфигурации доступен сразу.

3. Назовите вашего бота и, при необходимости, добавьте логотип.

4. Нажмите Создать.

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

Внимание

Разделы Ежедневные награды и Товары магазина требуют заголовка. Эти поля не могут быть пустыми.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Расширьте ваши награды: Настройте Награды за вход и Ежедневные награды в разделе Магазин, чтобы добавить элементы вовлечения прямо из Discord.

• Web Shop + Pay Station: Если ваша настройка требует, чтобы игроки проходили через Web Shop перед оформлением заказа, этот процесс доступен. Свяжитесь с командой Xsolla, чтобы настроить это для вашего проекта.