VK API: ИИ-агент для сообщений сообщества

Сообщения сообщества ВКонтакте — отдельный канал обращений: клиент пишет в личку группы, и диалог живёт по своим правилам. Агент превращает эту переписку в учтённые обращения, а не в непрочитанную ленту.

Агент — программа, которая делает дело целиком, а не объясняет, как его сделать. Вы просите навести порядок в переписке, а получаете таблицу диалогов, очередь ответов и список того, что осталось без реакции.

Три признака. Он работает в ваших сервисах, а не в отдельном окне с советами. Доводит до результата: размеченный диалог, отправленный ответ, собранная сводка. Работает без вас — по событию или по расписанию.

От чат-бота он отличается финалом: бот вернёт текст, агент придёт с итогом.

Коннектор описывает подключение: где взять доступ, что видно и как проверить, что связь живая. Здесь доступ — ключ доступа сообщества, он оформляется на стороне ВКонтакте и выдаётся агенту отдельным токеном.

Это не плагин в браузере и не доработка сайта: коннектор работает через методы API. Пароль от аккаунта агент не хранит — ему хватает ключа с узким набором прав.

Диалоги возвращает messages.getConversations с фильтрами all, unread и important, историю переписки — messages.getHistory по peer_id и start_message_id, отправку — messages.send. Получатель в send записывается по правилу: для человека это user_id, для беседы — число 2000000000 плюс chat_id. Параметр random_id защищает от повторной отправки при обрыве связи.

Прочтение отмечает messages.markAsRead, текст даёт messages.getById. Входящий поток настраивается в Callback API: groups.setCallbackSettings включает события message_new, message_reply, message_edit и message_deny, а groups.getCallbackConfirmationCode выдаёт код подтверждения адреса. Методы сверены по официальной схеме VK API.

### Входящая корреспонденция: регистрация и резолюция

Агент забирает новые диалоги через getConversations, историю — через getHistory, вытаскивает суть: кто пишет, о чём, есть ли вложение. Обращение получает номер, тему и ссылку на диалог, а в карточке появляется черновик резолюции: кому передать, что уточнить. Отправка — только после подтверждения человеком.

### Заявки из почты, форм и мессенджеров

В сообществе заявка приходит обычным сообщением, и её легко спутать с болтовнёй. Агент приводит входящие к одному набору полей и сверяет с тем, что уже есть в учёте. Повтор отсекается по random_id и по совпадению отправителя с открытым обращением.

### Сводки по обращениям: день и месяц

Агент считает, сколько диалогов пришло и сколько осталось без ответа. Отдельно показывает диалоги с повторным сообщением клиента — признак потерянного обращения. За месяц — сравнение с прошлым периодом.

Резолюцию ставит сотрудник, он же утверждает ответ в спорном диалоге. Передача обращения в другую службу — тоже решение человека.

Ключ доступа сообщества оформляется в настройках сообщества ВКонтакте, в разделе для работы с API; права берутся узкие — на сообщения. Адрес сервера для Callback API указывается там же, код подтверждения даёт groups.getCallbackConfirmationCode. Проверка связи: запрос списка диалогов должен вернуть хотя бы одну переписку.

Не отвечает от вашего имени без утверждения и не удаляет переписку.

Что такое агент, если коротко? Программа, которая доводит дело до результата: читает диалоги сообщества, размечает обращения и приносит сводку, а не рассказывает, как отвечать.

Что такое коннектор? Описание подключения: где взять ключ доступа, какие права дать и как проверить связь. Пароль от аккаунта агент не хранит.

Как понять, что обращение потеряно? По повторному сообщению того же клиента в открытом диалоге: такие пары агент показывает первыми в утренней сводке.