Отвечайте в рабочих чатах MAX от имени своего бота

Агент работает через Bot API MAX на platform-api2.max.ru, а токен бота передаёт в заголовке авторизации. Первым запросом он вызывает get_me: так проверяется, что токен живой, и видно, от чьего имени будут уходить сообщения. Дальше в работе только те чаты, куда бот добавлен, — их переписка, вложения и нажатия кнопок: накладную, выгрузку или скриншот отчёта агент читает прямо из ленты сообщений.

Бот в MAX — участник чата, а не наблюдатель со стороны: пока его не добавили в беседу, ни одного сообщения оттуда агент не получит, и никакие права это не обойдут. Входящие приходят не опросом, а вебхуком: адрес регистрируется при подключении, MAX присылает новые сообщения и нажатия кнопок сам, а каждый запрос подписывает секретом в заголовке x-max-bot-api-secret.

На запись это основной режим коннектора. Агент отвечает в переписке, показывает индикатор набора, пока готовит ответ, загружает файлы, задаёт уточняющие вопросы кнопками и обрабатывает нажатие через callback. Редактировать и удалять он может только собственные сообщения — чужие реплики в чате остаются нетронутыми, а сводку по расписанию отправляет в тот чат, который вы указали.

Токен даёт права ровно этого бота и ничего сверх: личная переписка владельца профиля через него недоступна. Историю чата агент читает страницами, от свежих сообщений к старым, вложения забирает по ссылке из события, а частоту запросов выдерживает сам. Файл он отправляет загрузкой в MAX, а не ссылкой на сторонний диск, и называет, в какой чат его положил, вместо короткого «отправлено».