Подключение ВКонтакте

Сообщество — это «бот» в терминах ВК: сущность, от имени которой будут уходить сообщения и от которой будут получать ваши пользователи.

1. Зайдите на vk.ru/groups?w=groups_create и нажмите «Создать сообщество»
2. Тип сообщества: «Бизнес» (либо «Бренд или организация»)
3. Название: ваш бренд (например, iVISION). Тематика: «Бизнес и экономика»
4. Нажмите «Создать»

Под обложкой сообщества нажмите «⋯» → «Управление». Откроется панель управления, в правой колонке — пункты меню.

В разделе «Настройки» → «Основная информация»:

• Название: ваш бренд
• Описание: короткое описание вашего бизнеса/событий
• Тематика: «Бизнес и экономика»
• Адрес страницы: ваш кастомный тег латиницей вместо автоматическогоclub{ID}. Например ivision_pluson — получится vk.ru/ivision_pluson (вместо длинного vk.ru/club238697730).⚠️ Не получается сохранить адрес (поле красное, кнопка «Сохранить» неактивна или ВК пишет «адрес занят»)? — можно пропустить. ПЛЮСОН будет работать и без короткого адреса, просто в шаге 6 вы введёте свой club{ID} вместо тега.
• Сайт: ваш сайт (если есть)
• Город: ваш город
• Нажать «Сохранить»

Чтобы сообщество могло отправлять сообщения участникам и принимать сообщения от них.

В правом меню управления → пункт «Сообщения»:

1. Переключатель «Сообщения сообщества» → ВКЛ
2. Поле «Приветствие» — оставить пустым.ПЛЮСОН сам отправит контекстное приветствие (по событию или лид-магниту). Если заполнить это поле, ВК будет слать своё статичное сообщение поверх нашего — сообщения задублируются.
3. Чекбокс «Виджет сообщений» — не ставить (это для встраивания чата на сторонние сайты, нам не нужно)
4. Нажать «Сохранить»

Чат сообщества — это общий чат для участников вашего события (аналог группового чата в Telegram). Туда вы сможете давать ссылку из Mini App, чтобы участники общались друг с другом.

На главной странице сообщества справа:

1. Найдите блок «Чаты» или ссылку «Создать чат»
2. Нажмите «Создать чат»
3. Название чата — название вашего события или сообщества
4. Фото чата — можно загрузить (необязательно)
5. Кто может приглашать — «Все участники сообщества»
6. Нажать «Создать»

После создания скопируйте ссылку на чат (кнопка «Пригласить в чат» → «Скопировать ссылку») — она пригодится, когда будете настраивать событие в дашборде ПЛЮСОН (поле «Чат события»).

Боты в ВК — это автоматизация ответов сообщества. ПЛЮСОН использует их, чтобы слать приветствия, лид-магниты, рассылки, отвечать на нажатия кнопок.

В правом меню управления сообществом найдите пункт «Настройки для бота» (он в списке между «Сообщения» и «Чаты»). Откройте его.

На открывшейся странице «Настройки для бота»:

1. Строка «Возможности ботов» должна показывать статус «Включены». Если написано «Выключены» / «Отключены» — нажмите на эту надпись и включите. (Это ссылка-статус, а не галочка — просто должно стоять «Включены».)
2. Поставьте галочку «Добавить кнопку „Начать"» ✅ — это обязательно.Аналог /start в Telegram. Когда человек впервые открывает диалог с сообществом, ВК покажет ему большую синюю кнопку «Начать». Он её жмёт → ПЛЮСОН получает событие и шлёт первое сообщение. Без этой галочки воронка лид-магнита не запустится.
3. Галочку «Разрешать добавлять сообщество в чаты» — на ваше усмотрение (можно оставить включённой, на воронки не влияет).
4. Нажать «Сохранить»

Ключ доступа сообщества — это «пароль» от вашей группы, через который ПЛЮСОН отправляет сообщения подписчикам и принимает события («новый диалог», «нажал кнопку»).

В правом меню управления сообществом отдельного пункта «Работа с API» в современном ВК нет — страница открывается только по прямой ссылке вида vk.ru/адрес_сообщества?act=tokens. Введите ниже короткий адрес или ID своего сообщества — мы соберём рабочую ссылку.

▶ https://vk.ru/<адрес_вашего_сообщества>?act=tokens

На открывшейся странице «Работа с API» → вкладка «Ключи доступа»:

1. Нажмите «Создать ключ»
2. Отметьте чекбоксы прав:
   • ✅ Сообщения сообщества
   • ✅ Управление сообществом
   • ✅ Доступ к фотографиям сообщества
   • ✅ Доступ к документам сообщества
3. Нажмите «Создать» → подтвердите через SMS-код
4. Скопируйте появившийся длинный ключ вида vk1.a.xxxxxxxxxx…

Mini App — это само приложение ПЛЮСОН внутри ВК. Регистрируется в кабинете разработчика VK, не в сообществе. В 2025 году ВК перенёс регистрацию из старой панели vk.ru/editapp в новую панель на dev.vk.com.

Откройте в браузере:

