Платформы • ВКонтакте

Что понадобится

Учётная запись администратора сообщества ВКонтакте, в котором будет опубликовано мини-приложение.

Доступ к кабинету разработчика VK для создания или редактирования мини-приложения.

Права на настройку приложения в личном кабинете Sunblaze (раздел «Настройки → Платформы»).

Шаг 1. Откройте кабинет разработчика VK

1. Перейдите на сайт VK
   Откройте в браузере страницу управления приложениями: https://vk.com/apps?act=manage — или портал документации https://dev.vk.com/ и раздел «Мои приложения».
2. Войдите под нужным аккаунтом
   Используйте учётную запись, у которой есть права администратора сообщества, где будет размещено мини-приложение.

Шаг 2. Создайте или выберите мини-приложение

1. Создайте приложение
   Нажмите «Создать приложение» и выберите тип «Мини-приложение» (Mini App). Если приложение уже есть — откройте его из списка.
2. Привяжите к сообществу
   Убедитесь, что мини-приложение связано с вашим сообществом — без этого пользователи не смогут его открыть из VK.

Шаг 3. Скопируйте защищённый ключ

1. Откройте раздел «Настройки → Разработка»
   В карточке мини-приложения перейдите в «Настройки», затем в подраздел «Разработка» (Development).
2. Найдите поле «Защищённый ключ»
   Скопируйте значение поля «Защищённый ключ» (Secret key / Protected key). Этот ключ используется для проверки подписи параметров запуска и не должен публиковаться во фронтенде мини-приложения.

Шаг 4. Подключите платформу в Sunblaze

1. Откройте настройки платформ
   Войдите в личный кабинет Sunblaze → выберите приложение → «Настройки → Платформы» (/admin/settings/platforms).
2. Подключите ВКонтакте
   В строке «ВКонтакте» нажмите «Подключить» (или откройте строку для редактирования).
3. Вставьте защищённый ключ
   В поле «Защищённый ключ VK» вставьте скопированное значение из кабинета VK. Выберите статус подключения и сохраните настройки.
4. Скопируйте ссылку подключения
   После сохранения система сгенерирует токен и ссылку для подключения (вида https://v.sbaps.ru/?token=…). Также в форме появится поле «URL мини-приложения» — его адрес нужно указать в кабинете VK.

Шаг 5. Укажите URL в кабинете VK

1. Откройте настройки адресов приложения
   В кабинете разработчика VK вернитесь в «Настройки» мини-приложения — раздел с адресами для мобильной версии, десктопной версии и приложения VK.
2. Вставьте URL из Sunblaze
   В поля URL мини-приложения вставьте адрес из поля «URL мини-приложения» в Sunblaze (он генерируется автоматически после подключения платформы). Сохраните изменения в VK.

Шаг 6. Проверьте работу

Откройте мини-приложение из вашего сообщества ВКонтакте. Клиентское приложение должно загрузиться без ошибок авторизации.

Если приложение не открывается, проверьте: совпадает ли URL в VK с адресом из Sunblaze; верен ли защищённый ключ; активен ли статус подключения платформы.

Официальная документация VK