💬 Чаты

Список чатов из кэша LOGIN-ответа. Заполняется после успешного LOGIN, без дополнительных запросов. Подтверждено ✅

Структура объекта чата

chats = client.cached_chats
for chat in chats:
    unread = chat.get('newMessages', 0)
    last   = chat.get('lastMessage', {}).get('text', '')
    print(f"[{chat['type']}] id={chat['id']} unread={unread}")
    if last:
        print(f"  └─ {last[:60]}")

Возвращает полный список чатов из кэша, полученного при входе (LOGIN, opcode 19). Никаких сетевых запросов не делает.

Delta-опрос: запрашивает у сервера чаты, изменившиеся с момента последнего маркера. Автоматически мёрджит изменения в кэш и обновляет маркер для следующего вызова.

Как работает delta-sync

Протокол реализует delta-синхронизацию через поле marker:

1. При логине LOGIN отдаёт полный снапшот чатов + chatMarker=N
2. poll_chats() отправляет CHATS_LIST{marker: N, count: 50}
3. Сервер возвращает только чаты с новой активностью начиная с маркера N
4. В ответе приходит новый маркер — он сохраняется для следующего poll_chats()

Wire-параметры (opcode 53)

{
  "marker": 0,   # обязательно! без него ошибка proto.payload
  "count":  50
}

Пример

# Получить все чаты (снапшот при входе)
chats = await client.get_chats()

# Получить обновления чатов с момента последнего опроса
delta = await client.poll_chats()
if delta:
    print(f"Обновилось {len(delta)} чатов")

Загружает историю сообщений чата. Подтверждено ✅

Wire-параметры запроса

{
  "chatId":      34540359,
  "from":        1774188368109,  # текущее время в ms ← обязательно!
  "backward":    20,
  "forward":     0,
  "getMessages": true,
  "getChat":     false,
  "itemType":    "REGULAR",  # или "DELAYED"
  "interactive": true
}

Структура сообщения в ответе

Пример

data = await client.get_chat_history(chat_id=34540359, count=10)
for msg in data.get("messages", []):
    text = msg.get("text", "")[:80]
    print(f"[{msg['sender']}]: {text}")

Возвращает полную информацию о чате. Статус текущей Python-обёртки: проблемный / не подтверждён.

info = await client.get_chat_info(chat_id=34540359)

Создаёт новый групповой чат. Статус текущей Python-обёртки: проблемный / не подтверждён.

chat = await client.create_chat(
    title="Моя группа",
    member_ids=[27993802, 12277280]
)

Список участников чата. Подтверждено в бою ✅

Присоединяется к публичному чату/каналу по invite-ссылке. Подтверждено в бою ✅

await client.join_chat("https://max.ru/join/...")

Покидает чат. Подтверждено в бою ✅