SunBlazeВойти
Настройки

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

Пошагово: мини-приложение в кабинете разработчика VK, «Защищённый ключ» в Sunblaze, ссылка в «Размещении», включение для покупателей и проверка.

Открыть в кабинете →← К обзору

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

Аккаунт ВКонтакте и мобильное приложение ВКонтакте на телефоне: создание и важные изменения мини-приложения VK подтверждает push-уведомлением.

Доступ к кабинету Sunblaze с правом настраивать магазин.

15–20 минут.

Шаг 1. Создайте мини-приложение VK

  1. Откройте кабинет разработчика
    dev.vk.com → «Приложения» в верхнем меню → «Создать приложение» в левом меню.
  2. Выберите тип «Мини-приложение»
    Укажите название и категорию, нажмите «Создать» и подтвердите действие в мобильном приложении ВКонтакте.
  3. Запомните ID приложения
    После создания откроется «Панель управления приложением» — в ней указан ID приложения (число). Он пригодится на шаге 3.

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

Нужен именно «Защищённый ключ»

Рядом в кабинете VK есть «Сервисный ключ доступа» и ID приложения — их в Sunblaze не вставляйте: с ними покупатели не смогут войти в магазин. Защищённый ключ — короткая строка из латинских букв и цифр, сервисный ключ заметно длиннее.

  1. Откройте «Разработку»
    В мини-приложении: «Настройки» → «Разработка» → блок «Ключи доступа».
  2. Скопируйте «Защищённый ключ»
    Скопируйте значение поля «Защищённый ключ» целиком. После сохранения Sunblaze не показывает ключ — ни целиком, ни частично: в окне только отметка «Ключ сохранён».

Шаг 3. Подключите ВКонтакте в Sunblaze

Подсказка

Верность ключа VK нельзя проверить заранее: Sunblaze отклонит лишь то, чем защищённый ключ быть не может (ID приложения, сервисный ключ, значение с пробелом), а остальное покажет первый вход покупателя. В строке VK в «Каналах продаж» будет «Ждём первого входа», после входа — «Работает», а если подпись из VK не сходится несколько раз подряд — «Ключ не принят». Поэтому не пропускайте шаг 6.

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

Шаг 4. Вставьте ссылку в «Размещение»

  1. Откройте «Размещение»
    Кабинет VK: мини-приложение → «Настройки» → «Размещение».
  2. Вставьте ссылку в три поля
    Одну и ту же «Ссылку для подключения» — в поле «URL» каждого блока: «Десктопная версия сайта», «Мобильная версия сайта» и «Мобильное приложение». «Режим разработки» не включайте.
  3. Сохраните
    Если VK попросит, подтвердите изменения в мобильном приложении ВКонтакте.

Шаг 5. Откройте приложение покупателям

По умолчанию мини-приложение видят только вы и администраторы. В «Настройки» → «Размещение» переключите «Состояние для пользователей» на «Включено».

Подсказка

Чтобы проверить магазин до запуска, добавьте знакомого администратором приложения с правом «Тестирование» — тогда «Состояние для пользователей» можно пока не включать.

Шаг 6. Проверьте вход покупателя

  1. Откройте приложение с другого аккаунта
    Откройте vk.com/app<ID приложения> под аккаунтом, который не администрирует приложение. Витрина должна открыться без ошибок входа.
  2. Проверьте состояние в Sunblaze
    В «Каналах продаж» у ВКонтакте вместо «Ждём первого входа» должно появиться «Работает».
  3. Сделайте тестовый заказ
    Заказ появится в кабинете в «Заказах».

Уведомления о заказе в VK не приходят

У ВКонтакте нет канала сообщений от магазина: статус заказа покупатель узнаёт, только открыв магазин (встроенный чат работает). Поэтому при оформлении заказа у покупателя запрашивается телефон — по нему с ним можно связаться. Уведомления в Telegram или MAX приходят, если покупатель когда-то открывал магазин оттуда.

Поля в окне подключения

