Оновлення WebSocket API

chat_list_change та chat_list_sync

Backend зберігає повний materialized item у projection, але передає frontend лише різницю. Однакова версія item не створює нової revision.

{
  "operation":"patch",
  "format":"json_patch_v1",
  "revision":1843,
  "chat_id":"-100123",
  "patch":[
    {"op":"replace","path":"/chat/unread_count","value":4},
    {"op":"replace","path":"/last_message/text","value":"Нове повідомлення"}
  ]
}

Frontend застосовує операції add, replace і remove до вже наявного item та лише після успішного застосування зберігає revision. Масиви замінюються цілком. Якщо item відсутній, revision пропущена або reset_required=true, необхідно виконати повний get_chats.

Live update містить change у payload.chat_list_change. Після reconnect надішліть {"action":"sync_chat_list","userbot_id":183,"since_revision":1843}. Повний код застосування patch наведений у Domain Core Reference.

forward_message: альбомний flow

Для збереження grouping frontend передає всі повідомлення source-альбому одним масивом. Backend сортує ID, прибирає дублікати та робить один forwardMessages на кожний елемент to_chat_ids[]. Ліміт TDLib — 100 унікальних повідомлень за batch.

{
  "action": "forward_message",
  "userbot_id": 183,
  "from_chat_id": "-1001234567890",
  "to_chat_ids": ["700372203"],
  "message_ids": ["555", "556", "557"],
  "send_copy": false,
  "remove_caption": false
}

Telegram не переносить старий album ID між чатами. Він повертає новий спільний ID для пересланих повідомлень:

{
  "type": "forward_message",
  "result": [
    {"message_id":"555","forwarded_message_id":9001,"media_album_id":"778899"},
    {"message_id":"556","forwarded_message_id":9002,"media_album_id":"778899"},
    {"message_id":"557","forwarded_message_id":9003,"media_album_id":"778899"}
  ]
}

У нормалізованих message updates доступні обидві назви з однаковим значенням: album_id і media_album_id. Якщо передати тільки один елемент source-альбому, Telegram не може відновити інші елементи автоматично.

send_copy/without_sender, remove_caption/without_caption, new_caption і show_caption_above_media залишаються підтриманими.

Telegram notifications: actions та updates

Усі команди надсилаються через Control WebSocket. Детальні поля chatNotificationSettings, scopeNotificationSettings, aliases mute і правила active Notification API описані в Notification Settings — Core Reference.

Нові TDLib updates

Групи actions

Швидкі payload-и

{"action":"mute_chat","userbot_id":183,"chat_id":"-100123","mute_for":"8h"}
{"action":"set_chat_notification_settings","userbot_id":183,"chat_id":"-100123","show_preview":false,"use_default_show_preview":false}
{"action":"set_scope_notification_settings","userbot_id":183,"scope":"group","mute_for":0,"show_preview":true}
{"action":"configure_notification_api","userbot_id":183,"notification_group_count_max":25,"notification_group_size_max":10}
{"action":"remove_notification","userbot_id":183,"notification_group_id":17,"notification_id":401}

Badge counter options зі скриншотів є локальними UI/OS preferences. Frontend розраховує badge з updateUnreadChatCount і updateUnreadMessageCount; вони не належать до Telegram notification settings.

Швидкі payload-и