Получение списка всех групповых чатов и каналов для бота
Для корректной работы ваших чат-ботов и мини-приложений направляйте запросы на доменplatform-api2.max.ruвместоplatform-api.max.ru. Также убедитесь, что добавили сертификат Минцифры в список доверенных
GET/chats
Начиная с июня 2026 метод GET /chats больше не поддерживается, и API не предоставляет готовой возможности для получения списка групповых чатов и каналов, в которые добавлен бот
Если вам требуется получить для бота такой список, используйте POST /subscriptions. При этом задача сбора, хранения и поддержки идентификаторов ложится на разработчика: он выбирает способ реализации исходя из своей инфраструктуры и сценария использования
Возможный алгоритм действий:
-
Cоздайте подписку через POST /subscriptions и укажите нужные типы событий в параметре
update_types[], например,bot_addedилиbot_started. Список поддерживаемых типов событий – в объекте Update -
Получите
chat_idв событии – о том, как это сделать, см. в разделе «Получение chat_id» -
Сохраните
chat_id:- разверните на своей стороне хранилище данных
- при получении каждого события с
chat_id— сохраните его, если он ещё не сохранён - обработайте возможные дубли (одно и то же событие может прийти повторно)
- удалите
chat_idпри возникновении соответствующих событий, например,bot_removed
-
Используйте сохранённый
chat_idдля вызовов API. После того какchat_idокажется в вашем хранилище, вы сможете использовать его во всех методах, где он требуется:- POST
/messages— отправить сообщение в чат - GET
/chats/{chat_id}/members— получить участников группового чата или канала - POST
/chats/{chat_id}/actions— отправить действия бота в групповой чат - и любые другие методы, принимающие
chat_idкак параметр
- POST
Использование Long Polling для получения списка чатов и каналов для бота не предусмотрено
Авторизация
Передача токена через query-параметры больше не поддерживается — используйте заголовок
Authorization: <token>
Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты. Выберите необходимого бота и нажмите ⋮ → Настройки → значок копирования справа от поля с токеном
Если вы верифицировали профиль и создали бота в мини-приложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен
Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы