VK

ВКонтакте (VK) — социальная сеть. API позволяет работать с сообщениями, записями на стене, комментариями и поиском.

С VK в Pailot вы можете:

Отправлять сообщения пользователям и в беседы через токен сообщества
Читать историю переписки
Загружать фотографии по URL на стену
Создавать посты с текстом и вложениями
Читать стену и искать записи по словам
Писать комментарии
Искать пользователей и сообщества

Интеграция поддерживает режим триггера через VK Callback API: процесс запускается при новом сообщении в сообщество или новой записи на стене.

Как подключить

Интеграция использует Access Token — токен доступа VK API.

Для бота сообщества (рекомендуется):

Откройте ВКонтакте → ваше сообщество → Управление
Перейдите в Работа с API → Ключи доступа
Нажмите Создать ключ, выберите права: Messages, Wall, Photos
Скопируйте токен в блок

Для личного аккаунта: создайте Standalone-приложение на vk.com/editapp?act=create и получите пользовательский токен через Implicit Flow.

Инструменты

Параметр	Тип	Обязательный	Описание
`accessToken`	string	Да	Токен с правом messages
`peerId`	string	Да	VK ID пользователя или `2000000000 + ID` беседы
`message`	string	Да	Текст
`attachment`	string	Нет	Вложения VK: `photo{owner}_{id}`. Несколько — через запятую

`vk_get_messages`

История диалога. count по умолчанию 20, максимум 200. Выход: count, items (id, date, from_id, peer_id, text), message.

Загрузка фото по публичному URL на стену (три шага VK: сервер → файл → сохранение). Нужен право photos. Выход: attachment (строка вида photo-123456_789012 для поля вложений поста), ownerId, photoId, message.

`vk_wall_post`

Запись на стене. ownerId отрицательный для сообщества. fromGroup — от имени сообщества. publishDate — Unix для отложенной публикации. Выход: postId, message.

`vk_wall_get` / `vk_wall_search`

Список или поиск записей. Фильтр стены: all, owner, others, recent, postponed. Выход: count, items, message.

`vk_wall_comment`

Комментарий к записи. Выход: commentId, message.

`vk_search`

Поиск пользователей (users) или сообществ (groups) по строке. Выход: count, items, message.

Триггер: `vk_callback`

Запуск процесса по событию сообщества через Callback API.

Параметр	Описание
Webhook URL	Генерируется автоматически. Скопируйте его в VK
Confirmation Code	Код из сообщества → Работа с API → Callback API → «Получить код»
Secret Key	Необязательный секрет. Если задан в VK, каждый запрос его содержит

Вебхук — входящий HTTP-запрос от VK. Сначала вставьте URL и код подтверждения в блок и сохраните, затем нажмите «Подтвердить» в VK — сервер ответит кодом сам.

Сообщество → Управление → Работа с API → Callback API
Добавить сервер, вставьте URL из блока
Скопируйте код подтверждения в блок и сохраните
В VK нажмите Подтвердить
На вкладке Типы событий включите нужные: входящее сообщение, запись на стене, комментарий

Выходы триггера: type (message_new, wall_post_new и другие), message.id / text / from_id / peer_id, object, groupId, eventId.

Ограничения VK API

Ограничение	Детали
Отправка сообщений	Сообщество пишет только тем, кто написал боту первым или разрешил рассылку
Лимиты	До 3 запросов/с для пользовательского токена, до 20/с для токена сообщества
Фото	Сначала `vk_upload_photo`, затем строка вложения в пост
Версия API	5.199

VK