Интеграции

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

Обновлено 25 октября 2026

Сообщество и токен

В Магазин → Плагины → Посты ВКонтакте выберите нужный набор в поле «Витрина» и заполните:

«ID или домен группы» — числовой ID сообщества либо короткую часть адреса, например mygroup для https://vk.com/mygroup.
«Токен доступа VK» — токен, с которым VK API разрешает читать стену выбранного сообщества.
«Версия VK API» — по умолчанию 5.199.

Нажмите «Сохранить» и откройте витрину с подключённым хелпером.

Подсказка поля токена говорит о личном или групповом токене с правами на wall. В описании продукта в маркете рекомендуется сервисный ключ. Код передаёт введённое значение в API без проверки типа токена. Возможность чтения выбранной стены нужно подтвердить фактическим запросом; наличие токена само по себе не гарантирует результат.

Встроенного получения или продления токена нет. Не вставляйте токен в публичный HTML: храните его в настройках плагина.

Какие запросы выполняются

Когда хелперу нужны публикации и подходящего кэша нет, сервер магазина отправляет POST-запрос на https://api.vk.com/method/wall.get.

Параметр	Передаваемое значение
`access_token`	Сохранённый токен либо значение параметра хелпера
`v`	Версия VK API
`count`	Запрашиваемое количество записей, не более 100
`filter`	Всегда `owner`: записи владельца стены
`extended`	Всегда `0`
`owner_id`	Отрицательный числовой ID сообщества, если указан ID
`domain`	Короткий домен, если вместо ID указана строка

Параметры заказов, покупателей и товаров в этот запрос не добавляются. «Включить репосты» обрабатывается локально после ответа, а не отдельным параметром API.

Плагин не загружает фотографии в файловое хранилище магазина: в данных сохраняются URL из ответа VK. При показе изображения браузер посетителя обращается по этому URL. Ссылки из карточек открывают ВКонтакте.

Обновление и ошибки

Получение выполняется при вызове хелпера. Собственных cron-команд, CLI-команд и обработчиков webhook у плагина нет. При положительном значении «Кэш, секунды» подготовленные записи сохраняются в кэше Webasyst.

Тайм-аут клиента API — 10 секунд. Если VK возвращает error_msg, плагин записывает его в журнал shop/plugins.log с префиксом [ewshopvkposts] VK API error: и возвращает пустой результат. Пустые токен и идентификатор сообщества останавливают получение раньше запроса, без такой записи об ошибке API.

Для диагностики задайте «Кэш, секунды» = 0, сохраните настройки и откройте страницу с хелпером. Разработчик может проверить журнал Webasyst и сетевую доступность API с сервера магазина. После проверки верните нужный срок кэширования.