▶ dev.vk.com/ru/mini-apps/management/creating-new-apps

На открывшейся странице — таблица с двумя колонками. В левой колонке «Новая панель управления»кликните по первому пункту:

▶ «Мини-приложение или игра» — Запускаются в UI ВКонтакте

Откроется форма создания в новой панели. Заполните:

1. Название приложения: ваш бренд (например, iVISION)
2. Тип приложения: оставить значение по умолчанию — «Мини приложение»Поля «Платформа: Веб-приложение / Мобильное приложение» в современной форме нет — платформы настраиваются позже в разделе «Размещение».
3. Категория: выбрать из списка — подойдёт «Бизнес» (можно «Утилиты», «Образование» — зависит от вашей тематики)
4. Нажать кнопку «Создать»

После создания вы попадёте в панель управления приложением. App ID приложения сразу виден в правой колонке (короткое число, например 54592404). Дальше нужно настроить несколько разделов в левом меню.

«Настройки → Информация»:

1. Описание — расскажите про ваш бизнес и события
2. Краткое описание — одной строкой, до 128 символов
3. Короткий адрес — пропустите этот пункт. ВК показывает ошибку «приложение должно появиться в каталоге» — короткий адрес выдаётся после модерации приложения, заполнять сейчас не получится. Вернётесь к нему позже, если будете публиковать в каталог ВК. Для работы с ПЛЮСОН это не нужно.
4. Официальное сообщество — выбрать ваше сообщество из шага 1
5. «Запуск приложения из сообщества» — переключатель ВКЛ (в сообществе появится кнопка «Открыть приложение»)
6. «Название кнопки» — выбрать «Открыть приложение» (или похожее) из дропдауна
7. «Запуск на iOS / Company Name» — оставить пустым
8. Нажать «Сохранить»

«Настройки → Размещение»:

Здесь три отдельные секции с URL — для разных сценариев открытия. Во все три вставляем один и тот же URL:

Ваш ID клиента подгружается… после загрузки страницы URL станет персональным.

1. Состояние для пользователей: «Включено»
2. «Мобильное приложение» (WebView) → URL: ссылка выше. Запускается из нативного приложения VK на iOS/Android
3. «Десктопная версия сайта» (iframe) → URL: та же ссылка. Запускается с компьютера через vk.com
4. «Мобильная версия сайта» (iframe) → URL: та же ссылка. Запускается с мобильного браузера через m.vk.com
5. «Режим разработки» во всех трёх секциях — не трогать
6. Нажать «Сохранить»

«Разработка → Ключи доступа»:

В этом разделе ВК показывает два ключа с похожими названиями. Нам нужен только «Защищённый ключ» (Secure Key). Скопируйте именно его — нажмите «Показать», возьмите значение.

Защищённый ключ нужен ПЛЮСОНу для проверки подписи запросов от вашего Mini App к нашему бэкенду — гарантия что данные не подделаны.

Свежесозданное Mini App по умолчанию видно только вам. Чтобы им могли пользоваться подписчики (и работали ссылки на лид-магниты), переведите его в публичный статус:

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

В шаге 7 вы зарегистрировали Mini App. Само по себе это его не показывает подписчикам сообщества — нужно ещё добавить его «лицом» в само сообщество: плиткой в меню под обложкой и большой кнопкой в шапке рядом с «Сообщения». Сделаем 3 размещения.

8.1 — Установить виджет приложения

Сначала «прицепляем» Mini App к сообществу — это даст плитку-сниппет над постами и сделает приложение доступным для добавления в меню и кнопку действия.

1. Управление сообществом → правая колонка, прокрутите вниз до пункта «Приложения» (он не в первой группе пунктов, а ниже — после «Сообщения» / «Чаты»)
2. На открывшейся странице прокрутите в самый низ до блока «Мои приложения» (он после «Ранее установленные»)
3. У вашего приложения нажмите «Добавить»
4. На экране настроек:
   • «Кому доступно»: «Все пользователи»
   • «Видимость виджета приложения»: «Все пользователи»
   • «Сниппет»: выбрать подпись кнопки в плашке-сниппете — «Открыть», «Записаться», «Перейти» (на ваш вкус)
   • «Название приложения»: например, «iViSiON: ПЛЮСОН»
5. Нажать «Сохранить»

8.2 — Добавить плитку в «Меню» сообщества

Плитка появляется под аватаром сообщества (мобильная и десктоп версии) — это самый заметный способ запуска. Можно сделать одну общую плитку «Открыть приложение» или несколько («События», «Подарки», «Регистрация»).

1. Правая колонка управления → «Меню» → «Новая ссылка»
2. Ссылка: вставьте https://vk.com/app{VK_APP_ID}_-{ID_сообщества} — обязательно с минусом перед ID сообщества. Минус сообщает ВК, что приложение запускается в контексте этого сообщества (а не как личное у пользователя).Пример: если ваш App ID = 54592404 (из шага 7), а ID сообщества = 238697730 (из шага 2) — ссылка будет https://vk.com/app54592404_-238697730.
   Если ВК пишет «Некорректная ссылка» — проверьте: 1) минус перед ID сообщества; 2) приложение уже установлено в сообщество (шаг 8.1).
