2022-05-14 00:37:40 +02:00
<!DOCTYPE html>
< html class = "" >
< head >
< meta charset = "utf-8" >
< title > Discussion groups< / title >
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" >
2022-11-15 01:03:58 +01:00
< meta property = "description" content = "Groups can be associated to a channel as a discussion group, to allow users to discuss about posts." >
2022-05-14 00:37:40 +02:00
< meta property = "og:title" content = "Discussion groups" >
< meta property = "og:image" content = "" >
2022-11-15 01:03:58 +01:00
< meta property = "og:description" content = "Groups can be associated to a channel as a discussion group, to allow users to discuss about posts." >
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" >
2022-11-21 13:10:26 +01:00
< link href = "/css/telegram.css?233" 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 = "active" > < a href = "/api" > API< / a > < / li >
< li class = "" > < a href = "/mtproto" > Protocol< / a > < / li >
< li class = "" > < 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 = "/api/discussion" > Discussion groups< / a > < / li > < / ul > < / div >
< h1 id = "dev_page_title" > Discussion groups< / h1 >
< div id = "dev_page_content" > <!-- scroll_nav -->
< p > < a href = "/api/channel" > Groups< / a > can be associated to a < a href = "/api/channel" > channel< / a > as a < a href = "https://telegram.org/blog/privacy-discussions-web-bots" > discussion group< / a > , to allow users to discuss about posts. < / p >
< pre > < code > < a href = '/constructor/boolFalse' > boolFalse< / a > #bc799737 = < a href = '/type/Bool' > Bool< / a > ;
< a href = '/constructor/boolTrue' > boolTrue< / a > #997275b5 = < a href = '/type/Bool' > Bool< / a > ;
2022-11-15 01:03:58 +01:00
< a href = '/constructor/channelFull' > channelFull< / a > #f2355507 flags:< a href = '/type/%23' > #< / a > can_view_participants:flags.3?< a href = '/constructor/true' > true< / a > can_set_username:flags.6?< a href = '/constructor/true' > true< / a > can_set_stickers:flags.7?< a href = '/constructor/true' > true< / a > hidden_prehistory:flags.10?< a href = '/constructor/true' > true< / a > can_set_location:flags.16?< a href = '/constructor/true' > true< / a > has_scheduled:flags.19?< a href = '/constructor/true' > true< / a > can_view_stats:flags.20?< a href = '/constructor/true' > true< / a > blocked:flags.22?< a href = '/constructor/true' > true< / a > flags2:< a href = '/type/%23' > #< / a > can_delete_channel:flags2.0?< a href = '/constructor/true' > true< / a > id:< a href = '/type/long' > long< / a > about:< a href = '/type/string' > string< / a > participants_count:flags.0?< a href = '/type/int' > int< / a > admins_count:flags.1?< a href = '/type/int' > int< / a > kicked_count:flags.2?< a href = '/type/int' > int< / a > banned_count:flags.2?< a href = '/type/int' > int< / a > online_count:flags.13?< a href = '/type/int' > int< / a > read_inbox_max_id:< a href = '/type/int' > int< / a > read_outbox_max_id:< a href = '/type/int' > int< / a > unread_count:< a href = '/type/int' > int< / a > chat_photo:< a href = '/type/Photo' > Photo< / a > notify_settings:< a href = '/type/PeerNotifySettings' > PeerNotifySettings< / a > exported_invite:flags.23?< a href = '/type/ExportedChatInvite' > ExportedChatInvite< / a > bot_info:< a href = '/type/Vector%20t' > Vector< / a > < < a href = '/type/BotInfo' > BotInfo< / a > > migrated_from_chat_id:flags.4?< a href = '/type/long' > long< / a > migrated_from_max_id:flags.4?< a href = '/type/int' > int< / a > pinned_msg_id:flags.5?< a href = '/type/int' > int< / a > stickerset:flags.8?< a href = '/type/StickerSet' > StickerSet< / a > available_min_id:flags.9?< a href = '/type/int' > int< / a > folder_id:flags.11?< a href = '/type/int' > int< / a > linked_chat_id:flags.14?< a href = '/type/long' > long< / a > location:flags.15?< a href = '/type/ChannelLocation' > ChannelLocation< / a > slowmode_seconds:flags.17?< a href = '/type/int' > int< / a > slowmode_next_send_date:flags.18?< a href = '/type/int' > int< / a > stats_dc:flags.12?< a href = '/type/int' > int< / a > pts:< a href = '/type/int' > int< / a > call:flags.21?< a href = '/type/InputGroupCall' > InputGroupCall< / a > ttl_period:flags.24?< a href = '/type/int' > int< / a > pending_suggestions:flags.25?< a href = '/type/Vector%20t' > Vector< / a > < < a href = '/type/string' > string< / a > > groupcall_default_join_as:flags.26?< a href = '/type/Peer' > Peer< / a > theme_emoticon:flags.27?< a href = '/type/string' > string< / a > requests_pending:flags.28?< a href = '/type/int' > int< / a > recent_requesters:flags.28?< a href = '/type/Vector%20t' > Vector< / a > < < a href = '/type/long' > long< / a > > default_send_as:flags.29?< a href = '/type/Peer' > Peer< / a > available_reactions:flags.30?< a href = '/type/ChatReactions' > ChatReactions< / a > = < a href = '/type/ChatFull' > ChatFull< / a > ;
2022-05-14 00:37:40 +02:00
< a href = '/constructor/messages.chats' > messages.chats< / a > #64ff9fd5 chats:< a href = '/type/Vector%20t' > Vector< / a > < < a href = '/type/Chat' > Chat< / a > > = < a href = '/type/messages.Chats' > messages.Chats< / a > ;
---functions---
< a href = '/method/channels.setDiscussionGroup' > channels.setDiscussionGroup< / a > #40582bb2 broadcast:< a href = '/type/InputChannel' > InputChannel< / a > group:< a href = '/type/InputChannel' > InputChannel< / a > = < a href = '/type/Bool' > Bool< / a > ;
< a href = '/method/channels.getGroupsForDiscussion' > channels.getGroupsForDiscussion< / a > #f5dad378 = < a href = '/type/messages.Chats' > messages.Chats< / a > ;< / code > < / pre >
< p > A discussion group can be associated to a channel using < a href = "/method/channels.setDiscussionGroup" > channels.setDiscussionGroup< / a > .< br >
The discussion group can be accessed in the client by clicking on the discuss button of the channel, or by accessing the < a href = "/api/threads" > comment section< / a > of a specific post; the discussion group ID is also present in the < code > linked_chat_id< / code > field of the < a href = "/constructor/channelFull" > channelFull< / a > constructor. < / p >
< p > All messages sent to the channel will also be sent to the linked group (with sender peer < code > from_id< / code > equal to the peer of the linked channel); those messages will also be automatically < a href = "/api/pin" > pinned< / a > in the group.< br >
The comment section of a particular post can be disabled by removing the channel post message from the discussion group. < / p >
< h3 > < a class = "anchor" href = "#linking-a-discussion-group" id = "linking-a-discussion-group" name = "linking-a-discussion-group" > < i class = "anchor-icon" > < / i > < / a > Linking a discussion group< / h3 >
< p > To obtain a list of admined supergroups that a channel admin can possibly associate to a channel, use < a href = "/method/channels.getGroupsForDiscussion" > channels.getGroupsForDiscussion< / a > .< br >
Returned < a href = "/api/channel#basic-groups" > basic group chats< / a > must be first < a href = "/api/channel#migration" > upgraded to supergroups< / a > before they can be set as a discussion group.< br >
Before linking a supergroup to a channel, access to the supergroup's old messages must also be enabled using < a href = "/method/channels.togglePreHistoryHidden" > channels.togglePreHistoryHidden< / a > . < / p >
< p > To set a returned supergroup as a discussion group use < a href = "/method/channels.setDiscussionGroup" > channels.setDiscussionGroup< / a > .< / p >
< p > Schema: < / p >
< pre > < code > < a href = '/constructor/boolFalse' > boolFalse< / a > #bc799737 = < a href = '/type/Bool' > Bool< / a > ;
< a href = '/constructor/boolTrue' > boolTrue< / a > #997275b5 = < a href = '/type/Bool' > Bool< / a > ;
< a href = '/constructor/messages.chats' > messages.chats< / a > #64ff9fd5 chats:< a href = '/type/Vector%20t' > Vector< / a > < < a href = '/type/Chat' > Chat< / a > > = < a href = '/type/messages.Chats' > messages.Chats< / a > ;
---functions---
< a href = '/method/channels.setDiscussionGroup' > channels.setDiscussionGroup< / a > #40582bb2 broadcast:< a href = '/type/InputChannel' > InputChannel< / a > group:< a href = '/type/InputChannel' > InputChannel< / a > = < a href = '/type/Bool' > Bool< / a > ;
< a href = '/method/channels.getGroupsForDiscussion' > channels.getGroupsForDiscussion< / a > #f5dad378 = < a href = '/type/messages.Chats' > messages.Chats< / a > ;
2022-11-15 01:03:58 +01:00
< a href = '/method/channels.togglePreHistoryHidden' > channels.togglePreHistoryHidden< / a > #eabbb94c channel:< a href = '/type/InputChannel' > InputChannel< / a > enabled:< a href = '/type/Bool' > Bool< / a > = < a href = '/type/Updates' > Updates< / a > ;< / code > < / pre >
< h3 > < a class = "anchor" href = "#requiring-users-to-join-the-group" id = "requiring-users-to-join-the-group" name = "requiring-users-to-join-the-group" > < i class = "anchor-icon" > < / i > < / a > Requiring users to join the group< / h3 >
< pre > < code > < a href = '/constructor/channel' > channel< / a > #8261ac61 flags:< a href = '/type/%23' > #< / a > creator:flags.0?< a href = '/constructor/true' > true< / a > left:flags.2?< a href = '/constructor/true' > true< / a > broadcast:flags.5?< a href = '/constructor/true' > true< / a > verified:flags.7?< a href = '/constructor/true' > true< / a > megagroup:flags.8?< a href = '/constructor/true' > true< / a > restricted:flags.9?< a href = '/constructor/true' > true< / a > signatures:flags.11?< a href = '/constructor/true' > true< / a > min:flags.12?< a href = '/constructor/true' > true< / a > scam:flags.19?< a href = '/constructor/true' > true< / a > has_link:flags.20?< a href = '/constructor/true' > true< / a > has_geo:flags.21?< a href = '/constructor/true' > true< / a > slowmode_enabled:flags.22?< a href = '/constructor/true' > true< / a > call_active:flags.23?< a href = '/constructor/true' > true< / a > call_not_empty:flags.24?< a href = '/constructor/true' > true< / a > fake:flags.25?< a href = '/constructor/true' > true< / a > gigagroup:flags.26?< a href = '/constructor/true' > true< / a > noforwards:flags.27?< a href = '/constructor/true' > true< / a > join_to_send:flags.28?< a href = '/constructor/true' > true< / a > join_request:flags.29?< a href = '/constructor/true' > true< / a > id:< a href = '/type/long' > long< / a > access_hash:flags.13?< a href = '/type/long' > long< / a > title:< a href = '/type/string' > string< / a > username:flags.6?< a href = '/type/string' > string< / a > photo:< a href = '/type/ChatPhoto' > ChatPhoto< / a > date:< a href = '/type/int' > int< / a > restriction_reason:flags.9?< a href = '/type/Vector%20t' > Vector< / a > < < a href = '/type/RestrictionReason' > RestrictionReason< / a > > admin_rights:flags.14?< a href = '/type/ChatAdminRights' > ChatAdminRights< / a > banned_rights:flags.15?< a href = '/type/ChatBannedRights' > ChatBannedRights< / a > default_banned_rights:flags.18?< a href = '/type/ChatBannedRights' > ChatBannedRights< / a > participants_count:flags.17?< a href = '/type/int' > int< / a > = < a href = '/type/Chat' > Chat< / a > ;
---functions---
< a href = '/method/channels.toggleJoinToSend' > channels.toggleJoinToSend< / a > #e4cb9580 channel:< a href = '/type/InputChannel' > InputChannel< / a > enabled:< a href = '/type/Bool' > Bool< / a > = < a href = '/type/Updates' > Updates< / a > ;< / code > < / pre >
< p > Admins may use < a href = "/method/channels.toggleJoinToSend" > channels.toggleJoinToSend< / a > to force users to join a discussion group before commenting.< br >
The < a href = "/constructor/channel" > < code > channel.join_to_send< / code > < / a > flag will be set accordingly, and all attempts by non-members to send a message to the group will return a < code > CHAT_GUEST_SEND_FORBIDDEN< / code > RPC error.< / p > < / div >
2022-05-14 00:37:40 +02:00
< / 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" >
< h5 > < a href = "https://twitter.com/telegram" target = "_blank" data-track = "Follow/Twitter" onclick = "trackDlClick(this, event)" > Twitter< / a > < / h5 >
< / div >
< / div >
< / div >
< / div >
< script src = "/js/main.js?46" > < / script >
< script src = "/js/jquery.min.js?1" > < / script >
< script src = "/js/bootstrap.min.js?1" > < / script >
< script > w i n d o w . i n i t D e v P a g e N a v & & i n i t D e v P a g e N a v ( ) ;
backToTopInit("Go up");
removePreloadInit();
< / script >
< / body >
< / html >
