Nymka
Начать

VK Mini App

Подключите приложение ВКонтакте — клиенты смогут делать заказы прямо в VK, не покидая соцсеть. Работает параллельно с Telegram-ботом: один тот же клиент, единая история заказов, общий баланс бонусов.

Что это даёт

Одна и та же платформа Nymka открывается для клиента и в Telegram, и в ВКонтакте. При совпадении номера телефона система автоматически объединяет профили — клиент видит заказы из обеих соцсетей в одном месте.

Шаг 1. Создание приложения в ВКонтакте

1

Откройте VK Developers

Перейдите по ссылке vk.com/editapp?act=create. Войдите в тот аккаунт ВКонтакте, от которого хотите управлять приложением.
2

Заполните карточку приложения

  • Название — название вашего кафе (например, «Кафе Уют»).
  • Платформа — выберите VK Mini Apps.
Нажмите «Подключить сайт».
3

Подтвердите номер телефона

ВКонтакте попросит подтвердить телефон кодом из SMS — это одноразовая проверка, нужна для защиты от спам-приложений.

Шаг 2. Настройка приложения

1

Откройте раздел «Настройки»

В кабинете приложения слева выберите «Настройки». Здесь задаются URL страницы приложения и ключи безопасности.
2

Укажите адрес Mini App

В поле «Адрес Mini App» (или «URL приложения») введите ссылку вашего заведения:
https://nymka.ru/app/ВАШ_TENANT_ID

Tenant ID посмотрите в Nymka → «Настройки» → «Общие» (поле «ID заведения»), либо в адресной строке любой страницы админки.

3

Статус приложения

Переключите «Статус» на «Приложение включено и видно всем». Без этого клиенты не смогут открыть ваше Mini App.
4

Доменное имя

Убедитесь, что в разделе «Доверенные домены» указан nymka.ru — иначе VK заблокирует загрузку iframe.

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

Внимание: три разных ключа

У приложения в ВК есть три ключа — не перепутайте:
  • Защищённый ключ (Protected / Client Secret) — короткий (около 20 символов). Нам нужен именно он.
  • Сервисный ключ (Service token) — длинный, начинается с похожего на vk1.a... Подходит для отправки уведомлений клиентам через VK, но не для проверки подписей.
  • Ключ доступа сообщества — для работы с группой ВК, нам не нужен.
1

Найдите блок «Защищённый ключ»

Пролистайте страницу «Настройки» вниз. В блоке «Защищённый ключ» нажмите иконку глаза 👁, чтобы показать значение.
2

Скопируйте значение

Выделите и скопируйте защищённый ключ. Он должен быть длиной ~20 символов.
3

Запомните App ID

Там же в настройках есть «ID приложения» — число вида 54548406. Он вам тоже понадобится.

Шаг 4. Подключение в Nymka

1

Откройте раздел «VK Mini App»

В админке Nymka в левом меню выберите «VK Mini App».
2

Заполните форму

  • App ID — число из карточки VK приложения.
  • Защищённый ключ — вставьте значение из шага 3.
  • Сервисный ключ (необязательно) — если планируете отправлять клиентам VK-сообщения о статусе заказа.
3

Нажмите «Подключить»

После сохранения вы увидите зелёный бейдж «Подключено». Ключи хранятся в зашифрованном виде (AES-256-GCM).

Готово!

Клиенты теперь могут открыть ваше приложение по ссылке https://vk.com/app54548406 (замените на свой App ID) — оно загрузится прямо в ВК.

Шаг 5. QR-код для клиентов

В разделе «QR-коды» появится отдельная секция «QR для VK Mini App». Скачайте QR, распечатайте на меню, флаерах, упаковке — по скану клиент попадает сразу на страницу вашего приложения в ВКонтакте.

Как работает объединение профилей

Клиент, который пользуется и VK, и Telegram, получает одну карточку в CRM — если укажет одинаковый номер телефона:

  • Первый раз вошёл в Telegram Mini App → указал телефон при заказе.
  • Потом открыл VK Mini App → снова указал тот же телефон. Система автоматически объединит два профиля в один.
  • Все заказы, бонусы, избранное, адреса и уровень лояльности становятся общими.

Без явных действий

Клиенту ничего не нужно «привязывать» специально — объединение срабатывает при первом совпадении номера телефона между платформами.

Частые вопросы

Приложение показывает бесконечную загрузку

Самые частые причины: 1) в VK не указан корректный URL (https://nymka.ru/app/ВАШ_TENANT_ID), 2) вставили не «Защищённый», а «Сервисный» ключ. Проверьте оба пункта.

Клиент нажимает «Оплатить онлайн», а ничего не происходит

Значит в «Настройки» → «YooKassa» не введены реквизиты магазина или ключи устарели. YooKassa работает одинаково для клиентов из Telegram, VK и веба.

Где смотреть заказы из ВК?

Все заказы приходят в один канбан «Заказы». У каждого заказа отображается платформа (VK / Telegram / Web).

Можно отключить VK без потери данных

В разделе «VK Mini App» — кнопка «Отключить». Настройки удаляются из БД, профили и заказы клиентов — сохраняются.

Безопасность

Защищённый ключ не публикуйте в открытом доступе — по нему можно подделывать подпись запросов. Если ключ скомпрометирован, сгенерируйте новый в настройках VK-приложения и обновите его в Nymka.