Поле в окне SunblazeЧто вводить и где взятьОбязательно
Защищённый ключ VKКабинет VK: «Настройки» → «Разработка» → «Ключи доступа» → «Защищённый ключ». Не «Сервисный ключ доступа» и не ID приложения.Да — при подключении. Потом пустое поле значит «оставить прежний»
ID мини-приложения VK«Панель управления приложением» → ID приложения (только цифры).Нет — нужен для QR и ссылок vk.com/app…; с ним вход принимается только из этого приложения
Ссылка для подключенияЗаполняется сама: https://v.sbaps.ru/?token=… Её вставляют в VK: «Настройки» → «Размещение» → поле «URL» в трёх блоках.Нет — только чтение, но вставить в VK обязательно
Канал работаетВыключите, чтобы временно закрыть канал: покупатели не входят, бот не отвечает, а ссылка, QR-коды и токен остаются. Включите — и всё откроется по прежним ссылкам. «Отключить» в таблице, в отличие от этого, удаляет подключение, и ссылка при повторном подключении другая.Нет — по умолчанию включено
Служебный токен SunblazeСлужебный идентификатор подключения. Никуда вводить не нужно — в кабинет платформы вставляется ссылка.Нет — только чтение

Частые ошибки

  1. В столбце «Состояние» — «Ключ не принят»
    Подпись запуска из VK несколько раз подряд не сошлась с сохранённым ключом: вставлен не «Защищённый ключ» или его перевыпустили. Скопируйте ключ в кабинете VK заново, сохраните его в окне «ВКонтакте» — счётчик начнётся сначала.
  2. В столбце «Состояние» долго «Ждём первого входа»
    Никто ещё не входил в магазин из VK: ссылка не вставлена в «Размещение», не включено «Состояние для пользователей» или вы открываете приложение администратором. Пройдите шаги 4–6.
  3. Покупатель не может войти: ошибка авторизации
    В Sunblaze вставлен не тот ключ (сервисный ключ доступа или ID приложения) или ключ перевыпустили в VK. Скопируйте «Защищённый ключ» заново и сохраните его в окне «ВКонтакте».
  4. Sunblaze просит заменить защищённый ключ
    Ключ сохранён до исправления безопасности: покупатели магазина могли видеть его первые и последние пять знаков. В кабинете VK обновите «Защищённый ключ» («Настройки» → «Разработка» → «Ключи доступа»), сразу вставьте новый ключ в окне «ВКонтакте» и нажмите «Сохранить» — напоминание исчезнет. Пока ключи в VK и в Sunblaze разные, покупатели не входят.
  5. Магазин просит открыть его заново
    Данные запуска из VK действуют ограниченное время — по умолчанию 6 часов, меньше, чем в Telegram и MAX. Если приложение долго лежало открытым и вход не прошёл, покупателю показывается подсказка: закрыть магазин и открыть его заново. Покупатель, которого VK открыл в другом вашем приложении с тем же ключом, не войдёт: укажите «ID мини-приложения VK», и Sunblaze примет запуск только этого приложения.
  6. Нужно ненадолго закрыть канал
    В окне «ВКонтакте» выключите «Канал работает» (или «Приостановить» в меню строки): покупатели из VK не входят, а ссылка остаётся прежней. «Отключить» удаляет подключение — ссылка при повторном подключении другая, и её придётся заменить во всех трёх полях «Размещения».
  7. Приложение открывается только у меня
    Не включено «Состояние для пользователей» (шаг 5).
  8. Открывается не витрина, а другая страница
    В «Размещении» старая ссылка. Скопируйте «Ссылку для подключения» из окна «ВКонтакте» заново — она вида https://v.sbaps.ru/?token=… — и вставьте во все три поля.

Сообщество ВКонтакте (по желанию)

Мини-приложение открывается по ссылке vk.com/app<ID приложения> и без сообщества. Если у магазина есть сообщество, добавьте в него приложение — так покупатели найдут магазин со страницы сообщества.

Инструкция сверена с документацией платформы и кабинетом Sunblaze 11 октября 2026 года. Если экраны платформы выглядят иначе, ищите те же названия разделов и полей — они меняются редко.