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

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

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

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

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

2. **Получите `chat_id` в событии** – о том, как это сделать, см. в [разделе «Получение chat_id»](/docs-api#Получение%20chat_id)

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

   - разверните на своей стороне хранилище данных
   - при получении каждого события с `chat_id` — сохраните его, если он ещё не сохранён
   - обработайте возможные дубли (одно и то же событие может прийти повторно)
   - удалите `chat_id` при возникновении соответствующих событий, например, `bot_removed`

4. **Используйте сохранённый `chat_id` для вызовов API**. После того как `chat_id` окажется в вашем хранилище, вы сможете использовать его во всех методах, где он требуется:

   - [POST `/messages`](/docs-api/methods/POST/messages) — отправить сообщение в чат
   - [GET `/chats/{chat_id}/members`](/docs-api/methods/GET/chats/-chatId-/members) — получить участников группового чата или канала
   - [POST `/chats/{chat_id}/actions`](/docs-api/methods/POST/chats/-chatId-/actions) — отправить действия бота в групповой чат
   - и любые другие методы, принимающие `chat_id` как параметр

 > Использование [Long Polling](/docs-api#Long%C2%A0Polling) для получения списка чатов и каналов для бота не предусмотрено

## Авторизация

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

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на [платформе](https://business.max.ru/self) в разделе **Чат-боты**. Выберите необходимого бота и нажмите **⋮** → **Настройки** → значок копирования справа от поля с токеном

Если вы верифицировали профиль и создали бота в [мини-приложении «MAX для бизнеса»](https://max.ru/business_bot?startapp), получить токен можно там же или в [боте «MAX для бизнеса»](https://max.ru/business_bot) с помощью команды **Получить токен**

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