2022-05-14 00:37:40 +02:00
<!DOCTYPE html>
< html class = "" >
< head >
< meta charset = "utf-8" >
< title > chat< / title >
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" >
2024-09-18 00:21:45 +02:00
< meta property = "description" content = "Info about a group. When updating the local peer database, all fields from the newly received constructor take priority over the old constructor cached locally (including by removing fields that aren't set in the new constructor). See here » for an implementation of the logic to use when updating the local user peer database." >
2022-05-14 00:37:40 +02:00
< meta property = "og:title" content = "chat" >
< meta property = "og:image" content = "" >
2024-09-18 00:21:45 +02:00
< meta property = "og:description" content = "Info about a group. When updating the local peer database, all fields from the newly received constructor take priority over the old constructor cached locally (including by removing fields that aren't set in the new constructor). See here » for an implementation of the logic to use when updating the local user peer database." >
2022-05-14 00:37:40 +02:00
< link rel = "icon" type = "image/svg+xml" href = "/img/website_icon.svg?4" >
< link rel = "apple-touch-icon" sizes = "180x180" href = "/img/apple-touch-icon.png" >
< link rel = "icon" type = "image/png" sizes = "32x32" href = "/img/favicon-32x32.png" >
< link rel = "icon" type = "image/png" sizes = "16x16" href = "/img/favicon-16x16.png" >
< link rel = "alternate icon" href = "/img/favicon.ico" type = "image/x-icon" / >
< link href = "/css/bootstrap.min.css?3" rel = "stylesheet" >
2024-08-02 02:44:36 +02:00
< link href = "/css/telegram.css?240" rel = "stylesheet" media = "screen" >
2022-05-14 00:37:40 +02:00
< style >
< / style >
< / head >
< body class = "preload" >
< div class = "dev_page_wrap" >
< div class = "dev_page_head navbar navbar-static-top navbar-tg" >
< div class = "navbar-inner" >
< div class = "container clearfix" >
< ul class = "nav navbar-nav navbar-right hidden-xs" > < li class = "navbar-twitter" > < a href = "https://twitter.com/telegram" target = "_blank" data-track = "Follow/Twitter" onclick = "trackDlClick(this, event)" > < i class = "icon icon-twitter" > < / i > < span > Twitter< / span > < / a > < / li > < / ul >
< ul class = "nav navbar-nav" >
< li > < a href = "//telegram.org/" > Home< / a > < / li >
< li class = "hidden-xs" > < a href = "//telegram.org/faq" > FAQ< / a > < / li >
< li class = "hidden-xs" > < a href = "//telegram.org/apps" > Apps< / a > < / li >
< li class = "" > < a href = "/api" > API< / a > < / li >
< li class = "" > < a href = "/mtproto" > Protocol< / a > < / li >
< li class = "active" > < a href = "/schema" > Schema< / a > < / li >
< / ul >
< / div >
< / div >
< / div >
< div class = "container clearfix" >
< div class = "dev_page" >
< div id = "dev_page_content_wrap" class = " " >
< div class = "dev_page_bread_crumbs" > < ul class = "breadcrumb clearfix" > < li > < a href = "/api" > API< / a > < / li > < i class = "icon icon-breadcrumb-divider" > < / i > < li > < a href = "/schema" > TL-schema< / a > < / li > < i class = "icon icon-breadcrumb-divider" > < / i > < li > < a href = "/constructor/chat" > chat< / a > < / li > < / ul > < / div >
< h1 id = "dev_page_title" > chat< / h1 >
2024-09-18 00:21:45 +02:00
< div id = "dev_page_content" > < p > Info about a group.< / p >
< p > When updating the < a href = "/api/peers" > local peer database< / a > , all fields from the newly received constructor take priority over the old constructor cached locally (including by removing fields that aren't set in the new constructor).< / p >
< p > See < a href = "https://github.com/tdlib/td/blob/a24af0992245f838f2b4b418a0a2d5fa9caa27b5/td/telegram/ChatManager.cpp#L5152" > here »< / a > for an implementation of the logic to use when updating the < a href = "/api/peers" > local user peer database< / a > .< / p >
2022-05-14 00:37:40 +02:00
< p > < div class = "clearfix" >
< ul class = "dev_layer_select slightly-pull-right nav nav-pills" >
< li class = "dropdown" >
2024-09-18 00:21:45 +02:00
< a class = "dropdown-toggle" onclick = "return dropdownClick(this, event)" href = "#" > Layer 185 < b class = "caret" > < / b > < / a >
2022-05-14 00:37:40 +02:00
< ul class = "dropdown-menu" >
2024-09-18 00:21:45 +02:00
< li > < a href = "?layer=1" > 1 – Base layer< / a > < / li > < li > < a href = "?layer=2" > 2 – New userpic notifications< / a > < / li > < li > < a href = "?layer=3" > 3 – Send message can trigger link change< / a > < / li > < li > < a href = "?layer=4" > 4 – Check-in chats< / a > < / li > < li > < a href = "?layer=5" > 5 – Localized SMS, localized notifications< / a > < / li > < li > < a href = "?layer=6" > 6 – Foursquare integration< / a > < / li > < li > < a href = "?layer=7" > 7 – Added wallPaperSolid< / a > < / li > < li > < a href = "?layer=8" > 8 – Added end-to-end encryption< / a > < / li > < li > < a href = "?layer=9" > 9 – Improved big files upload perfomance< / a > < / li > < li > < a href = "?layer=10" > 10 – Improved chat participants updates< / a > < / li > < li > < a href = "?layer=11" > 11 – Improved secret chats< / a > < / li > < li > < a href = "?layer=12" > 12 – New dynamic support< / a > < / li > < li > < a href = "?layer=13" > 13 – Audio, video MIME; contacts import retry; new secret actions< / a > < / li > < li > < a href = "?layer=14" > 14 – Notify settings sync, blacklist sync< / a > < / li > < li > < a href = "?layer=15" > 15 – Modified getHistory offset behaviour< / a > < / li > < li > < a href = "?layer=16" > 16 – Split sendCode into 2 parts< / a > < / li > < li > < a href = "?layer=17" > 17 – Added custom typing, introduced message flags< / a > < / li > < li > < a href = "?layer=18" > 18 – Added usernames< / a > < / li > < li > < a href = "?layer=23" > 23 – Stickers for secret chats< / a > < / li > < li > < a href = "?layer=105" > 105 – Scheduled messages, Cloud themes< / a > < / li > < li > < a href = "?layer=108" > 108 – Login with QR code< / a > < / li > < li > < a href = "?layer=109" > 109 – Polls v2< / a > < / li > < li > < a href = "?layer=110" > 110 – People Nearby 2.0, Bank card entity< / a > < / li > < li > < a href = "?layer=111" > 111 – Folders, Broadcast Stats< / a > < / li > < li > < a href = "?layer=112" > 112 – Old featured stickers, generic dice, poll timer, poll solution< / a > < / li > < li > < a href = "?layer=113" > 113 – PSA< / a > < / li > < li > < a href = "?layer=114" > 114 – Video thumbs for GIFs< / a > < / li > < li > < a href = "?layer=115" > 115 – Peek Channel Invite< / a > < / li > < li > < a href = "?layer=116" > 116 – Group Stats, Profile Videos< / a > < / li > < li > < a href = "?layer=117" > 117 – WebRTC Phone Calls< / a > < / li > < li > < a href = "?layer=118" > 118 – Callback with 2FA, Countries list< / a > < / li > < li > < a href = "?layer=119" > 119 – Comments in channels, Threads, Anonymous Admins< / a > < / li > < li > < a href = "?layer=120" > 120 – Multipins, Message Stats, GeoLive v2< / a > < / li > < li > < a href = "?layer=121" > 121 – SVG-based Outlines for Stickers< / a > < / li > < li > < a href = "?layer=122" > 122 – Voice Chats< / a > < / li > < li > < a href = "?layer=123" > 123 – Voice Chat improvements< / a > < / li > < li > < a href = "?layer=124" > 124 – Expiring Invite links< / a > < / li > < li > < a href = "?layer=125" > 125 – Voice Chats in Broadcasts< / a > < / li > < li > < a href = "?layer=126" > 126 – Ban channels in channels< / a > < / li > < li > < a href = "?layer=127" > 127 – Payments in channels< / a > < / li > < li > < a href = "?layer=128" > 128 – Microthumbs for User/Chat profile photos< / a > < / li > < li > < a href = "?layer=129" > 129 – Video Chats< / a > < / li > < li > < a href = "?layer=130" > 130 – Custom placeholder for bot reply keyboards< / a > < / li > < li > < a href = "?layer=131" > 131 – Reset 2FA Password after a week< / a > < / li > < li > < a href = "?layer=132" > 132 – Chat themes< / a > < / li > < li > < a href = "?layer=133" > 133 – 64-bit IDs for User/Chat< / a > < / li > < li > < a href = "?layer=134" > 134 – Chat Requests, Shared Media Calendar< / a > < / li > < li > < a href = "?layer=135" > 135 – Send Message As a Channel< / a > < / li > < li > < a href = "?layer=136" > 136 – Reactions< / a > < / li > < li > < a href = "?layer=137" > 137 – Translations< / a > < / li > < li > < a href = "?layer=138" > 138 – GIF Sticker Packs< / a > < / li > < li > < a href = "?layer=139" > 139 – RTMP streaming< / a > < / li > < li > < a href = "?layer=140" > 140 – WebApps, Cloud Ringtones< / a > < / li > < li > < a href = "?layer=142" > 142 – TCP Reflectors< / a > < / li > < li > < a href = "?layer=143" > 143 – Premium Subscription, Cloud Invoices< / a > < / li > < li > < a href = "?layer=144" > 144 – Premium as a Gift, Custom Emoji< / a > < / li > < li > < a href = "?layer=145" > 145 – Custom Reactions, Statuses, Sign In with email< / a > < / li > < li > < a href = "?
2022-05-14 00:37:40 +02:00
< li class = "divider" > < / li >
< li > < a href = "/api/layers" > More...< / a > < / li >
< / ul >
< / li >
< / ul >
< / div >
< pre class = "page_scheme" > < code > < a href = "/constructor/chat" class = "current_page_link" > chat< / a > #41cbf256 flags:< a href = "/type/%23" > #< / a > creator:flags.0?true left:flags.2?true deactivated:flags.5?true call_active:flags.23?true call_not_empty:flags.24?true noforwards:flags.25?true id:< a href = "/type/long" > long< / a > title:< a href = "/type/string" > string< / a > photo:< a href = "/type/ChatPhoto" > ChatPhoto< / a > participants_count:< a href = "/type/int" > int< / a > date:< a href = "/type/int" > int< / a > version:< a href = "/type/int" > int< / a > migrated_to:flags.6?< a href = "/type/InputChannel" > InputChannel< / a > admin_rights:flags.14?< a href = "/type/ChatAdminRights" > ChatAdminRights< / a > default_banned_rights:flags.18?< a href = "/type/ChatBannedRights" > ChatBannedRights< / a > = < a href = "/type/Chat" > Chat< / a > ;< / code > < / pre > < / p >
< h3 > < a class = "anchor" href = "#parameters" id = "parameters" name = "parameters" > < i class = "anchor-icon" > < / i > < / a > Parameters< / h3 >
< table class = "table" >
< thead >
< tr >
< th > Name< / th >
< th style = "text-align: center;" > Type< / th >
< th > Description< / th >
< / tr >
< / thead >
< tbody >
< tr >
< td > < strong > flags< / strong > < / td >
< td style = "text-align: center;" > < a href = "/type/%23" > #< / a > < / td >
< td > Flags, see < a href = "/mtproto/TL-combinators#conditional-fields" > TL conditional fields< / a > < / td >
< / tr >
< tr >
< td > < strong > creator< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .0?< a href = "/constructor/true" > true< / a > < / td >
< td > Whether the current user is the creator of the group< / td >
< / tr >
< tr >
< td > < strong > left< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .2?< a href = "/constructor/true" > true< / a > < / td >
< td > Whether the current user has left the group< / td >
< / tr >
< tr >
< td > < strong > deactivated< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .5?< a href = "/constructor/true" > true< / a > < / td >
< td > Whether the group was < a href = "/api/channel" > migrated< / a > < / td >
< / tr >
< tr >
< td > < strong > call_active< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .23?< a href = "/constructor/true" > true< / a > < / td >
< td > Whether a group call is currently active< / td >
< / tr >
< tr >
< td > < strong > call_not_empty< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .24?< a href = "/constructor/true" > true< / a > < / td >
< td > Whether there's anyone in the group call< / td >
< / tr >
< tr >
< td > < strong > noforwards< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .25?< a href = "/constructor/true" > true< / a > < / td >
< td > Whether this group is < a href = "https://telegram.org/blog/protected-content-delete-by-date-and-more" > protected< / a > , thus does not allow forwarding messages from it< / td >
< / tr >
< tr >
< td > < strong > id< / strong > < / td >
< td style = "text-align: center;" > < a href = "/type/long" > long< / a > < / td >
2024-09-18 00:21:45 +02:00
< td > ID of the group, see < a href = "/api/peers#peer-id" > here »< / a > for more info< / td >
2022-05-14 00:37:40 +02:00
< / tr >
< tr >
< td > < strong > title< / strong > < / td >
< td style = "text-align: center;" > < a href = "/type/string" > string< / a > < / td >
< td > Title< / td >
< / tr >
< tr >
< td > < strong > photo< / strong > < / td >
< td style = "text-align: center;" > < a href = "/type/ChatPhoto" > ChatPhoto< / a > < / td >
< td > Chat photo< / td >
< / tr >
< tr >
< td > < strong > participants_count< / strong > < / td >
< td style = "text-align: center;" > < a href = "/type/int" > int< / a > < / td >
< td > Participant count< / td >
< / tr >
< tr >
< td > < strong > date< / strong > < / td >
< td style = "text-align: center;" > < a href = "/type/int" > int< / a > < / td >
< td > Date of creation of the group< / td >
< / tr >
< tr >
< td > < strong > version< / strong > < / td >
< td style = "text-align: center;" > < a href = "/type/int" > int< / a > < / td >
< td > Used in basic groups to reorder updates and make sure that all of them were received.< / td >
< / tr >
< tr >
< td > < strong > migrated_to< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .6?< a href = "/type/InputChannel" > InputChannel< / a > < / td >
< td > Means this chat was < a href = "/api/channel" > upgraded< / a > to a supergroup< / td >
< / tr >
< tr >
< td > < strong > admin_rights< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .14?< a href = "/type/ChatAdminRights" > ChatAdminRights< / a > < / td >
< td > < a href = "/api/rights" > Admin rights< / a > of the user in the group< / td >
< / tr >
< tr >
< td > < strong > default_banned_rights< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .18?< a href = "/type/ChatBannedRights" > ChatBannedRights< / a > < / td >
< td > < a href = "/api/rights" > Default banned rights< / a > of all users in the group< / td >
< / tr >
< / tbody >
< / table >
< h3 > < a class = "anchor" href = "#type" id = "type" name = "type" > < i class = "anchor-icon" > < / i > < / a > Type< / h3 >
< p > < a href = "/type/Chat" > Chat< / a > < / p >
< h3 > < a class = "anchor" href = "#related-pages" id = "related-pages" name = "related-pages" > < i class = "anchor-icon" > < / i > < / a > Related pages< / h3 >
< h4 > < a class = "anchor" href = "#channels-supergroups-gigagroups-and-basic-groups" id = "channels-supergroups-gigagroups-and-basic-groups" name = "channels-supergroups-gigagroups-and-basic-groups" > < i class = "anchor-icon" > < / i > < / a > < a href = "/api/channel" > Channels, supergroups, gigagroups and basic groups< / a > < / h4 >
< p > How to handle channels, supergroups, gigagroups, basic groups, and what's the difference between them.< / p >
2024-09-18 00:21:45 +02:00
< h4 > < a class = "anchor" href = "#peer-database" id = "peer-database" name = "peer-database" > < i class = "anchor-icon" > < / i > < / a > < a href = "/api/peers" > Peer database< / a > < / h4 >
< p > Many constructors in the API need to be stored in a local database upon reception and should only ever be updated reactively (passively) when received via updates or by other means (as specified in the documentation), to avoid overloading the server by continuously requesting changes for the same unchanged information.< / p >
2022-05-14 00:37:40 +02:00
< h4 > < a class = "anchor" href = "#admin-banned-default-rights" id = "admin-banned-default-rights" name = "admin-banned-default-rights" > < i class = "anchor-icon" > < / i > < / a > < a href = "/api/rights" > Admin, banned, default rights< / a > < / h4 >
< p > How to handle admin permissions, granular bans and global permissions in channels, groups and supergroups.< / p > < / div >
< / div >
< / div >
< / div >
< div class = "footer_wrap" >
< div class = "footer_columns_wrap footer_desktop" >
< div class = "footer_column footer_column_telegram" >
< h5 > Telegram< / h5 >
< div class = "footer_telegram_description" > < / div >
Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed.
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/faq" > About< / a > < / h5 >
< ul >
< li > < a href = "//telegram.org/faq" > FAQ< / a > < / li >
2022-09-09 12:10:24 +02:00
< li > < a href = "//telegram.org/privacy" > Privacy< / a > < / li >
2022-09-09 23:58:59 +02:00
< li > < a href = "//telegram.org/press" > Press< / a > < / li >
2022-05-14 00:37:40 +02:00
< / ul >
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/apps#mobile-apps" > Mobile Apps< / a > < / h5 >
< ul >
< li > < a href = "//telegram.org/dl/ios" > iPhone/iPad< / a > < / li >
2022-09-09 23:58:59 +02:00
< li > < a href = "//telegram.org/android" > Android< / a > < / li >
< li > < a href = "//telegram.org/dl/web" > Mobile Web< / a > < / li >
2022-05-14 00:37:40 +02:00
< / ul >
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/apps#desktop-apps" > Desktop Apps< / a > < / h5 >
< ul >
< li > < a href = "//desktop.telegram.org/" > PC/Mac/Linux< / a > < / li >
< li > < a href = "//macos.telegram.org/" > macOS< / a > < / li >
< li > < a href = "//telegram.org/dl/web" > Web-browser< / a > < / li >
< / ul >
< / div >
< div class = "footer_column footer_column_platform" >
< h5 > < a href = "/" > Platform< / a > < / h5 >
< ul >
< li > < a href = "/api" > API< / a > < / li >
< li > < a href = "//translations.telegram.org/" > Translations< / a > < / li >
< li > < a href = "//instantview.telegram.org/" > Instant View< / a > < / li >
< / ul >
< / div >
< / div >
< div class = "footer_columns_wrap footer_mobile" >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/faq" > About< / a > < / h5 >
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/blog" > Blog< / a > < / h5 >
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/apps" > Apps< / a > < / h5 >
< / div >
< div class = "footer_column" >
< h5 > < a href = "/" > Platform< / a > < / h5 >
< / div >
< div class = "footer_column" >
2024-02-15 09:56:58 +01:00
< h5 > < a href = "//telegram.org/press" > Press< / a > < / h5 >
2022-05-14 00:37:40 +02:00
< / div >
< / div >
< / div >
< / div >
2022-12-10 23:50:15 +01:00
< script src = "/js/main.js?47" > < / script >
2022-05-14 00:37:40 +02:00
< script > b a c k T o T o p I n i t ( " G o u p " ) ;
removePreloadInit();
< / script >
< / body >
< / html >
