Создание и настройка приложения ВКонтакте
Для работы плагина "Магазин ВКонтакте" необходимо создать приложение в VK ID и получить ключи доступа для работы с API ВКонтакте.
Важная информация
С 2024 года приложения ВКонтакте создаются через новый сервис VK ID. Старый интерфейс vk.com/apps больше не используется для новых приложений.
Подготовка к работе
1. Подготовьте сообщество ВКонтакте
Перед созданием приложения убедитесь, что у вас есть сообщество (группа) ВКонтакте с включенным разделом товаров:
- Откройте страницу сообщества и нажмите Управление
- Перейдите в Настройки → Разделы
- Включите раздел Товары (выберите БАЗОВЫЕ товары)
Подробнее о создании группы читайте в разделе Создание группы.
2. Создайте аккаунт в VK ID
Если у вас еще нет аккаунта в сервисе авторизации VK ID:
- Откройте id.vk.com/business/go
- При первом входе выберите тип аккаунта (физическое лицо или организация)
- Укажите ваши данные: имя, электронную почту, телефон
Создание приложения
Шаг 1: Добавление приложения
- Перейдите в личный кабинет VK ID
- Нажмите кнопку Добавить приложение
- Заполните форму создания приложения
Шаг 2: Заполнение информации
Укажите следующие данные:
Название приложения
- Введите название вашего магазина
- Это название увидят пользователи в окнах авторизации
Платформа
- Выберите Web, так как плагин работает через веб-интерфейс
- Для мобильных приложений выберите iOS или Android
Изображение приложения
- Загрузите логотип вашего магазина
- Рекомендуемый размер: 200x200 пикселей
- Будет использоваться в окнах авторизации
Шаг 3: Настройка доменов (для Web)
Для платформы Web необходимо указать:
Базовый домен
- Укажите домен вашего сайта без http:// и www
- Например:
myshop.ruили.myshop.ru(с точкой для всех поддоменов) - Если используете Webasyst в облаке, укажите ваш адрес облака
- Рекомендуется использовать адрес вида:
ваш_сайт/webasyst
Доверенный Redirect URL
- Укажите полный URL с протоколом:
https://myshop.ru/webasyst - Домен должен совпадать с базовым доменом
- Для локального тестирования можно использовать
http://localhost
Важно
Если ВК не дает доступа к публикации, проверьте правильность указания базового домена и Redirect URL. Они должны точно совпадать с адресом, с которого вы заходите в админку Webasyst.
Шаг 4: Завершение создания
- Нажмите кнопку Создать приложение
- Подтвердите создание через SMS или другим способом
- Приложение будет создано и вы получите доступ к его настройкам
Получение ключей доступа
После создания приложения вам будут доступны следующие ключи:
ID приложения (client_id)
- Находится в разделе Приложение → Информация о приложении
- Используется для настройки плагина
- Пример:
12345678
Защищенный ключ (client_secret)
- Находится в разделе Приложение → Информация о приложении
- Используется для авторизации и работы с API
- Храните в секрете!
Сервисный ключ доступа
- Находится в разделе Приложение → Информация о приложении
- Используется для вызова методов API ВКонтакте
- Необходим для работы плагина с товарами
Безопасность
Никогда не публикуйте ключи доступа в открытых источниках. Храните их в безопасном месте.
Настройка доступов
Включение доступа к товарам
Для работы с товарами необходимо включить расширенный доступ Товары:
- Пройдите верификацию в VK Бизнес ID
- В личном кабинете выберите приложение
- Перейдите в раздел Доступы
- Включите доступ к группе API-методов Товары
- Нажмите Сохранить
Базовые доступы
По умолчанию доступны:
- Личные данные пользователя (
vkid.personal_info) - имя, фото, пол, дата рождения - Почта (
email) - опционально, можно включить при необходимости
Расширенные доступы
После верификации становятся доступны:
- Товары - управление товарами в сообществах
- Телефон (
phone) - номер телефона пользователя (опционально)
Настройка авторизации
Перейдите в раздел Авторизация и настройте параметры:
Дополнительные способы входа
Опционально можно включить:
- Авторизация через Одноклассники
- Авторизация через Mail
- Авторизация по QR-коду
- Авторизация через приложение VK (для мобильной ве��сии)
Данные для регистрации
Выберите поля, которые пользователь должен заполнить при регистрации:
- Имя и фамилия (обязательно)
- Телефон (обязательно)
- Почта (опционально или обязательно)
Правовые документы
Выберите, какие документы использовать:
- Типовые документы VK ID
- Свои документы (укажите ссылки на политику конфиденциальности и условия использования)
Настройка приложения для группы
Получение токена группы
Для работы плагина необходим токен доступа группы:
- Откройте вашу группу ВКонтакте
- Перейдите в Управление → Настройки → Работа с API
- Нажмите Создать ключ
- Выберите необходимые права:
- ✅ Управление сообществом
- ✅ Управление товарами
- ✅ Доступ к фотографиям
- ✅ Управление подборками
- Скопируйте полученный Ключ доступа
Привязка приложения к группе
Приложение должно быть прикреплено к группе, в которую будут отправляться товары. Это настраивается в параметрах плагина.
Проверка настроек
Перед настройкой плагина убедитесь, что у вас есть:
- ✅ ID приложения (client_id)
- ✅ Защищенный ключ (client_secret)
- ✅ Сервисный ключ доступа
- ✅ Токен доступа группы
- ✅ ID группы ВКонтакте (только цифры!)
- ✅ Включен доступ к товарам
- ✅ Раздел "Товары" включен в группе
Ограничения API ВКонтакте
Лимиты запросов
ВКонтакте устанавливает следующие лимиты:
- 3 запроса в секунду для обычных токенов
- 20 запросов в секунду для серверных токенов
- Плагин автоматически учитывает эти ограничения
Ограничения на товары
- Максимум 1000 подборок в группе
- Максимум 1000 товаров в одной подборке
- Максимум 5 фотографий на один товар
- Размер изображения: до 5 МБ, форматы JPG или PNG
Устранение проблем
Приложение заблокировано
Если приложение заблокировано, возможные причины:
Нарушение условий оферты VK ID
- Проверьте соответствие условиям использования
Неправильное оформление кнопки входа
- Оформите кнопку согласно требованиям дизайна
- Напишите в поддержку: devsupport@corp.vk.ru
VK ID используется на неуказанных доменах
- Добавьте все актуальные домены в настройках приложения
- Напишите в поддержку: devsupport@corp.vk.ru
Ошибка доступа к API
Возможные причины:
- Неверные ключи дос��упа
- Недостаточно прав
- Токен истек
- Не пройдена верификация
Решение:
- Проверьте правильность введенных ключей в настройках плагина
- Убедитесь, что доступ к товарам включен
- Пройдите верификацию в VK Бизнес ID
- Обновите токен доступа группы
Ошибка "Access denied"
Причины:
- Истек токен доступа
- Недостаточно прав доступа
- Токен был отозван
Решение:
- Выполните повторную авторизацию в настройках плагина
- Проверьте права доступа приложения ВКонтакте
- Создайте новый токен доступа для группы
Следующие шаги
После создания и настройки приложения переходите к:
- Настройкам плагина - введите полученные ключи
- Авторизации - подключите группу к плагину
- Работе с плагином - начните экспорт товаров