⎯ TL;DR
  • Telegram постепенно двигает MTProto: новые transport-флаги, session-string encoding изменения, rate-limit стандартизация.
  • Большинство изменений — обратно-совместимые, но с deprecation window. Если не мигрируешь вовремя — клиент начинает получать warning'и, потом отказы.
  • Ключевые зоны риска: auth.importAuthorization устаревает, новые flood headers, изменения в channels.GetParticipants pagination.
  • Библиотеки (telethon / pyrogram) обновляются с лагом 2-4 недели после ANO. Если используешь свой fork — следи сам.
  • TG:ON обновляется автоматически на стороне сервиса — клиенты не чувствуют миграций.

Telegram публикует изменения MTProto через API Layers. Каждый layer — инкремент: добавляются методы, помечаются deprecated, меняется схема некоторых типов. Текущий layer (по состоянию на момент публикации статьи) — ~180.

Большинство обновлений — мягкие. Telegram редко ломает обратную совместимость в один день. Типичный flow: новый метод появляется → старый помечается deprecated → deprecated работает ещё 6-12 месяцев → потом удаляется.

Но в 2026 ожидается крупная consolidation — одновременно несколько переходов, которые суммарно сделают старые самописные клиенты неработоспособными. Вот что конкретно.

01 · Session encoding

Session-string v2: что меняется

Session-string — это сериализованный auth-ключ, с которым твой клиент входит в Telegram без повторной авторизации. Исторически разные клиенты использовали разные форматы: telethon — pickle+base64, pyrogram — custom binary.

Telegram двигается к стандартизированному формату с обратной совместимостью. Новый формат содержит:

# Новая структура (pseudo) session_v2 = { "version": 2, "dc_id": 4, "auth_key": <256 bytes>, "fingerprint": { "device_model": "iPhone 15", "app_version": "10.8.0", "system_version": "iOS 17.4", "lang_code": "en" }, "created_at": 1714800000 }

Что ломается: клиенты, которые генерировали session-string раньше и передавали fingerprint в каждом подключении, должны теперь включать fingerprint в сам session. Иначе — Telegram возвращает AUTH_KEY_UNREGISTERED.

02 · Rate limits

Новые flood headers: более детальное rate-limiting

Классический FLOOD_WAIT_X — единственный способ Telegram сказать «подожди». В новой схеме появляются дифференцированные headers:

HeaderЧто означаетMitigation
FLOOD_WAIT_XОбщий rate limit (как раньше)Wait X seconds
FLOOD_PREMIUM_WAIT_XLimit на actions для premium-контекстаApply to premium targets
FLOOD_PEER_WAIT_XLimit на сообщения конкретному peer-уPause for that peer only
SLOW_MODE_WAIT_XОграничение в группе со slow modeRespect group's slow mode

Разделение даёт Telegram возможность таргетированно замедлять без блокировки всего аккаунта. Для клиентов это означает: нужно различать типы FloodWait и соответственно обрабатывать.

03 · Deprecations

Endpoints, которые уходят

По наблюдаемым паттернам deprecation, следующие методы в зоне риска:

Если используешь channels.GetParticipants для парсинга — готовься к ограничениям. Возможный workaround: пулить участников через discussion group (если есть) или через GetMessageReactionsList.

04 · Migration

Что делать клиентам на telethon / pyrogram

Если у тебя свой fork одной из популярных Python-библиотек:

  1. Обнови до latest — автор библиотеки обычно патчит новые layer за 1-3 недели. Следи за GitHub releases.
  2. Мигрируй session storage — если ты кеширует session-strings в своей БД, нужно перегенерировать все сессии под v2 формат.
  3. Различай FloodWait subtypes — вместо одной except FloodWait используй 3-4 разных с соответствующим handling.
  4. Логируй warning'и — Telegram часто шлёт non-fatal warnings за deprecated methods. Если их не логируешь — пропустишь предстоящий deprecation.

Если TDLib

Обновление TDLib — автоматически тянет все schema changes. Обычно просто git pull && rebuild. Изменения в session format — чаще всего прозрачные (библиотека делает re-encoding в фоне).

Если SaaS

Вопрос к твоему вендору: «когда планируется миграция на новый MTProto layer?». Нормальный ответ — «уже сделано, клиенты не заметили». Если ответ «когда-нибудь в будущем» — флаг.

05 · TG:ON approach

Почему нас не волнуют миграции

У нас MTProto-клиент написан на уровне TDLib custom fork + собственный schema layer. Изменения API обрабатываются централизованно:

Для пользователя это значит: ты не думаешь о MTProto. Telegram меняет layer → ты этого не замечаешь.

«MTProto меняется 2-3 раза в год. Для self-built клиента это 2-3 окна простоя. Для SaaS с правильной командой — 0.»
⎯ скачать

TG:ON для macOS · Windows · Linux

Desktop-приложение, 160 MB. Работает локально, твои ключи остаются у тебя. 3 дня триала без карты.

Скачать бесплатно
⎯ без боли миграций

MTProto — наша забота.
Пользуйся пайплайном.

TG:ON обновляется автоматически. Не отвлекаешься на session-string v2, новые flood headers, deprecated endpoints. 3 дня триала — проверь стабильность.

Начать триал