Присылайте отчёты и напоминания в чаты VK Teams от имени бота

Агент работает в VK Teams через бота: первым запросом читает данные самого бота, а дальше — чаты, куда его добавили. Оттуда он берёт сообщения, состав участников, администраторов и заблокированных, заявки на вступление и информацию о файлах. Этого хватает, чтобы прислать отчёт или напоминание туда, где сидит команда, и разобрать, что происходит в рабочем чате.

Граница видимости здесь жёсткая: бот видит только те чаты, куда его добавили, и ничего за их пределами. Историю до момента добавления он тоже не получит — события приходят с той минуты, как бот оказался в чате, поэтому сводка за прошлый месяц по свежему чату физически не собирается. Вебхуков у VK Teams нет вовсе: новые сообщения агент забирает лентой событий, держа соединение открытым, и подхватывает разговор ровно с той точки, где остановился. Курсор здесь односторонний — отмотать ленту назад к уже прочитанному нельзя, поэтому пропустить событие агент не даёт. Пока бота в чат не добавили, он честно скажет, что чат недоступен, вместо пустой сводки.

На запись агент делает много: отправляет, редактирует и удаляет сообщения, закрепляет сводку в шапке чата, шлёт сообщения с кнопками и обрабатывает нажатия через callback, отправляет файлы и голосовые, открывает обсуждения к сообщениям, меняет название, описание, правила и аватар чата, разбирает заявки на вступление, удаляет из чата и блокирует нарушителя. Добавление участников — единственное, что доступно не всем: это приватный метод, который работает только в on-premise-сборках VK Teams и только после того, как его включит системный администратор; в облаке агент скажет об этом прямо, вместо того чтобы молча не справиться. Сообщение в рабочем чате видят все, а удаление и исключение не откатить — поэтому перед такими действиями агент называет чат и текст и ждёт подтверждения.

Подключение — токен бота. Он уходит параметром запроса, так что хранить его нужно как пароль, а отозвать доступ можно только пересозданием бота. Всё, что делает агент, делается от имени бота и так и подписано в чате: за сообщением видно робота, а не человека, и ответить ему можно там же. Объём модерации ограничен правами бота в конкретном чате — без прав администратора он не удалит чужое сообщение и не исключит участника, и об этой нехватке сообщает прямо, а не пробует вслепую.