Перейти к содержанию

GetChats

Устарело

Начиная с июня 2026 года метод GET /chats больше не поддерживается — подробности на странице метода в официальной документации MAX.

Рекомендуемая замена — накапливать chat_id из событий bot_added, bot_started, bot_removed и bot_stopped (Long Polling или subscribe_webhook()): сохранять chat_id при bot_added/bot_started, удалять при bot_removed (для диалогов — при bot_stopped). Подробный сценарий — ниже в описании класса и в руководстве по хендлерам.

GetChats(bot, count=None, marker=None)

Bases: BaseConnection

Класс для получения списка чатов.

.. deprecated:: 1.1.0 Начиная с июня 2026 года метод GET /chats больше не поддерживается. Готового списка чатов API не отдаёт ни через Long Polling, ни через Webhook — его нужно накапливать из событий.

Рекомендованный сценарий замены — накапливать chat_id самостоятельно:

  1. Получайте события bot_added, bot_started, bot_removed и bot_stopped — через Long Polling (хендлеры @dp.bot_added() и другие при dp.start_polling()) или через Webhook (bot.subscribe_webhook(url, update_types=[ UpdateType.BOT_ADDED, UpdateType.BOT_STARTED, UpdateType.BOT_REMOVED, UpdateType.BOT_STOPPED])).
  2. Извлекайте chat_id из входящих событий bot_added и bot_started.
  3. Храните chat_id самостоятельно: сохраняйте при получении события, учитывайте возможные дубли и удаляйте по bot_removed (для диалогов — по bot_stopped).
  4. Используйте накопленные chat_id в остальных методах API, например bot.send_message().

https://dev.max.ru/docs-api/methods/GET/chats

Attributes:

Name Type Description
bot

Инициализированный клиент бота.
count

Максимальное количество чатов, возвращаемых за один запрос.
marker

Маркер для продолжения пагинации.
Source code in maxapi/methods/get_chats.py 
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
def __init__(
    self,
    bot: "Bot",
    count: int | None = None,
    marker: int | None = None,
):
    warnings.warn(
        "GetChats устарел: начиная с июня 2026 года GET /chats не "
        "поддерживается — https://dev.max.ru/docs-api/methods/GET/chats. "
        "Ведите список чатов сами по событиям bot_added, bot_started, "
        "bot_removed и bot_stopped (Long Polling или "
        "bot.subscribe_webhook()).",
        DeprecationWarning,
        stacklevel=2,
    )

    if count is not None and not (1 <= count <= 100):
        raise ValueError("count не должен быть меньше 1 или больше 100")

    super().__init__()
    self.bot = bot
    self.count = count
    self.marker = marker

fetch() async

Выполняет GET-запрос для получения списка чатов.

Returns:

Name Type Description
Chats Chats

Объект с данными по списку чатов.
Source code in maxapi/methods/get_chats.py 
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
async def fetch(self) -> Chats:
    """
    Выполняет GET-запрос для получения списка чатов.

    Returns:
        Chats: Объект с данными по списку чатов.
    """

    bot = self._ensure_bot()

    params = bot.params.copy()

    if self.count:
        params["count"] = self.count

    if self.marker is not None:
        params["marker"] = self.marker

    response = await super().request(
        method=HTTPMethod.GET,
        path=ApiPath.CHATS,
        model=Chats,
        params=params,
    )

    return cast(Chats, response)