Получение списка всех групповых чатов и каналов для бота

Для корректной работы ваших чат-ботов и мини-приложений направляйте запросы на домен platform-api2.max.ru вместо platform-api.max.ru. Также убедитесь, что добавили сертификат Минцифры в список доверенных

GET/chats

Начиная с июня 2026 метод GET /chats больше не поддерживается, и API не предоставляет готовой возможности для получения списка групповых чатов и каналов, в которые добавлен бот

Если вам требуется получить для бота такой список, используйте POST /subscriptions. При этом задача сбора, хранения и поддержки идентификаторов ложится на разработчика: он выбирает способ реализации исходя из своей инфраструктуры и сценария использования

Возможный алгоритм действий:

  1. Cоздайте подписку через POST /subscriptions и укажите нужные типы событий в параметре update_types[], например, bot_added или bot_started. Список поддерживаемых типов событий – в объекте Update

  2. Получите chat_id в событии – о том, как это сделать, см. в разделе «Получение chat_id»

  3. Сохраните chat_id:

    • разверните на своей стороне хранилище данных
    • при получении каждого события с chat_id — сохраните его, если он ещё не сохранён
    • обработайте возможные дубли (одно и то же событие может прийти повторно)
    • удалите chat_id при возникновении соответствующих событий, например, bot_removed
  4. Используйте сохранённый chat_id для вызовов API. После того как chat_id окажется в вашем хранилище, вы сможете использовать его во всех методах, где он требуется:

    • POST /messages — отправить сообщение в чат
    • GET /chats/{chat_id}/members — получить участников группового чата или канала
    • POST /chats/{chat_id}/actions — отправить действия бота в групповой чат
    • и любые другие методы, принимающие chat_id как параметр

Использование Long Polling для получения списка чатов и каналов для бота не предусмотрено

Авторизация

access_token
apiKey

Передача токена через query-параметры больше не поддерживается — используйте заголовок Authorization: <token>

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты. Выберите необходимого бота и нажмите ⋮ → Настройки → значок копирования справа от поля с токеном

Если вы верифицировали профиль и создали бота в мини-приложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы