tg_client WebSocket Docs: Domain

Workflow (загальний)

1. Frontend підключається до /ws/chats/.
2. Надсилає {"action":"open_client","userbot_id":...} для старту слухача подій.
3. Надсилає команди (open_dialog, send_message, ...).
4. Consumer публікує їх у Redis канал tg_commands.
5. Listener виконує TDLib методи і публікує відповіді в chat_list_updates.
6. Consumer повертає WS-події клієнту: message, dialog_end, send_message, *_error, media_ready.

Формат запиту: завжди містить action + зазвичай userbot_id.

Client Session

Приклади запитів

{
  "action": "open_client",
  "userbot_ids": [1,2,3]
}

Channel Commands

Приклади запитів

{"action":"get_chats","userbot_id":1}

{"action":"get_recently_opened_chats","userbot_id":1,"limit":20}

{"action":"archive_chat","userbot_id":1,"chat_id":"123"}

{"action":"unarchive_chat","userbot_id":1,"chat_id":"123"}

{"action":"pin_chat","userbot_id":1,"chat_id":"123","is_pinned":true,"chat_list":"chatListMain"}

{"action":"chat_in_folder","userbot_id":1,"chat_id":"123","chat_folder_id":2,"added":true,"removed":false,"pin":false,"unpin":false}

{"action":"create_chat_folder","userbot_id":1,"title":"Робота","icon_name":"Work","is_shareable":true,"included_chat_ids":[-1001234567890]}

{"action":"getChatsForChatFolderInviteLink","userbot_id":1,"chat_folder_id":2}

{"action":"getChatFolderInviteLinks","userbot_id":1,"chat_folder_id":2}

{"action":"createChatFolderInviteLink","userbot_id":1,"chat_folder_id":2,"name":"Команда","chat_ids":[-1001234567890,-1009876543210]}

{"action":"delete_chat","userbot_id":1,"chat_id":"123","revoke":true,"remove_from_chat_list":true}

{"action":"leave_chat","userbot_id":1,"chat_id":"123"}

Для get_chats і get_recently_opened_chats аватарка чату догружається окремо подією media_ready з полем path (URL) та chat_id.

Dialog Commands

Приклади запитів

{"action":"open_dialog","userbot_id":1,"chat_id":"123","from_message_id":"0"}

{"action":"open_dialog","userbot_id":1,"chat_id":"123","from_message_id":"987654321","limit":50,"offset":-50}

{"action":"open_dialog","userbot_id":1,"chat_id":"123","center_message_id":"987654321","window_before":20,"window_after":20}

{"action":"open_dialog","userbot_id":1,"chat_id":"123","message_thread_id":"456","limit":30,"offset":0}

{"action":"search_messages_in_chat","userbot_id":1,"chat_id":"123","query":"при","limit":30}

{"action":"search_messages_in_chat","userbot_id":1,"chat_id":"123","query":"","filter":"searchMessagesFilterPhotoAndVideo","limit":30}

{"action":"search_messages_in_chat","userbot_id":1,"chat_id":"123","filter":"searchMessagesFilterDocument","limit":30}

{"action":"search_messages_in_chat","userbot_id":1,"chat_id":"123","filter":"searchMessagesFilterUrl","limit":30}

{"action":"search_messages_in_chat","userbot_id":1,"chat_id":"123","filter":"searchMessagesFilterVoiceAndVideoNote","limit":30}

{"action":"search_messages_global","userbot_id":1,"query":"при","limit":30}

{"action":"search_messages_global","userbot_id":1,"filter":"searchMessagesFilterUnreadMention","limit":30}

{"action":"get_chat_recent_actions","userbot_id":1,"chat_id":"-1001234567890","limit":50}

{"action":"get_chat_recent_actions","userbot_id":1,"chat_id":"-1001234567890","from_event_id":"987654321","limit":50}

query необов'язковий: для вкладок медіа/файлів/посилань/голосових можна передавати порожній рядок.

Вкладка Недавні дії не є searchMessagesFilter*. Для неї використовуйте окрему команду get_chat_recent_actions (TDLib getChatEventLog).

Search Filters

Filter Aliases

Бекенд також приймає короткі значення: media, files, links, voice, photo, video, document, url тощо.

Вкладка Групи не є окремим TDLib searchMessagesFilter*; її роблять на фронті групуванням результатів (наприклад, за album_id або датою).

Message Commands

Приклади запитів

{"action":"send_message","userbot_id":1,"chat_id":"123456","text":"Привіт","entities":[]}

{"action":"edit_message","userbot_id":1,"chat_id":"123456","message_id":"555","text":"Оновлений текст"}

{"action":"delete_messages","userbot_id":1,"chat_id":"123456","message_ids":["555","556"],"revoke":true}

{"action":"reply_message","userbot_id":1,"chat_id":"123456","reply_to_message_id":"555","text":"Відповідь"}

{"action":"forward_message","userbot_id":1,"to_chat_ids":["111","222"],"from_chat_id":"123456","message_ids":["555"]}

{"action":"pin_message","userbot_id":1,"chat_id":"123456","message_id":"555","disable_notification":false,"only_for_self":false}

{"action":"unpin_message","userbot_id":1,"chat_id":"123456","message_id":"555"}

{"action":"set_reaction","userbot_id":1,"chat_id":"123456","message_id":"555","reaction":{"type":"emoji","emoji":"🔥"},"is_big":false,"add_to_recent":true}

{"action":"set_reaction","userbot_id":1,"chat_id":"123456","message_id":"555","reaction":{"type":"custom_emoji","custom_emoji_id":"5393021912655030923"}}

Media Commands

Приклади запитів

{"action":"download_file","userbot_id":1,"file_id":123456,"source":"dialogs","chat_id":"123456","msg_id":"555","message_thread_id":"456","extra":{"kind":"manual"}}

{"action":"get_prem_path","userbot_id":1,"emoji_id":"5393021912655030923"}

{"action":"get_recent_stickers","userbot_id":1,"is_attached":false}

{"action":"get_stickers_pack","userbot_id":1,"query":"","limit":20,"offset":0,"with_lottie":false,"wait_media_ready":true}

User / Chat Profiles / Contacts

Приклади запитів

{"action":"search_user","userbot_id":1,"username":"durov"}

{"action":"create_private_chat","userbot_id":1,"user_id":777000,"force":false}

{"action":"create_supergroup_chat","userbot_id":1,"title":"Моя група","is_channel":false,"description":"Опис групи"}

{"action":"create_supergroup_chat","userbot_id":1,"title":"Мій канал","is_channel":true,"description":"Опис каналу"}

{"action":"open_dialog","userbot_id":1,"chat_id":"123456789","from_message_id":"0"}

{"action":"get_user","userbot_id":1,"user_id":"777000"}

{"action":"get_chat_profile","userbot_id":1,"chat_id":"-1001234567890"}

{"action":"set_name","userbot_id":1,"first_name":"Pavlo","last_name":"Petrenko"}

{"action":"set_name","userbot_id":1,"full_name":"Pavlo Petrenko"}

{"action":"set_bio","userbot_id":1,"bio":"Backend engineer"}

{"action":"set_bio","userbot_id":1,"bio":""}

{"action":"set_username","userbot_id":1,"username":"pavlo_dev"}

{"action":"set_username","userbot_id":1,"username":""}

{"action":"set_birthdate","userbot_id":1,"day":17,"month":5,"year":1998}

{"action":"set_birthdate","userbot_id":1,"day":17,"month":5,"year":0}

{"action":"set_birthdate","userbot_id":1,"birthdate":{"day":17,"month":5,"year":1998}}

{"action":"set_birthdate","userbot_id":1,"birthdate":null}

{"action":"set_chat_title","userbot_id":1,"chat_id":"-1001234567890","title":"Новий заголовок"}

{"action":"set_chat_description","userbot_id":1,"chat_id":"-1001234567890","description":"Новий опис"}

{"action":"set_chat_permissions","userbot_id":1,"chat_id":"-1001234567890","permissions":{"can_send_basic_messages":true,"can_send_photos":true,"can_send_videos":true,"can_send_polls":false,"can_add_link_previews":true,"can_invite_users":true}}

{"action":"check_chat_username","userbot_id":1,"chat_id":"-1001234567890","username":"my_channel"}

{"action":"set_supergroup_username","userbot_id":1,"chat_id":"-1001234567890","username":"my_channel"}

{"action":"set_supergroup_username","userbot_id":1,"chat_id":"-1001234567890","username":""}

{"action":"toggle_chat_has_protected_content","userbot_id":1,"chat_id":"-1001234567890","has_protected_content":true}

{"action":"set_chat_slow_mode_delay","userbot_id":1,"chat_id":"-1001234567890","slow_mode_delay":60}

{"action":"set_chat_slow_mode_delay","userbot_id":1,"chat_id":"-1001234567890","slow_mode_delay":0}

{"action":"set_chat_direct_messages_group","userbot_id":1,"chat_id":"-1001234567890","is_enabled":true,"paid_message_star_count":0}

{"action":"set_chat_direct_messages_group","userbot_id":1,"chat_id":"-1001234567890","is_enabled":true,"paid_message_star_count":100}

{"action":"set_chat_direct_messages_group","userbot_id":1,"chat_id":"-1001234567890","is_enabled":false,"paid_message_star_count":0}

{"action":"set_chat_discussion_group","userbot_id":1,"chat_id":"-1001234567890","discussion_chat_id":"-1009876543210"}

{"action":"set_chat_discussion_group","userbot_id":1,"chat_id":"-1001234567890","discussion_chat_id":0}

{"action":"get_suitable_discussion_chats","userbot_id":1}

{"action":"get_suitable_personal_chats","userbot_id":1}

{"action":"set_personal_chat","userbot_id":1,"chat_id":"-1001234567890"}

{"action":"hide_personal_chat","userbot_id":1}

{"action":"get_chat_members","userbot_id":1,"chat_id":"-1001234567890","limit":30,"offset":0,"filter":"recent"}

{"action":"get_chat_members","userbot_id":1,"chat_id":"-1001234567890","limit":30,"query":"andrey","filter":"members"}

{"action":"get_chat_members","userbot_id":1,"chat_id":"-1001234567890","limit":30,"offset":0,"filter":"admins"}

{"action":"get_chat_members","userbot_id":1,"chat_id":"-1001234567890","limit":30,"offset":0,"filter":"blocked"}

{"action":"import_contacts","userbot_id":1,"phone":"+380991112233","first_name":"Ivan","last_name":"Petrenko","vcard":"","contact_user_id":0}

{"action":"block_user","userbot_id":1,"user_id":777000,"is_blocked":true}

{"action":"block_user","userbot_id":1,"user_id":777000,"is_blocked":false}

{"action":"unblock_user","userbot_id":1,"user_id":777000}

{"action":"get_blocked_users","userbot_id":1,"offset":0,"limit":50}

{"action":"get_privacy_setting","userbot_id":1,"setting":"last_seen"}

{"action":"get_privacy_settings","userbot_id":1,"settings":["phone_number","last_seen","groups_and_channels","calls","profile_photo","bio","gifts","birthdate","forwarded_messages","voice_messages","messages"]}

{"action":"set_privacy_setting","userbot_id":1,"setting":"last_seen","mode":"nobody","always_allow_user_ids":[777000,123456789],"never_allow_user_ids":[987654321]}

{"action":"set_privacy_setting","userbot_id":1,"setting":"groups_and_channels","mode":"contacts","allow_chat_ids":[-1001234567890]}

{"action":"set_privacy_setting","userbot_id":1,"setting":"messages","allow_new_chats_from_unknown_users":true}

{"action":"add_chat_member","userbot_id":1,"chat_id":"-1001234567890","user_id":777000,"forward_limit":0}

{"action":"add_chat_members","userbot_id":1,"chat_id":"-1001234567890","user_ids":[777000,123456789]}

{"action":"remove_chat_member","userbot_id":1,"chat_id":"-1001234567890","user_id":777000,"revoke_messages":false}

{"action":"restore_chat_member","userbot_id":1,"chat_id":"-1001234567890","user_id":777000}

{"action":"add_chat_administrator","userbot_id":1,"chat_id":"-1001234567890","user_id":777000,"custom_title":"Модератор"}

{"action":"add_chat_administrator","userbot_id":1,"chat_id":"-1001234567890","user_id":777000,"rights":{"can_delete_messages":true,"can_invite_users":true,"can_manage_chat":true}}

{"action":"transfer_chat_ownership","userbot_id":1,"chat_id":"-1001234567890","user_id":777000,"password":"your_2fa_password"}

{"action":"get_password_state","userbot_id":1}

{"action":"verify_2fa_password","userbot_id":1,"password":"current_2fa_password"}

{"action":"change_2fa_password","userbot_id":1,"current_password":"current_2fa_password","new_password":"new_2fa_password","new_hint":"My hint"}

{"action":"change_2fa_password","userbot_id":1,"current_password":"current_2fa_password","new_password":"new_2fa_password","new_hint":"My hint","set_recovery_email_address":true,"new_recovery_email_address":"me@example.com"}

{"action":"disable_2fa_password","userbot_id":1,"current_password":"current_2fa_password"}

{"action":"change_2fa_recovery_email","userbot_id":1,"current_password":"current_2fa_password","new_recovery_email_address":"new@example.com"}

{"action":"get_transfer_ownership_state","userbot_id":1}

{"action":"toggle_supergroup_sign_messages","userbot_id":1,"chat_id":"-1001234567890","sign_messages":true}

{"action":"toggle_supergroup_sign_messages","userbot_id":1,"chat_id":"-1001234567890","sign_messages":true,"show_message_sender":true}

{"action":"toggle_supergroup_is_all_history_available","userbot_id":1,"chat_id":"-1001234567890","is_all_history_available":true}

{"action":"toggle_supergroup_is_forum","userbot_id":1,"chat_id":"-1001234567890","is_forum":true}

{"action":"toggle_supergroup_is_forum","userbot_id":1,"chat_id":"-1001234567890","is_forum":false}

{"action":"get_chat_invite_links","userbot_id":1,"chat_id":"-1001234567890","is_revoked":false,"limit":50}

{"action":"create_chat_invite_link","userbot_id":1,"chat_id":"-1001234567890","name":"Ads A","expiration_date":0,"member_limit":0,"creates_join_request":false}

{"action":"create_chat_subscription_invite_link","userbot_id":1,"chat_id":"-1001234567890","name":"Paid 30d","subscription_pricing":{"period":2592000,"star_count":100}}

{"action":"edit_chat_subscription_invite_link","userbot_id":1,"chat_id":"-1001234567890","invite_link":"https://t.me/+paid_abc","name":"Paid 30d (new name)"}

{"action":"edit_chat_invite_link","userbot_id":1,"chat_id":"-1001234567890","invite_link":"https://t.me/+abc","name":"Ads A v2","member_limit":100}

{"action":"revoke_chat_invite_link","userbot_id":1,"chat_id":"-1001234567890","invite_link":"https://t.me/+abc"}

{"action":"replace_primary_chat_invite_link","userbot_id":1,"chat_id":"-1001234567890"}

{"action":"delete_revoked_chat_invite_link","userbot_id":1,"chat_id":"-1001234567890","invite_link":"https://t.me/+abc"}

{"action":"delete_all_revoked_chat_invite_links","userbot_id":1,"chat_id":"-1001234567890","creator_user_id":777000}

{"action":"get_chat_join_requests","userbot_id":1,"chat_id":"-1001234567890","invite_link":"","query":"","limit":50}

{"action":"get_chat_invite_link_members","userbot_id":1,"chat_id":"-1001234567890","invite_link":"https://t.me/+abc","only_with_expired_subscription":false,"limit":50}

{"action":"process_chat_join_request","userbot_id":1,"chat_id":"-1001234567890","user_id":777000,"approve":true}

{"action":"process_chat_join_requests","userbot_id":1,"chat_id":"-1001234567890","invite_link":"","approve":true}

{"action":"process_chat_join_requests","userbot_id":1,"chat_id":"-1001234567890","invite_link":"","approve":false}

Profile Responses (скорочено)

get_user

{
  "type": "chat_update",
  "payload": {
    "type": "get_user",
    "result": {
      "@type": "user",
      "id": 777000,
      "parsed_status": "recently",
      "last_seen": null,
      "profile_photo": {"type":"profilePhoto","file_id":123,"sizes":[...]},
      "full_info": {"@type":"userFullInfo", "...":"..."}
    }
    }
}

create_private_chat

{
  "type": "chat_update",
  "payload": {
    "type": "create_private_chat",
    "result": {
      "@type": "chat",
      "id": 123456789,
      "type": {"@type": "chatTypePrivate", "user_id": 777000}
    }
  }
}

get_chat_profile

{
  "type": "chat_update",
  "payload": {
    "type": "get_chat_profile",
    "result": {
      "@type": "chat",
      "id": -1001234567890,
      "profile_photo": {"type":"profilePhoto","file_id":456,"sizes":[...]},
      "chat_full_info": {"@type":"chatFullInfo", "...":"..."},
      "supergroup": {"@type":"supergroup", "...":"..."},
      "supergroup_full_info": {"@type":"supergroupFullInfo", "...":"..."},
      "basic_group": null,
      "basic_group_full_info": null
    }
  }
}

get_chat_recent_actions

{
  "type": "chat_update",
  "payload": {
    "type": "get_chat_recent_actions",
    "result": {
      "chat_id": "-1001234567890",
      "chat_type": "chatTypeSupergroup",
      "is_channel": true,
      "query": "",
      "from_event_id": 0,
      "limit": 50,
      "count": 2,
      "next_from_event_id": "987654321",
      "events": [
        {
          "id": "987654322",
          "date": 1730000000,
          "timestamp": "27.10.2024 10:13",
          "actor": {"type":"user","user_id":1,"first_name":"Ivan","last_name":"Petrenko","full_name":"Ivan Petrenko","username":"ivan"},
          "action_type": "chatEventMessagePinned",
          "action_title_uk": "Закріплено повідомлення",
          "text_uk": "Ivan Petrenko — Закріплено повідомлення",
          "details": {"pinned_message":{"msg_id":123,"text":"Важливе повідомлення","type_msg":"messageText","content":[]}}
        }
      ],
      "raw_events": [
        {"@type":"chatEvent","id":"987654322","date":1730000000,"member_id":{"@type":"messageSenderUser","user_id":1},"action":{"@type":"chatEventMessagePinned","message":{}}}
      ]
    }
  }
}

import_contacts

{
  "type": "chat_update",
  "payload": {
    "type": "import_contacts",
    "result": {
      "@type": "importedContacts",
      "user_ids": [777000],
      "importer_count": [0],
      "requested_contact": {
        "phone_number": "+380991112233",
        "first_name": "Ivan",
        "last_name": "Petrenko",
        "vcard": "",
        "user_id": 0
      },
      "contacts": [
        {
          "user_id": 777000,
          "phone_number": "+380991112233",
          "first_name": "Pavel",
          "last_name": "Durov",
          "username": "durov",
          "profile": {"id": 777000, "...": "..."}
        }
      ]
    }
  }
}

block_user

{
  "type": "chat_update",
  "payload": {
    "type": "block_user",
    "result": {"@type": "ok"}
  }
}

get_chat_members

{
  "type": "chat_update",
  "payload": {
    "type": "get_chat_members",
    "result": {
      "chat_id": "-1001234567890",
      "chat_type": "chatTypeSupergroup",
      "query": "",
      "filter": "recent",
      "offset": 0,
      "limit": 30,
      "count": 30,
      "total_count": 154,
      "next_offset": 30,
      "members": [
        {
          "sender_type": "user",
          "user_id": 123456,
          "first_name": "Andrey",
          "last_name": "Marchenko",
          "full_name": "Andrey Marchenko",
          "username": "andrey",
          "phone_number": "+380...",
          "parsed_status": "online",
          "last_seen": null,
          "member_status": {"type":"chatMemberStatusAdministrator","role":"admin","custom_title":"модер"}
        }
      ]
    }
  }
}

Фільтри для get_chat_members: recent, members, admins, contacts, bots, mentions, restricted, banned. Також підтримуються alias-и blocked/blocked_users (мапляться на banned). Можна передавати й оригінальні TDLib типи.

Privacy aliases для setting: phone_number, last_seen, groups_and_channels, calls, profile_photo, bio, gifts, birthdate, forwarded_messages, saved_music, saved_messages, voice_messages, messages. Режими: all, contacts, nobody. Для user exceptions використовуйте allow_user_ids/restrict_user_ids або alias-и always_allow_user_ids/never_allow_user_ids.

Frontend: Profile Data Permissions

Для get_chat_profile фронт орієнтується на result.permissions. Якщо прапорець false, відповідну дію в UI треба блокувати або ховати.

Додаткові поля для рішень UI

Важливо: у каналах/супергрупах permissions описують базові права учасника. Права адміна треба брати окремо зі статусу учасника (не з цього блоку).

Frontend: Chat With Topics (повний приклад + повний опис полів)

Це приклад get_chat_profile для супергрупи з топіками (supergroup.is_forum=true, view_as_topics=true). Нижче наведено payload без скорочень і повну розшифровку.

Повний result приклад для forum chat

{
  "@type": "chat",
  "id": -1001987658875,
  "type": {
    "@type": "chatTypeSupergroup",
    "supergroup_id": 1987658875,
    "is_channel": false
  },
  "title": "Румыния ИТ чат 🇺🇦🇷🇴🇪🇺",
  "accent_color_id": 6,
  "background_custom_emoji_id": "0",
  "profile_accent_color_id": -1,
  "profile_background_custom_emoji_id": "0",
  "permissions": {
    "@type": "chatPermissions",
    "can_send_basic_messages": true,
    "can_send_audios": true,
    "can_send_documents": true,
    "can_send_photos": true,
    "can_send_videos": true,
    "can_send_video_notes": true,
    "can_send_voice_notes": true,
    "can_send_polls": true,
    "can_send_other_messages": true,
    "can_add_link_previews": true,
    "can_change_info": false,
    "can_invite_users": true,
    "can_pin_messages": false,
    "can_create_topics": false
  },
  "positions": [
    {
      "@type": "chatPosition",
      "list": {
        "@type": "chatListMain"
      },
      "order": "7608161469645737115",
      "is_pinned": false
    }
  ],
  "chat_lists": [
    {
      "@type": "chatListFolder",
      "chat_folder_id": 22
    },
    {
      "@type": "chatListFolder",
      "chat_folder_id": 97
    },
    {
      "@type": "chatListMain"
    }
  ],
  "message_sender_id": {
    "@type": "messageSenderUser",
    "user_id": 410102970
  },
  "has_protected_content": false,
  "is_translatable": false,
  "is_marked_as_unread": false,
  "view_as_topics": true,
  "has_scheduled_messages": false,
  "can_be_deleted_only_for_self": false,
  "can_be_deleted_for_all_users": false,
  "can_be_reported": true,
  "default_disable_notification": false,
  "unread_count": 4417,
  "last_read_inbox_message_id": 840411643904,
  "last_read_outbox_message_id": 845165887488,
  "unread_mention_count": 0,
  "unread_reaction_count": 0,
  "notification_settings": {
    "@type": "chatNotificationSettings",
    "use_default_mute_for": false,
    "mute_for": 376070182,
    "use_default_sound": true,
    "sound_id": "-1",
    "use_default_show_preview": true,
    "show_preview": false,
    "use_default_mute_stories": true,
    "mute_stories": false,
    "use_default_story_sound": true,
    "story_sound_id": "-1",
    "use_default_show_story_sender": true,
    "show_story_sender": true,
    "use_default_disable_pinned_message_notifications": true,
    "disable_pinned_message_notifications": false,
    "use_default_disable_mention_notifications": true,
    "disable_mention_notifications": false
  },
  "available_reactions": {
    "@type": "chatAvailableReactionsAll",
    "max_reaction_count": 11
  },
  "message_auto_delete_time": 0,
  "theme_name": "",
  "reply_markup_message_id": 0,
  "client_data": "",
  "profile_photo": {
    "type": "profilePhoto",
    "file_id": 4390,
    "sizes": [
      {
        "file_id": 4390,
        "type": "a",
        "width": 160,
        "height": 160
      },
      {
        "file_id": 4391,
        "type": "b",
        "width": 320,
        "height": 320
      },
      {
        "file_id": 4392,
        "type": "c",
        "width": 640,
        "height": 640
      }
    ],
    "width": 160,
    "height": 160
  },
  "chat_full_info": {},
  "supergroup": {
    "@type": "supergroup",
    "id": 1987658875,
    "usernames": {
      "@type": "usernames",
      "active_usernames": [
        "romaniaitcommunity"
      ],
      "disabled_usernames": [],
      "editable_username": "romaniaitcommunity"
    },
    "date": 1755500986,
    "status": {
      "@type": "chatMemberStatusMember",
      "member_until_date": 0
    },
    "member_count": 2048,
    "boost_level": 0,
    "has_linked_chat": false,
    "has_location": false,
    "sign_messages": true,
    "show_message_sender": true,
    "join_to_send_messages": true,
    "join_by_request": false,
    "is_slow_mode_enabled": false,
    "is_channel": false,
    "is_broadcast_group": false,
    "is_forum": true,
    "has_sensitive_content": false,
    "restriction_reason": "",
    "has_active_stories": false,
    "has_unread_active_stories": false
  },
  "supergroup_full_info": {
    "@type": "supergroupFullInfo",
    "description": "",
    "member_count": 2048,
    "administrator_count": 0,
    "restricted_count": 0,
    "banned_count": 0,
    "linked_chat_id": 0,
    "slow_mode_delay": 0,
    "slow_mode_delay_expires_in": 0.0,
    "can_enable_paid_reaction": false,
    "can_get_members": true,
    "has_hidden_members": true,
    "can_hide_members": false,
    "can_set_sticker_set": false,
    "can_set_location": false,
    "can_get_statistics": false,
    "can_get_revenue_statistics": false,
    "can_get_star_revenue_statistics": false,
    "can_toggle_aggressive_anti_spam": false,
    "is_all_history_available": true,
    "can_have_sponsored_messages": true,
    "has_aggressive_anti_spam_enabled": false,
    "has_paid_media_allowed": false,
    "has_pinned_stories": false,
    "my_boost_count": 0,
    "unrestrict_boost_count": 0,
    "sticker_set_id": "0",
    "custom_emoji_sticker_set_id": "0",
    "bot_commands": [
      {
        "@type": "botCommands",
        "bot_user_id": 313092884,
        "commands": [
          {
            "@type": "botCommand",
            "command": "help",
            "description": "Get list of commands"
          }
        ]
      }
    ],
    "upgraded_from_basic_group_id": 0,
    "upgraded_from_max_message_id": 0
  },
  "basic_group": null,
  "basic_group_full_info": null
}

Розшифровка кореневих полів chat

Розшифровка permissions (повністю)

Розшифровка positions і chat_lists

Розшифровка notification_settings (повністю)

Розшифровка available_reactions і profile_photo

Розшифровка supergroup (повністю)

Розшифровка supergroup_full_info (повністю)

Розшифровка bot_commands

Frontend: Channel Chat (is_channel=true, повний приклад + повний опис полів)

Це приклад get_chat_profile для каналу (type.is_channel=true, supergroup.is_channel=true). Нижче наведено повний payload і повну розшифровку для фронту.

Повний result приклад для channel

{
  "@type": "chat",
  "id": -1001938032452,
  "type": {
    "@type": "chatTypeSupergroup",
    "supergroup_id": 1938032452,
    "is_channel": true
  },
  "title": "АРЕНДА КВАРТИР БУХАРЕСТ | снять жильё в Румынии | недвижимость Румыния",
  "accent_color_id": 1,
  "background_custom_emoji_id": "0",
  "profile_accent_color_id": -1,
  "profile_background_custom_emoji_id": "0",
  "permissions": {
    "@type": "chatPermissions",
    "can_send_basic_messages": false,
    "can_send_audios": false,
    "can_send_documents": false,
    "can_send_photos": false,
    "can_send_videos": false,
    "can_send_video_notes": false,
    "can_send_voice_notes": false,
    "can_send_polls": false,
    "can_send_other_messages": false,
    "can_add_link_previews": false,
    "can_change_info": false,
    "can_invite_users": false,
    "can_pin_messages": false,
    "can_create_topics": false
  },
  "positions": [
    {
      "@type": "chatPosition",
      "list": {
        "@type": "chatListMain"
      },
      "order": "7607748611618656527",
      "is_pinned": false
    }
  ],
  "chat_lists": [
    {
      "@type": "chatListFolder",
      "chat_folder_id": 97
    },
    {
      "@type": "chatListMain"
    }
  ],
  "has_protected_content": false,
  "is_translatable": false,
  "is_marked_as_unread": false,
  "view_as_topics": false,
  "has_scheduled_messages": false,
  "can_be_deleted_only_for_self": false,
  "can_be_deleted_for_all_users": false,
  "can_be_reported": true,
  "default_disable_notification": false,
  "unread_count": 45,
  "last_read_inbox_message_id": 21702377472,
  "last_read_outbox_message_id": 2251799812636672,
  "unread_mention_count": 0,
  "unread_reaction_count": 0,
  "notification_settings": {
    "@type": "chatNotificationSettings",
    "use_default_mute_for": false,
    "mute_for": 376071013,
    "use_default_sound": true,
    "sound_id": "-1",
    "use_default_show_preview": true,
    "show_preview": false,
    "use_default_mute_stories": true,
    "mute_stories": false,
    "use_default_story_sound": true,
    "story_sound_id": "-1",
    "use_default_show_story_sender": true,
    "show_story_sender": true,
    "use_default_disable_pinned_message_notifications": true,
    "disable_pinned_message_notifications": false,
    "use_default_disable_mention_notifications": true,
    "disable_mention_notifications": false
  },
  "available_reactions": {
    "@type": "chatAvailableReactionsSome",
    "reactions": [
      {
        "@type": "reactionTypePaid"
      },
      {
        "@type": "reactionTypeEmoji",
        "emoji": "❤"
      },
      {
        "@type": "reactionTypeEmoji",
        "emoji": "👍"
      },
      {
        "@type": "reactionTypeEmoji",
        "emoji": "🔥"
      },
      {
        "@type": "reactionTypeEmoji",
        "emoji": "🥰"
      },
      {
        "@type": "reactionTypeEmoji",
        "emoji": "👏"
      },
      {
        "@type": "reactionTypeEmoji",
        "emoji": "😱"
      },
      {
        "@type": "reactionTypeEmoji",
        "emoji": "🎉"
      },
      {
        "@type": "reactionTypeEmoji",
        "emoji": "🤩"
      },
      {
        "@type": "reactionTypeEmoji",
        "emoji": "🙏"
      },
      {
        "@type": "reactionTypeEmoji",
        "emoji": "👌"
      },
      {
        "@type": "reactionTypeEmoji",
        "emoji": "😍"
      }
    ],
    "max_reaction_count": 4
  },
  "message_auto_delete_time": 0,
  "theme_name": "",
  "reply_markup_message_id": 0,
  "client_data": "",
  "profile_photo": {
    "type": "profilePhoto",
    "file_id": 4158,
    "sizes": [
      {
        "file_id": 4158,
        "type": "a",
        "width": 160,
        "height": 160
      },
      {
        "file_id": 4159,
        "type": "b",
        "width": 320,
        "height": 320
      },
      {
        "file_id": 4160,
        "type": "c",
        "width": 640,
        "height": 640
      }
    ],
    "width": 160,
    "height": 160
  },
  "chat_full_info": {},
  "supergroup": {
    "@type": "supergroup",
    "id": 1938032452,
    "usernames": {
      "@type": "usernames",
      "active_usernames": [
        "arenda_bucharest",
        "rent_ro",
        "nedvizhimost_romania",
        "bucharest_homes",
        "kvartira_bucharest",
        "arenda_militari_chiajna",
        "rent_romania",
        "arenda_kvartir_romania",
        "arenda_chiajna",
        "apartaments_romania"
      ],
      "disabled_usernames": [],
      "editable_username": "arenda_bucharest"
    },
    "date": 1722159227,
    "status": {
      "@type": "chatMemberStatusMember",
      "member_until_date": 0
    },
    "member_count": 11696,
    "boost_level": 2,
    "has_linked_chat": true,
    "has_location": false,
    "sign_messages": false,
    "show_message_sender": false,
    "join_to_send_messages": true,
    "join_by_request": false,
    "is_slow_mode_enabled": false,
    "is_channel": true,
    "is_broadcast_group": false,
    "is_forum": false,
    "has_sensitive_content": false,
    "restriction_reason": "",
    "has_active_stories": false,
    "has_unread_active_stories": false
  },
  "supergroup_full_info": {
    "@type": "supergroupFullInfo",
    "description": "🏙 Снять квартиру в Бухаресте легко!\n\n✨ Новые варианты каждый день — только проверенные объекты\n\n💬 WhatsApp\n🇷🇴 +40 750 263 266\nhttps://wa.me/40750263266\n\n✈️ Telegram\nt.me/realtor_militari_bot\n\n🏠 Канал с квартирами\nt.me/rent_ro",
    "member_count": 11696,
    "administrator_count": 0,
    "restricted_count": 0,
    "banned_count": 0,
    "linked_chat_id": -1002435456208,
    "slow_mode_delay": 0,
    "slow_mode_delay_expires_in": 0.0,
    "can_enable_paid_reaction": true,
    "can_get_members": false,
    "has_hidden_members": true,
    "can_hide_members": false,
    "can_set_sticker_set": false,
    "can_set_location": false,
    "can_get_statistics": false,
    "can_get_revenue_statistics": false,
    "can_get_star_revenue_statistics": false,
    "can_toggle_aggressive_anti_spam": false,
    "is_all_history_available": true,
    "can_have_sponsored_messages": true,
    "has_aggressive_anti_spam_enabled": false,
    "has_paid_media_allowed": true,
    "has_pinned_stories": true,
    "my_boost_count": 0,
    "unrestrict_boost_count": 0,
    "sticker_set_id": "0",
    "custom_emoji_sticker_set_id": "0",
    "bot_commands": [],
    "upgraded_from_basic_group_id": 0,
    "upgraded_from_max_message_id": 0
  },
  "basic_group": null,
  "basic_group_full_info": null
}

