К содержимому
Интеграции

Подключение VK

Обновлено

Получите реквизиты API

  1. Войдите в нужный кабинет VK Рекламы.
  2. Откройте Настройки → Доступ к API: страница доступа.
  3. Подайте заявку на доступ. После одобрения получите client_id и client_secret.
  4. Внесите значения в поля ID клиента API (client_id) и Секрет клиента API (client_secret) в настройках плагина.
  5. Проверьте подключение через vkads_get_account.

Плагин использует реквизиты API VK Рекламы. Токен сообщества ВКонтакте или ключ другого сервиса их не заменяет.

Работа агентства

Для работы со своим агентским кабинетом оставьте Логин клиента агентства пустым. Инструмент vkads_get_agency_clients показывает клиентов, их логины и доступные сведения. На обычном рекламном кабинете VK может отказать в этом запросе.

Чтобы работать от имени конкретного клиента, внесите его логин в Логин клиента агентства. Плагин запросит токен в режиме клиента агентства. Повторите vkads_get_account и сверьте подключённый кабинет.

Настройка действует на подключение плагина целиком. Права токена MCP ограничивают инструменты, но не выбирают отдельный рекламный кабинет.

Токены VK

Плагин получает токен при обращении к API и хранит access token, refresh token и срок действия в служебных настройках приложения MCP, вне пользовательской формы. Срок берётся из ответа VK; если он не указан корректно, код использует сутки. До истечения срока плагин обновляет токен автоматически; параллельные обновления защищены файловой блокировкой.

Если выдача токена завершилась ответом, который код считает превышением лимита токенов, плагин вызывает отзыв токенов и повторяет выдачу. При работе с клиентом агентства в отзыв передаётся его логин. Это может затронуть другие интеграции с теми же реквизитами, поэтому используйте отдельный клиент API для плагина, если реквизиты уже используются где-либо ещё.

Токен доступа VK и токен подключения MCP — разные сущности. Первый плагин обслуживает сам, второй выдаётся агенту в приложении MCP.

Какие данные передаются

Направление Данные
Сервер Webasyst → API VK При авторизации — ID, секрет клиента API, при необходимости логин клиента агентства; в запросах — токен VK, фильтры и параметры инструмента
API VK → агент через MCP Запрошенные данные кабинета, рекламные объекты, статистика, результаты и ошибки операций
Сервер Webasyst → VK при изменениях Согласованные названия, тексты, ссылки, таргетинг, бюджеты, ставки, статусы или данные маркировки
Сервер Webasyst → VK при загрузке Содержимое изображения; при image_url сервер сначала скачивает файл с указанного публичного адреса

vkads_get_leads возвращает контакты и ответы заявителей. Сведения клиента агентства и данные маркировки также могут содержать персональную информацию. Учитывайте это при выборе прав агента и MCP-клиента.

В журнале wa-log/vkads.log код маскирует известные секреты и токены. Полный успешный ответ с лидами сам инструмент в журнал не записывает. Плагин не добавляет отдельную настройку шифрования реквизитов в базе.

Что настраивать на сервере

Для API нужен исходящий HTTPS к ads.vk.com. Для картинок по ссылке нужен также доступ к их публичному источнику. При ошибке lock_failed разработчику следует проверить возможность записи в wa-data/protected/mcp; при auth_busy — повторить запрос через несколько секунд.

Webhook и фоновая синхронизация по cron не предусмотрены: данные запрашиваются при вызове инструментов.