3. Название: до 20 символов — например, «ОТКРЫТЬ ПРИЛОЖЕНИЕ», «СОБЫТИЯ», «РЕГИСТРАЦИЯ»
4. Обложка: загрузить квадратную картинку (рекомендация 376×256 px) — это иконка плитки в меню. Без неё ВК подставит дефолтную серую
5. Нажать «Сохранить»

Можно добавить несколько ссылок в меню — каждая будет отдельной плиткой. Все они могут вести на одно и то же приложение, но с разными параметрами в URL (#ref_pg{slug_события} — открыть конкретное событие в приложении).

8.3 — Кнопка действия в шапке

Большая кнопка в шапке сообщества рядом с «Сообщения». Она ОДНА — либо «Открыть приложение», либо «Позвонить»/«Написать в Telegram»/«Записаться по ссылке». Рекомендуем «Открыть приложение».

1. Правая колонка управления → «Кнопка действия» (если пункта нет — он спрятан под «Показать ещё» или «Дополнительно»)
2. Тип действия: «Открыть приложение»
3. Приложение: выбрать ваше из выпадающего списка (там появятся только установленные в сообщество — поэтому шаг 8.1 нужно сделать до этого)
4. Название кнопки: «Открыть приложение» (или из предложенных)
5. Нажать «Сохранить»

Финальный шаг — вписать токен сообщества и реквизиты Mini App в дашборд ПЛЮСОН.

1. Откройте раздел «Каналы» в дашборде
2. В карточке-приглашении «Подключите своё VK-сообщество» нажмите кнопку «Запустить мастер VK»
3. В мастере (шаг 2 из 3) заполните 4 поля:
   • Access Token сообщества — длинный ключ vk1.a.xxxxx… из шага 6
   • VK App ID — число (из шага 7, в правой колонке панели Mini App)
   • ID сообщества — число (например, 238697730; виден в URL вашего сообщества vk.ru/club238697730 или в Настройки → «Номер сообщества»)
   • Secure Key Mini App — длинная строка из «Разработка → Ключи доступа» вашего Mini App (шаг 7)
4. Нажмите «Подключить». ПЛЮСОН автоматически:
   • проверит, что токен живой (запрос groups.getById к VK API)
   • включит Long Poll API у вашего сообщества (нужно чтобы наш бэкенд получал входящие сообщения и нажатия кнопок)
   • включит отслеживание подписчиков (события «вступил/вышел из сообщества») — чтобы те, кто подписывается на ваше сообщество, автоматически попадали в базу контактов ПЛЮСОН
   • сохранит реквизиты в зашифрованном виде в нашей базе
   • перезапустит свой VK-процесс — обычно за 5–10 секунд ваше сообщество начнёт обслуживаться

Чтобы уведомления о новых интересах и личных сообщениях приходили в ВК — в общий чат, который видите вы и ваша команда (как канал) — настройте так. Всё делается руками с компьютера (vk.com), это надёжнее телефона.

1. Разрешите добавлять сообщество в чаты. В сообществе: Управление → Сообщения → Настройки для бота → включите галочку «Разрешать добавлять сообщество в чаты» → «Сохранить». Без этого сообщество нельзя будет добавить в чат.
2. Создайте чат (беседу) с компьютера. Откройте Мессенджер на vk.com → «+» рядом с поиском → «Создать чат». Участников добавлять не обязательно — можно создать пустой и дать ему название (например «Уведомления ПЛЮСОН»).
3. Добавьте сообщество в этот чат. Откройте страницу своего сообщества → в блоке кнопок под шапкой нажмите «Добавить в чат» → выберите только что созданный чат. Сообщество вступит в него (через поиск участников внутри чата сообщество обычно НЕ находится — поэтому добавляем именно так, со страницы сообщества).
4. Узнайте ID чата. Напишите в этом чате команду
   /getmyid Копировать
   — сообщество-бот ответит числом вида 2000000003. Это peer_id чата.
   Если бот молчит — зайдите в настройки чата → участники → у сообщества назначьте права администратора и повторите /getmyid.
5. Впишите ID в ПЛЮСОН. Настройки → Техническое → блок «Каналы уведомлений» → вкладка VK → вставьте это число → нажмите «Сохранить визитку».

• «Адрес недоступен» при сохранении настроек Mini App → URL pluson.ru/c/.../vk/ ещё не открыт. Проверьте URL в браузере — должна загрузиться страница ПЛЮСОН в ВК. Если нет — пишите разработчику.
• «Не могу создать ключ» → проверьте, что у вас включена двухфакторная аутентификация ВК и привязан мобильный номер (SMS-код приходит на него)
• «Не приходит SMS» → ВК отправляет коды только через российские номера и иногда задерживает. Попробуйте перезапросить через минуту
• Сообщество не появляется в списке «Группа администрирования» при создании Mini App → вы не админ этого сообщества или сообщество ещё не создано. Проверьте в управлении сообщества → «Участники» → «Руководители»