Кореневі поля chat для channel (повністю)

permissions для channel (повністю)

supergroup для channel (повністю)

supergroup_full_info для channel (повністю)

Frontend: Basic Group Chat (chatTypeBasicGroup, повний приклад + повний опис полів)

Це приклад get_chat_profile для basic group (type.@type=chatTypeBasicGroup). Нижче повний payload та повна розшифровка.

Повний result приклад для basic group

{
  "@type": "chat",
  "id": -232048874,
  "type": {
    "@type": "chatTypeBasicGroup",
    "basic_group_id": 232048874
  },
  "title": "Братья во Христе",
  "accent_color_id": 1,
  "background_custom_emoji_id": "0",
  "profile_accent_color_id": -1,
  "profile_background_custom_emoji_id": "0",
  "permissions": {
    "@type": "chatPermissions",
    "can_send_basic_messages": true,
    "can_send_audios": true,
    "can_send_documents": true,
    "can_send_photos": true,
    "can_send_videos": true,
    "can_send_video_notes": true,
    "can_send_voice_notes": true,
    "can_send_polls": true,
    "can_send_other_messages": true,
    "can_add_link_previews": true,
    "can_change_info": true,
    "can_invite_users": true,
    "can_pin_messages": true,
    "can_create_topics": true
  },
  "positions": [],
  "chat_lists": [
    {
      "@type": "chatListFolder",
      "chat_folder_id": 22
    },
    {
      "@type": "chatListMain"
    }
  ],
  "has_protected_content": false,
  "is_translatable": false,
  "is_marked_as_unread": false,
  "view_as_topics": false,
  "has_scheduled_messages": false,
  "can_be_deleted_only_for_self": true,
  "can_be_deleted_for_all_users": true,
  "can_be_reported": false,
  "default_disable_notification": false,
  "unread_count": 0,
  "last_read_inbox_message_id": 117958508544,
  "last_read_outbox_message_id": 1012791246848,
  "unread_mention_count": 0,
  "unread_reaction_count": 0,
  "notification_settings": {
    "@type": "chatNotificationSettings",
    "use_default_mute_for": true,
    "mute_for": 0,
    "use_default_sound": true,
    "sound_id": "-1",
    "use_default_show_preview": true,
    "show_preview": false,
    "use_default_mute_stories": true,
    "mute_stories": false,
    "use_default_story_sound": true,
    "story_sound_id": "-1",
    "use_default_show_story_sender": true,
    "show_story_sender": true,
    "use_default_disable_pinned_message_notifications": true,
    "disable_pinned_message_notifications": false,
    "use_default_disable_mention_notifications": true,
    "disable_mention_notifications": false
  },
  "available_reactions": {
    "@type": "chatAvailableReactionsAll",
    "max_reaction_count": 11
  },
  "message_auto_delete_time": 0,
  "theme_name": "",
  "reply_markup_message_id": 0,
  "client_data": "",
  "profile_photo": null,
  "chat_full_info": {},
  "supergroup": null,
  "supergroup_full_info": null,
  "basic_group": {
    "@type": "basicGroup",
    "id": 232048874,
    "member_count": 2,
    "status": {
      "@type": "chatMemberStatusCreator",
      "custom_title": "",
      "is_anonymous": false,
      "is_member": true
    },
    "is_active": true,
    "upgraded_to_supergroup_id": 0
  },
  "basic_group_full_info": {
    "@type": "basicGroupFullInfo",
    "description": "",
    "creator_user_id": 410102970,
    "members": [
      {
        "@type": "chatMember",
        "member_id": {
          "@type": "messageSenderUser",
          "user_id": 371611338
        },
        "inviter_user_id": 483030274,
        "joined_chat_date": 1516898518,
        "status": {
          "@type": "chatMemberStatusMember",
          "member_until_date": 0
        }
      },
      {
        "@type": "chatMember",
        "member_id": {
          "@type": "messageSenderUser",
          "user_id": 410102970
        },
        "inviter_user_id": 410102970,
        "joined_chat_date": 1516898215,
        "status": {
          "@type": "chatMemberStatusCreator",
          "custom_title": "",
          "is_anonymous": false,
          "is_member": true
        }
      }
    ],
    "can_hide_members": false,
    "can_toggle_aggressive_anti_spam": false,
    "invite_link": {
      "@type": "chatInviteLink",
      "invite_link": "https://t.me/+vCoG9XuaHRs3YTAy",
      "name": "",
      "creator_user_id": 410102970,
      "date": 1623860436,
      "edit_date": 0,
      "expiration_date": 0,
      "member_limit": 0,
      "member_count": 0,
      "expired_member_count": 0,
      "pending_join_request_count": 0,
      "creates_join_request": false,
      "is_primary": true,
      "is_revoked": false
    },
    "bot_commands": []
  }
}

Ключові поля basic group

permissions для basic group (повністю)

basic_group і basic_group_full_info (повністю)

Окремо: якщо поточний користувач адміністратор basic group

Важливо: для basic group роль користувача (member/admin/creator) визначається насамперед через basic_group.status. Прапорці permissions описують дозволи в чаті, але не замінюють role-based перевірку для адмінських екранів.