电报客户端配置

在电报的API接口配置，可以对客户端进行多种配置，比如MTProto API 具有多个配置参数，可以使用相应的方法获取这些参数。

MTProto 配置

config#cc1a241e flags:# default_p2p_contacts:flags.3?true preload_featured_stickers:flags.4?true revoke_pm_inbox:flags.6?true blocked_mode:flags.8?true force_try_ipv6:flags.14?true date:int expires:int test_mode:Bool this_dc:int dc_options:Vector<DcOption> dc_txt_domain_name:string chat_size_max:int megagroup_size_max:int forwarded_count_max:int online_update_period_ms:int offline_blur_timeout_ms:int offline_idle_timeout_ms:int online_cloud_timeout_ms:int notify_cloud_delay_ms:int notify_default_delay_ms:int push_chat_period_ms:int push_chat_limit:int edit_time_limit:int revoke_time_limit:int revoke_pm_time_limit:int rating_e_decay:int stickers_recent_limit:int channels_read_media_period:int tmp_sessions:flags.0?int call_receive_timeout_ms:int call_ring_timeout_ms:int call_connect_timeout_ms:int call_packet_timeout_ms:int me_url_prefix:string autoupdate_url_prefix:flags.7?string gif_search_username:flags.9?string venue_search_username:flags.10?string img_search_username:flags.11?string static_maps_provider:flags.12?string caption_length_max:int message_length_max:int webfile_dc_id:int suggested_lang_code:flags.2?string lang_pack_version:flags.2?int base_lang_pack_version:flags.2?int reactions_default:flags.15?Reaction autologin_token:flags.16?string = Config; nearestDc#8e1a1775 country:string this_dc:int nearest_dc:int = NearestDc;updateConfig#a229dd06 = Update;---functions---help.getConfig#c4f9186b = Config; help.getNearestDc#1fb33026 = NearestDc;

庞大的配置构造器包含大量有用的信息，从聊天和消息大小限制到隐私设置、在线状态刷新间隔和超时、VoIP 配置、GIF、图像和场所查找的默认内联机器人用户名，以及许多其他全局和用户特定的信息，请查看构造器页面以获取更多信息。

收到updateConfig更新后，应立即手动刷新配置。

客户端配置

jsonObjectValue#c0de1bd9 key:string value:JSONValue = JSONObjectValue;jsonNull#3f6d7b68 = JSONValue; jsonBool#c7345e6a value:Bool = JSONValue; jsonNumber#2be0dfa4 value:double = JSONValue; jsonString#b71e767a value:string = JSONValue; jsonArray#f7444763 value:Vector<JSONValue> = JSONValue; jsonObject#99c1d49d value:Vector<JSONObjectValue> = JSONValue;help.appConfigNotModified#7cde641d = help.AppConfig; help.appConfig#dd18782e hash:int config:JSONValue = help.AppConfig;updateConfig#a229dd06 = Update;---functions---help.getAppConfig#61e3f854 hash:int = help.AppConfig;

help.getAppConfig方法返回一个 JSON 对象，其中包含快速变化的、特定于客户端的配置参数。help.getConfig返回MTProto特有的配置，以及有关服务器端限制和其他 MTProto 相关信息的内容；
而help.getAppConfig返回适用于图形化 Telegram 客户端的配置参数。

首次调用help.getAppConfig时，将其传递0给哈希；在以后的调用中，使用hash先前返回的help.appConfig中包含的内容；如果配置没有更改，则将返回help.appConfigNotModified而不是help.appConfig。

收到updateConfig更新后，应立即手动刷新配置。

如果任何配置键在运行时不可用，则必须使用默认值。
具体来说，如果成功调用了`help.getAppConfig`但所需的键在`help.appConfig`中不可用，config或者如果调用`help.getAppConfig`返回了 RPC 错误且没有缓存值，则必须使用默认对象中的相对值。

以下是必须使用的所有默认值列表：

{"about_length_limit_default": 70,"about_length_limit_premium": 140,"authorization_autoconfirm_period": 604800,"autoarchive_setting_available": true,"autologin_domains": ["instantview.telegram.org","translations.telegram.org","contest.dev","contest.com","bugs.telegram.org","suggestions.telegram.org","themes.telegram.org","promote.telegram.org","ads.telegram.org"],"background_connection": true,"boosts_channel_level_max": 100,"boosts_per_sent_gift": 3,"bot_preview_medias_max": 12,"bot_verification_description_length_limit": 70,"business_chat_links_limit": 100,"business_promo_order": ["business_location","business_hours","quick_replies","greeting_message","away_message","business_links","business_intro","business_bots","emoji_status","folder_tags","stories"],"call_requests_disabled": false,"can_edit_factcheck": false,"caption_length_limit_default": 1024,"caption_length_limit_premium": 4096,"channel_autotranslation_level_min": 3,"channel_bg_icon_level_min": 4,"channel_custom_wallpaper_level_min": 10,"channel_emoji_status_level_min": 8,"channel_profile_bg_icon_level_min": 7,"channel_restrict_sponsored_level_min": 50,"channel_revenue_withdrawal_enabled": true,"channel_wallpaper_level_min": 9,"channels_limit_default": 500,"channels_limit_premium": 1000,"channels_public_limit_default": 10,"channels_public_limit_premium": 20,"chat_read_mark_expire_period": 604800,"chat_read_mark_size_threshold": 100,"chatlist_invites_limit_default": 3,"chatlist_invites_limit_premium": 100,"chatlist_update_period": 300,"chatlists_joined_limit_default": 2,"chatlists_joined_limit_premium": 20,"conference_call_size_limit": 200,"default_emoji_statuses_stickerset_id": "773947703670341676","dialog_filters_chats_limit_default": 100,"dialog_filters_chats_limit_premium": 200,"dialog_filters_enabled": true,"dialog_filters_limit_default": 10,"dialog_filters_limit_premium": 30,"dialog_filters_tooltip": false,"dialogs_folder_pinned_limit_default": 100,"dialogs_folder_pinned_limit_premium": 200,"dialogs_pinned_limit_default": 5,"dialogs_pinned_limit_premium": 10,"emojies_animated_zoom": 0.625,"emojies_send_dice": ["\ud83c\udfb2","\ud83c\udfaf","\ud83c\udfc0","\u26bd","\u26bd\ufe0f","\ud83c\udfb0","\ud83c\udfb3"],"emojies_send_dice_success": {"\ud83c\udfaf": {"value": 6,"frame_start": 62},"\ud83c\udfc0": {"value": 5,"frame_start": 110},"\u26bd": {"value": 5,"frame_start": 110},"\u26bd\ufe0f": {"value": 5,"frame_start": 110},"\ud83c\udfb0": {"value": 64,"frame_start": 110},"\ud83c\udfb3": {"value": 6,"frame_start": 110}},"emojies_sounds": [],"factcheck_length_limit": 1024,"fragment_prefixes": ["888"],"freeze_appeal_url": "","freeze_since_date": 0,"freeze_until_date": 0,"gif_search_branding": "tenor","gif_search_emojies": ["\ud83d\udc4d","\ud83d\ude18","\ud83d\ude0d","\ud83d\ude21","\ud83e\udd73","\ud83d\ude02","\ud83d\ude2e","\ud83d\ude44","\ud83d\ude0e","\ud83d\udc4e"],"giveaway_add_peers_max": 10,"giveaway_boosts_per_premium": 4,"giveaway_countries_max": 10,"giveaway_gifts_purchase_available": false,"giveaway_period_max": 2678400,"group_custom_wallpaper_level_min": 10,"group_emoji_status_level_min": 8,"group_emoji_stickers_level_min": 4,"group_profile_bg_icon_level_min": 5,"group_transcribe_level_min": 6,"group_wallpaper_level_min": 9,"groupcall_video_participants_max": 1000,"hidden_members_group_size_min": 100,"ignore_restriction_reasons": [],"inapp_update_check_delay": 86400,"intro_description_length_limit": 70,"intro_title_length_limit": 32,"keep_alive_service": true,"large_queue_max_active_operations_count": 2,"message_animated_emoji_max": 100,"need_age_video_verification": false,"new_noncontact_peers_require_premium_without_ownpremium": false,"pm_read_date_expire_period": 604800,"poll_answers_max": 12,"premium_bot_username": "PremiumBot","premium_gift_attach_menu_icon": true,"premium_gift_text_field_icon": false,"premium_invoice_slug": "abc","premium_manage_subscription_url": "https://t.me/premiumbot?start=status","premium_promo_order": ["stories","more_upload","double_limits","business","last_seen","voice_to_text","faster_download","translations","animated_emoji","emoji_status","saved_tags","peer_colors","wallpapers","profile_badge","message_privacy","advanced_chat_management","no_ads","app_icons","infinite_reactions","animated_userpics","premium_stickers","effects","todo"],"premium_purchase_blocked": false,"qr_login_camera": true,"qr_login_code": "primary","quick_replies_limit": 100,"quick_reply_messages_limit": 20,"quote_length_max": 1024,"reactions_in_chat_max": 100,"reactions_uniq_max": 11,"reactions_user_max_default": 1,"reactions_user_max_premium": 3,"recommended_channels_limit_default": 10,"recommended_channels_limit_premium": 100,"restriction_add_platforms": [],"ringtone_duration_max": 5,"ringtone_saved_count_max": 100,"ringtone_size_max": 307200,"round_video_encoding": {"diameter": 384,"video_bitrate": 1000,"audio_bitrate": 64,"max_size": 12582912},"saved_dialogs_pinned_limit_default": 5,"saved_dialogs_pinned_limit_premium": 100,"saved_gifs_limit_default": 200,"saved_gifs_limit_premium": 400,"small_queue_max_active_operations_count": 5,"sponsored_links_inapp_allow": false,"stargifts_blocked": true,"stargifts_collection_gifts_limit": 500,"stargifts_collections_limit": 10,"stargifts_convert_period_max": 604800,"stargifts_message_length_max": 128,"stargifts_pinned_to_top_limit": 6,"starref_connect_allowed": false,"starref_max_commission_permille": 800,"starref_min_commission_permille": 1,"starref_program_allowed": false,"starref_start_param_prefixes": ["_tgr_"],"stars_gifts_enabled": true,"stars_paid_message_amount_max": 10000,"stars_paid_message_commission_permille": 850,"stars_paid_messages_available": true,"stars_paid_messages_channel_amount_default": 10,"stars_paid_post_amount_max": 10000,"stars_paid_reaction_amount_max": 10000,"stars_purchase_blocked": true,"stars_rating_learnmore_url": "https://telegram.org/blog/telegram-stars","stars_revenue_withdrawal_max": 25000000,"stars_revenue_withdrawal_min": 1000,"stars_stargift_resale_amount_max": 100000,"stars_stargift_resale_amount_min": 125,"stars_stargift_resale_commission_permille": 800,"stars_subscription_amount_max": 10000,"stars_suggested_post_age_min": 86400,"stars_suggested_post_amount_max": 100000,"stars_suggested_post_amount_min": 5,"stars_suggested_post_commission_permille": 850,"stars_suggested_post_future_max": 2678400,"stars_suggested_post_future_min": 300,"stars_usd_sell_rate_x1000": 1410,"stars_usd_withdraw_rate_x1000": 1300,"stickers_emoji_cache_time": 86400,"stickers_emoji_suggest_only_api": false,"stickers_faved_limit_default": 5,"stickers_faved_limit_premium": 10,"stickers_normal_by_emoji_per_premium_num": 3,"stickers_premium_by_emoji_num": 0,"stories_album_stories_limit": 1000,"stories_albums_limit": 100,"stories_area_url_max": 3,"stories_changelog_user_id": 777000,"stories_entities": "premium","stories_pinned_to_top_count_max": 3,"stories_posting": "enabled","stories_sent_monthly_limit_default": 10,"stories_sent_monthly_limit_premium": 3000,"stories_sent_weekly_limit_default": 3,"stories_sent_weekly_limit_premium": 700,"stories_stealth_cooldown_period": 10800,"stories_stealth_future_period": 1500,"stories_stealth_past_period": 300,"stories_suggested_reactions_limit_default": 1,"stories_suggested_reactions_limit_premium": 5,"stories_venue_search_username": "foursquare","story_caption_length_limit_default": 200,"story_caption_length_limit_premium": 2048,"story_expiring_limit_default": 1,"story_expiring_limit_premium": 100,"story_viewers_expire_period": 86400,"story_weather_preload": false,"telegram_antispam_group_size_min": 200,"telegram_antispam_user_id": "5434988373","todo_item_length_max": 200,"todo_items_max": 30,"todo_title_length_max": 255,"ton_blockchain_explorer_url": "https://tonviewer.com/","ton_proxy_address": "magic.org","ton_stargift_resale_amount_max": 100000000000000,"ton_stargift_resale_amount_min": 100,"ton_stargift_resale_commission_permille": 900,"ton_suggested_post_amount_max": 10000000000000,"ton_suggested_post_amount_min": 1,"ton_suggested_post_commission_permille": 850,"ton_topup_url": "https://fragment.com/ads/topup","ton_usd_rate": 3,"topics_pinned_limit": 5,"transcribe_audio_trial_duration_max": 300,"transcribe_audio_trial_weekly_number": 0,"upload_max_fileparts_default": 4000,"upload_max_fileparts_premium": 8000,"upload_premium_speedup_download": 10,"upload_premium_speedup_notify_period": 3600,"upload_premium_speedup_upload": 10,"url_auth_domains": ["web.telegram.org","web.t.me","k.t.me","z.t.me","a.t.me"],"verify_age_bot_username": "","verify_age_country": "","verify_age_min": 0,"video_ignore_alt_documents": false,"weather_search_username": "StoryWeatherBot","web_app_allowed_protocols": ["http","https"],"whitelisted_domains": ["telegram.dog","telegram.me","telegram.org","t.me","telesco.pe","fragment.com","translations.telegram.org"]}

生成的 JSON 对象中包含以下字段：

weather_search_username

包含用于查询当前天气的机器人的用户名，以便在天气媒体区域使用，具体请参见此处 »。（字符串）

story_weather_preload

如果为真，客户端应在启动时（而非仅在创建天气媒体区域时）通过查询weather_search_username中指定的机器人来预加载当前天气。（布尔值）

emojies_animated_zoom

动画表情符号和动画骰子在显示给用户之前应按此因子缩放（浮点数）。

keep_alive_service

应用客户端是否应该启动 keepalive 服务，以便在应用关闭时仍能保持应用运行并获取更新（布尔值）

background_connection

应用客户端是否应启动后台 TCP 连接以获取 MTProto 更新（布尔值）

emojies_send_dice

支持的动画骰子贴纸列表（字符串数组）。

emojies_send_dice_success

对于除基本骰子表情符号之外的其他动画骰子表情符号，指示获胜骰子点数和动画贴纸的最后一帧，在该帧显示烟花（包含表情符号键和对象值的对象，包含value浮点frame_start值）。

emojies_sounds

当用户点击指定的动画表情符号时，将播放相应的声音片段；文件引用字段在下载文件之前应进行 base64 解码（文件 ID映射表（inputDocument.id），键为表情符号字符串）。

例子：

{"\ud83c\udf83": {"id": "4956223179606458539","access_hash": "-2107001400913062971","file_reference_base64": ""},"\u26b0": {"id": "4956223179606458540","access_hash": "-1498869544183595185","file_reference_base64": ""}}

gif_search_branding

指定通过gif_search_username（字符串）提供 GIF 搜索服务的用户名

gif_search_emojies

指定一个表情符号列表，该列表将作为搜索词显示在 GIF 搜索框上方的工具栏中（表情符号字符串数组）。

stickers_emoji_suggest_only_api

指定应用完全不显示表情符号的本地贴纸建议，而只使用messages.getStickers(bool)的结果。

stickers_emoji_cache_time

指定messages.getStickers本地缓存的有效期，这在调用该方法生成分页哈希时也适用。（整数）

qr_login_camera

是否应在“设置”->“设备”菜单中显示扫描二维码登录的选项（布尔值）

qr_login_code

登录界面是否应显示二维码登录选项，并可能将其作为默认登录方式（字符串，“已禁用”、“主要”或“辅助”）

dialog_filters_enabled

是否应向客户端显示用于管理对话框筛选器（又称文件夹）的选项（布尔值）

dialog_filters_tooltip

客户端是否应主动显示工具提示，引导用户配置对话框筛选器（又称文件夹）；通常当聊天列表过长开始显得杂乱时，就会出现这种情况。（布尔值）

autoarchive_setting_available

客户端是否可以使用account.setGlobalPrivacySettings来globalPrivacySettings.archive_and_mute_new_noncontact_peers = boolTrue自动存档并屏蔽来自非联系人的新聊天信息。（布尔值）

topics_pinned_limit

单个论坛中可置顶主题的最大数量。（整数）

telegram_antispam_user_id

官方原生反垃圾邮件机器人的 ID ，如果按照原生反垃圾邮件文档中的说明启用，它将自动删除垃圾邮件。使用`channels.getParticipants`
获取超级群组的管理员列表时，如果指定的超级群组启用了原生反垃圾邮件功能，则应手动将机器人添加到向用户显示的管理员列表中。（表示 Telegram 用户/机器人 ID 的数字字符串，应转换为 int64 类型）

telegram_antispam_group_size_min

启用原生反垃圾邮件功能所需的最小群组成员数。（整数）

fragment_prefixes

匿名Fragment电话号码的电话号码前缀列表。（字符串数组）

hidden_members_group_size_min

使用channels.toggleParticipantsHidden隐藏超级群组的参与者列表所需的最小参与者数量。（整数）

url_auth_domains

支持自动登录并需手动用户确认的域名列表，点击此处了解更多关于 URL 授权的信息 »。（字符串数组）

autologin_domains

以下列出了支持无需用户确认即可自动登录的 Telegram 域名，点击此处了解更多关于 URL 授权的信息 »。（字符串数组）

whitelisted_domains

一份 Telegram 域名列表，当点击应用内链接（例如messageEntityTextUrl实体）且 URL 未完整显示时，无需用户额外确认即可打开这些域名。（字符串数组）

请注意，首次打开直接小程序链接t.me/<bot_username>/<short_name>?startapp=<start_parameter>时，即使包含深度链接的域名已列入白名单（即已t.me列入白名单），仍应向用户请求确认。

即使我们之前已经打开了直接小程序，如果链接不可见（例如messageEntityTextUrl文本链接、内联按钮等），也应该始终要求确认。

round_video_encoding

包含一组推荐的圆形视频编解码器参数。（对象，如示例中所述）

chat_read_mark_size_threshold

用户已读回执（可通过messages.getMessageReadParticipants获取）将在参与者数量小于或等于指定值的群组中可用chat_read_mark_size_threshold。（整数）

chat_read_mark_expire_period

chat_read_mark_expire_period为保护用户隐私，聊天记录的已读回执仅在消息发送后保留几秒钟。（整数）

pm_read_date_expire_period

为保护用户隐私，私聊的已读回执仅pm_read_date_expire_period在消息发送后保留几秒钟。（整数）

groupcall_video_participants_max

群组通话中的最大参与人数（直播允许无限人数）（整数）

reactions_uniq_max

任何给定消息的最大唯一表情符号反应数量：例如，如果已有 2000 个和 1000 个自定义表情符号反应，且 reactions_uniq_max = 2，则无法添加新的反应，因为这将使唯一表情符号反应的数量增加到 3 > 2。（整数）

reactions_in_chat_max

使用chatReactionsSome 参数，可以在聊天中标记为允许的最大反应数量。（整数）

reactions_user_max_default

非高级用户在单条消息中可添加的最大表情符号数量。（整数）

reactions_user_max_premium

高级用户在单条消息中可添加的最大表情符号数量。（整数）

default_emoji_statuses_stickerset_id

默认表情符号状态贴纸集 ID。（整数）请注意，可以使用inputStickerSetEmojiDefaultStatuses
获取贴纸集。

ringtone_duration_max

可上传通知声音的最大持续时间（秒）»（整数）

ringtone_size_max

可上传的通知声音的最大转换后大小（以字节为单位）»

ringtone_saved_count_max

可保存的通知音最大数量»

message_animated_emoji_max

消息中可出现的自定义表情符号的最大数量。（整数）

stickers_premium_by_emoji_num

定义在文本字段中输入表情符号时，贴纸建议弹出窗口中显示的付费贴纸数量，更多信息请参阅贴纸文档（整数）。

stickers_normal_by_emoji_per_premium_num

对于高级用户，用于定义建议贴纸列表，更多信息请参阅贴纸文档（整数）。

premium_purchase_blocked

用户无法购买Telegram Premium。该应用还必须隐藏所有高级功能，包括对其他用户的星级评价等。（布尔值）

channels_limit_default

非高级用户可加入的频道和超级群组的最大数量（整数）

channels_limit_premium

高级用户可加入的频道和超级群组的最大数量（整数）

saved_gifs_limit_default

非高级用户可保存的GIF 最大数量（整数）

saved_gifs_limit_premium

高级用户可保存的GIF 图片最大数量（整数）

stickers_faved_limit_default

非高级用户可添加到收藏夹的贴纸最大数量»（整数）

stickers_faved_limit_premium

高级用户可添加到收藏夹的贴纸最大数量»（整数）

dialog_filters_limit_default

非高级用户可创建的最大文件夹数量（整数）

dialog_filters_limit_premium

高级用户可创建的最大文件夹数量（整数）

dialog_filters_chats_limit_default

非高级用户可添加到文件夹中的最大聊天记录数量（整数）

dialog_filters_chats_limit_premium

高级用户可添加到文件夹中的最大聊天记录数量（整数）

dialogs_pinned_limit_default

非高级用户可置顶的聊天记录最大数量（整数）

dialogs_pinned_limit_premium

高级用户可置顶的聊天记录最大数量（整数）

dialogs_folder_pinned_limit_default

非高级用户可在文件夹中置顶的最大聊天记录数量（整数）

dialogs_folder_pinned_limit_premium

高级用户可在文件夹中置顶的最大聊天记录数量（整数）

channels_public_limit_default

非高级用户可创建的公共频道或超级群组的最大数量（整数）

channels_public_limit_premium

高级用户可以创建的公共频道或超级群组的最大数量（整数）

caption_length_limit_default

非高级用户可发送的媒体字幕的最大 UTF-8 长度（整数）

caption_length_limit_premium

高级用户可发送的媒体字幕的最大 UTF-8 长度（整数）

upload_max_fileparts_default

非高级用户可上传的文件片段最大数量（整数，最大文件大小可通过将此值乘以524288最大可能块大小来推算）

upload_max_fileparts_premium

高级用户可上传的文件分块数量上限（整数，最大文件大小可通过将此值乘以524288最大可能分块大小来推算）

about_length_limit_default

非高级用户BIOS 的最大 UTF-8 长度（整数）

about_length_limit_premium

高级用户BIOS 的最大 UTF-8 长度（整数）

premium_promo_order

字符串标识符数组，用于指示Telegram Premium功能在 Telegram Premium 促销弹窗中的顺序，请点击此处查看可能的值 »

business_promo_order

字符串标识符数组，用于指示Telegram Business功能在 Telegram Business 推广弹窗中的顺序，请点击此处查看可能的值 »

premium_bot_username

包含可用于购买Telegram Premium会员资格的官方Telegram Premium机器人的用户名，详情请参阅此处 »（字符串）

premium_invoice_slug

包含可用于购买Telegram Premium会员资格的发票别名，详情请参阅此处 »（字符串）

premium_gift_attach_menu_icon

是否在与用户的私聊附件菜单中显示礼物图标，以便当前用户可以向聊天中的其他用户赠送Telegram Premium会员资格。（布尔值）

premium_gift_text_field_icon

是否在与用户的私聊中（例如与机器人聊天时）在文本栏中显示礼物图标，以便当前用户可以向聊天中的其他用户/赠送Telegram Premiumpremium_gift_attach_menu_icon会员资格。仅当另一个选项也为真时，该选项才能为真。（布尔值）

chatlist_update_period

使用聊天文件夹深度链接导入文件夹的用户» 应最多每隔几秒调用一次chatlists.getChatlistUpdates来获取文件夹中的新增内容chatlist_update_period。（整数）

chatlist_invites_limit_default

非高级用户可创建的每个文件夹内聊天文件夹深度链接的最大数量。（整数）

chatlist_invites_limit_premium

高级用户可创建的每个文件夹内聊天文件夹深度链接的最大数量。（整数）

chatlists_joined_limit_default

非高级用户可共享文件夹的最大数量。（整数）

chatlists_joined_limit_premium

高级用户可共享文件夹 的最大数量。（整数）

small_queue_max_active_operations_count

软限制，指定从同一数据中心并行下载小于 20MB 的文件的最大数量。（整数）

large_queue_max_active_operations_count

软限制，指定从同一数据中心并行下载大于 20MB 的文件的最大文件数。（整数）

authorization_autoconfirm_period

未确认的会话将在登录后指定秒数后自动确认。（整数）

story_viewers_expire_period

故事过期后，浏览过该故事的用户列表将对发布者隐藏指定秒数。（整数）

此限制仅适用于非高级用户，高级用户始终可以访问查看者列表。

story_expiring_limit_default

非高级用户的最大活跃故事数（整数）。

story_expiring_limit_premium

Premium用户可同时查看的最大故事数（整数）。

story_caption_length_limit_premium

高级用户故事标题的最大 UTF-8 长度。（整数）

story_caption_length_limit_default

非高级用户故事标题的最大 UTF-8 长度。（整数）

stories_posting

指示用户是否可以发布故事。（字符串）

之一：

• enabled任何用户都可以发布故事。
• premium只有高级会员用户才能发布故事。
• disabled用户无法发布故事。

stories_stealth_past_period

启用故事隐身模式后past，将清除过去stories_stealth_past_period几秒内打开的所有故事的视图。（整数）

stories_stealth_future_period

启用故事隐身模式后future，接下来stories_stealth_future_period几秒钟内打开的任何故事视图都会被隐藏。（整数）

stories_stealth_cooldown_period

启用故事隐身模式后，必须经过指定秒数后用户才能再次启用该模式。（整数）

stories_sent_weekly_limit_default

非高级用户每周可发送的故事数量上限。（整数）

stories_sent_weekly_limit_premium

高级用户每周可发送的故事数量上限。（整数）

stories_sent_monthly_limit_default

非高级用户每月可发送的故事数量上限。（整数）

stories_sent_monthly_limit_premium

高级用户每月可发送的故事数量上限。（整数）

stories_suggested_reactions_limit_default

非高级用户可添加到故事中的故事互动媒体区域的最大数量。（整数）

stories_suggested_reactions_limit_premium

高级用户可在故事中添加的故事互动媒体区域的最大数量。（整数）

stories_venue_search_username

用于为新闻报道生成地点标签的内联机器人的用户名，详情请见此处 » 。（字符串）

stories_changelog_user_id

负责发布 Telegram 新功能相关动态的官方 Telegram 用户 ID：即使该用户已从联系人列表中移除，其发布的动态仍会像联系人动态一样显示在“活跃动态”或“活跃/隐藏动态”栏中。（整数）

stories_entities

故事文本标题中的样式化文本实体和链接是否可供所有用户使用（enabled），仅限高级用户使用（premium），或任何用户均不得使用（disabled）。（字符串）

此字段在发布故事时用于向用户指示他们是否可以使用实体，在查看故事时用于隐藏高级订阅已过期的用户发布的故事中的实体（客户端）（如果未设置stories_entities == "premium"用户。或者如果）。premiumstories_entities == "disabled"

stories_area_url_max

可添加到已发布文章中的 URL 媒体区域的最大数量。（整数）

giveaway_gifts_purchase_available

当前用户是否可以发起抽奖活动。（布尔值）

giveaway_add_peers_max

直接抽奖时可指定的最大用户数。（整数）

giveaway_countries_max

在限制赠品活动参与国家范围时，可以指定的最大国家数量。（itneger）

giveaway_boosts_per_premium

频道因每位抽奖活动获奖者而获得的推广次数。（整数）

giveaway_period_max

抽奖活动的最长持续时间（秒）。（整数）

boosts_channel_level_max

通道最大增益级别。（整数）

boosts_per_sent_gift

当前用户赠送 Telegram Premium 订阅时将获得的额外加速槽位数量。

transcribe_audio_trial_weekly_number

非高级用户每周语音识别通话次数上限。（整数）

transcribe_audio_trial_duration_max

非高级用户语音识别允许播放媒体的最大时长（秒）。（整数）

recommended_channels_limit_default

channels.getChannelRecommendations»可以向非高级用户推荐的最大相似频道数量。（整数）

recommended_channels_limit_premium

channels.getChannelRecommendations»可以向高级用户推荐的最大相似频道数量。（整数）

quote_length_max

引用文本的最大 UTF-8 长度。（整数）

channel_bg_icon_level_min

达到至少此提升等级后，频道即可更改其消息强调色表情符号。（整数）

channel_profile_bg_icon_level_min

当频道达到至少此提升等级»channel_min_level以及所选调色板的help.peerColorOption构造函数字段中指定的提升等级后，频道即可更改个人资料强调调色板中使用的表情符号和颜色»。（整数）

group_profile_bg_icon_level_min

当超级群组达到至少此提升级别group_min_level以及所选调色板的help.peerColorOption构造函数字段中指定的提升级别后，它们将能够更改个人资料强调调色板中使用的表情符号和颜色 »。（整数）

channel_emoji_status_level_min

频道达到至少此提升等级后，即可更改其状态表情符号。（整数）

group_emoji_status_level_min

达到至少此提升等级后，超级组合即可更改其状态表情符号。（整数）

channel_wallpaper_level_min

达到至少此提升等级后»，频道即可设置全屏频道壁纸，点击此处»了解更多信息。（整数）

group_wallpaper_level_min

达到至少此提升等级后»，超级组合即可设置全屏超级组合壁纸，详情请见此处»。（整数）

channel_custom_wallpaper_level_min

达到至少此提升等级后»，频道即可设置任何自定义壁纸，而不仅仅是频道默认壁纸，点击此处»了解更多信息。（整数）

group_custom_wallpaper_level_min

达到至少此提升等级后»，超级组合将能够设置任何自定义壁纸，而不仅仅是填充超级组合壁纸，点击此处»了解更多信息。（整数）

group_transcribe_level_min

达到至少此提升等级后，超级群组中的非高级用户即可转录任何语音留言，而无需消耗其免费转录额度。（整数）

group_emoji_stickers_level_min

达到至少此提升等级后，超级群组即可关联自定义表情贴纸集，群组内所有用户（包括非高级用户！）均可在群组内发送的消息中使用该贴纸集。（整数）

channel_restrict_sponsored_level_min

频道达到至少此提升级别后，频道所有者可以使用channels.restrictSponsoredMessages为所有用户禁用频道上的广告。（整数）

saved_dialogs_pinned_limit_default

非高级用户已保存消息中置顶对话的最大数量。（整数）

saved_dialogs_pinned_limit_premium

高级用户已保存消息中置顶对话的最大数量。（整数）

can_edit_factcheck

如果为真，则当前用户为独立事实核查员，可以编辑事实核查结果。（布尔值）

factcheck_length_limit

事实核查的最大 UTF-8 长度». (整数)

quick_replies_limit

可创建的快捷回复方式的最大数量。（整数）

quick_reply_messages_limit

快速回复快捷方式可添加的消息最大数量 »。（整数）

intro_title_length_limit

企业介绍标题的最大 UTF-8 长度»。（整数）

intro_description_length_limit

企业介绍描述的最大 UTF-8 长度»。（整数）

business_chat_links_limit

当前活跃的商务聊天链接最大数量。（整数）

upload_premium_speedup_upload

表示高级会员享有的文件上传速度提升，具体用法请参见此处 »在文件上传出错时显示的“高级会员”弹窗FLOOD_WAIT_PREMIUM_X。（整数）

upload_premium_speedup_download

表示高级会员享有的文件下载速度提升，具体使用方式请参见此处 »在文件下载出错时显示的“高级会员”弹窗FLOOD_WAIT_PREMIUM_X。（整数）

upload_premium_speedup_notify_period

文件上传/下载出错时显示的 Premium 弹窗FLOOD_WAIT_PREMIUM_X最多应每秒显示一次upload_premium_speedup_notify_period。（整数）

stories_pinned_to_top_count_max

个人资料页面顶部最多可以置顶的故事数量»。（整数）

channel_revenue_withdrawal_enabled

如果为真，则表示当前地区已启用频道广告收入提现；否则，所有与广告收入相关的用户界面选项均应向用户隐藏。（布尔值）

stars_purchase_blocked

如果为 false，则表示当前地区可以使用 Telegram Stars；否则，所有与 Stars 相关的 UI 选项都应向用户隐藏。（布尔值）

stars_revenue_withdrawal_min

频道或机器人余额中允许提现的Telegram Stars最低数量要求»。（整数）

stars_paid_post_amount_max

在Telegram上发布付费媒体内容的最高价格为多少星币？（整数）

stars_gifts_enabled

只有当此标志位为 true 时，才应启用星星赠送功能。（布尔值）

bot_preview_medias_max

本地化版本可添加的主小程序预览的最大数量。（整数）

web_app_allowed_protocols

指定web_app_open_link 事件中接收到的 URL 允许的协议列表。（字符串数组）

ton_proxy_address

指定用于安全打开TON 站点的域名 »。（字符串）

stars_subscription_amount_max

指定Telegram Star 订阅的最高允许价格（以 Stars 为单位）。（int）

stars_usd_sell_rate_x1000

购买一千颗Telegram 星所需的美元数量。（浮点数）

stars_usd_withdraw_rate_x1000

指定提取一千个Telegram 星币后将收到的美元数量。（浮点数）

stars_paid_reaction_amount_max

每篇帖子可发送的付费表情符号的最大数量。（整数）

stargifts_message_length_max

礼品留言的最大长度，请点击此处»了解更多信息。（整数）

stargifts_blocked

如果为真，则必须禁用礼品功能。（布尔值）

stargifts_convert_period_max

只有在几秒钟内收到的礼物才能兑换回Telegram 星星stargifts_convert_period_max。（整数）

video_ignore_alt_documents

如果为真，则表示必须忽略messageMediaDocument字段。 （布尔值）alt_documents

starref_start_param_prefixes

推荐链接的起始参数前缀 »。（字符串数组）

starref_program_allowed

如果为 false，则当前用户无法为其拥有的机器人创建推荐计划。（布尔值）

starref_connect_allowed

如果为 false，则当前用户无法加入推荐计划，成为联盟会员。（布尔值）

starref_min_commission_permille

推荐计划允许的最低千分之一联盟佣金»。（整数）

starref_max_commission_permille

推荐计划允许的最高千分之一联盟佣金»。（整数）

inapp_update_check_delay

应每隔更新秒调用一次help.getAppUpdateinapp_update_check_delay来检查应用更新。（整数）

premium_manage_subscription_url

可用于管理高级订阅的 URL/深度链接。（字符串）

sponsored_links_inapp_allow

如果为真，则从赞助消息中打开的非深度/TON链接必须在应用内浏览器（如有）中打开；否则，必须在标准外部浏览器中打开。（布尔值）

ignore_restriction_reasons

字符串数组，包含如果在restrictionReasonreason中遇到则必须忽略的限制原因。

restriction_add_platforms

字符串数组，其中包含解析restrictionReason时必须使用的其他平台标识符。

new_noncontact_peers_require_premium_without_ownpremium

如果为真，即使我们没有高级帐户，也可以启用globalPrivacySettings设置，请参阅此处 »了解更多信息。（布尔值）new_noncontact_peers_require_premium

bot_verification_description_length_limit

机器人验证描述字段的最大 UTF-8 长度». (整数)

channel_autotranslation_level_min

达到至少此提升等级后，频道即可为所有用户启用自动翻译功能。（整数）

conference_call_size_limit

端到端电话会议的最大成员人数。

freeze_since_date

如果已设置且非零，则表示帐户被冻结时的 Unix 时间戳。（整数）

freeze_until_date

如果已设置且非零，则表示冻结账户将被删除的 Unix 时间戳，除非已向相关部门提交申诉freeze_appeal_url并被接受。（整数）

freeze_appeal_url

用户可以通过打开的网址提交申诉。（字符串）

poll_answers_max

测验投票允许的最大答案数量。（整数）

stargifts_pinned_to_top_limit

个人资料页面可置顶的礼物数量上限 »。（整数）

stars_paid_message_amount_max

指定付费消息的最高价格»。（整数）

stars_paid_message_commission_permille

发送付费消息时，接收者将获得星星数量，该数量等于消息价格乘以stars_paid_message_commission_permille1000 再除以 1000。（整数）

stars_paid_messages_available

指定是否可为当前用户启用付费消息功能。（布尔值）

stars_paid_messages_channel_amount_default

在选择付费直接频道消息的价格时，用户界面应显示stars_paid_messages_channel_amount_default作为初始默认值。

stars_revenue_withdrawal_max

可从频道或机器人余额中提取的Telegram Star最大数量。（整数）

stars_stargift_resale_amount_max

转售收藏礼品时可指定的最高价格»。（整数）

stars_stargift_resale_amount_min

转售收藏礼品时可指定的最低价格»。（整数）

stars_stargift_resale_commission_permille

转售收藏礼品时，您将获得resell_stars*stars_stargift_resale_commission_permille/1000星星。（整数）

stars_suggested_post_age_min

建议的帖子必须在频道上至少停留指定的秒数，交易才能成功完成。（整数）

stars_suggested_post_amount_max

推荐帖子最高星级价格»。（整数）

stars_suggested_post_amount_min

推荐帖子的最低星级价格»。（整数）

stars_suggested_post_commission_permille

推荐帖子时，频道将获得price*stars_suggested_post_commission_permille/1000星级评价。（整数）

stars_suggested_post_future_max

当建议在特定时间发布定时文章时，客户端可能只允许选择stars_suggested_post_future_max未来几秒钟内的日期。（整数）

stars_suggested_post_future_min

当建议在特定时间发布定时文章时，客户端可能只允许选择至少stars_suggested_post_future_max未来几秒的日期。（整数）

todo_item_length_max

待办事项列表项标题的最大长度». (整数)

todo_items_max

待办事项列表项的最大数量»。（整数）

todo_title_length_max

待办事项列表标题的最大长度»。（整数）

ton_blockchain_explorer_url

包含要添加到 TON 地址前面的基本浏览器 URL。（字符串）

ton_suggested_post_amount_max

建议帖子的最高价格（以纳吨为单位）»。（整数）

ton_suggested_post_amount_min

建议帖子的最高价格（以纳吨为单位）»。（整数）

ton_suggested_post_commission_permille

使用 Toncoin 支付并推荐帖子时，频道将获得price*ton_suggested_post_commission_permille/1000纳吨币。（整数）

ton_topup_url

用于充值 TON 余额的 URL。（字符串）

ton_usd_rate

当前TON兑USD汇率（浮动）。

stargifts_collection_gifts_limit

礼品收藏中可添加的礼品数量上限。（整数）

stargifts_collections_limit

个人资料中可添加的礼品收藏数量上限。（整数）

stars_rating_learnmore_url

用户可以通过以下网址获取更多关于星级评分的信息 »。（字符串）

stories_album_stories_limit

故事专辑中可添加的故事数量上限。（整数）

stories_albums_limit

个人资料中可添加的故事专辑数量上限。（整数）

ton_stargift_resale_amount_max

使用吨币转售收藏礼品时可指定的最高价格（以纳吨为单位）。（整数）

ton_stargift_resale_amount_min

使用吨币转售收藏礼品时可指定的最低价格（以纳吨为单位）。（整数）

ton_stargift_resale_commission_permille

使用 toncoin转售收藏礼品时，您将获得price*ton_stargift_resale_commission_permille/1000纳吨币。（整数）

need_age_video_verification

指定当前司法管辖区是否需要进行年龄验证false才能查看敏感内容。也可以表示用户已成功通过年龄验证。

（布尔值）

verify_age_country

要求进行年龄验证的国家或地区的唯一名称»。（字符串）

verify_age_min

包含查看sensitive内容所需的最低年龄，用于年龄验证 »。（整数）

verify_age_bot_username

包含要进行年龄验证，必须打开该机器人的主小程序才能继续。（字符串）

call_requests_disabled

如果未设置或为 false，则未设置`and`标志的传入消息操作会议呼叫应触发振铃和来电屏幕，就像一对一通话一样。（布尔值）missedactive

建议

help.promoData#8a4d87a flags:# proxy:flags.0?true expires:int peer:flags.3?Peer psa_type:flags.1?string psa_message:flags.2?string pending_suggestions:Vector<string> dismissed_suggestions:Vector<string> custom_pending_suggestion:flags.4?PendingSuggestion chats:Vector<Chat> users:Vector<User> = help.PromoData;help.promoDataEmpty#98f6ac75 expires:int = help.PromoData;---functions---help.getPromoData#c0977421 = help.PromoData;

API 可以使用help.getPromoData方法为图形客户端用户返回一组有用的建议和 PSA/MTProxy 信息。

应调用此方法：

• 在客户端启动时
• 在help.PromoData之后，经过.expires秒，直到客户端关闭。
• 每次建立新的 MTProxy 连接时。

PSA信息

help.promoData#8a4d87a flags:# proxy:flags.0?true expires:int peer:flags.3?Peer psa_type:flags.1?string psa_message:flags.2?string pending_suggestions:Vector<string> dismissed_suggestions:Vector<string> custom_pending_suggestion:flags.4?PendingSuggestion chats:Vector<Chat> users:Vector<User> = help.PromoData;help.promoDataEmpty#98f6ac75 expires:int = help.PromoData;---functions---help.getPromoData#c0977421 = help.PromoData;help.hidePromoData#1e251c95 peer:InputPeer = Bool;

help.getPromoData返回的help.promoDatapeer的,psa_type（公告类型）和psa_message（公告文本）标志将全部设置，用于将公共服务公告置顶到聊天列表顶部的公告。

在这种情况下，该proxy标志永远不会被设置。

调用help.hidePromoData以从help.promoData中隐藏 PSA 对等体。

MTProxy赞助商

help.promoData#8a4d87a flags:# proxy:flags.0?true expires:int peer:flags.3?Peer psa_type:flags.1?string psa_message:flags.2?string pending_suggestions:Vector<string> dismissed_suggestions:Vector<string> custom_pending_suggestion:flags.4?PendingSuggestion chats:Vector<Chat> users:Vector<User> = help.PromoData;help.promoDataEmpty#98f6ac75 expires:int = help.PromoData;---functions---help.getPromoData#c0977421 = help.PromoData;help.hidePromoData#1e251c95 peer:InputPeer = Bool;

peer当使用已配置关联对等方（即赞助 MTProxy 的频道）的 MTProxy 连接时，help.getPromoData返回的help.promoDataproxy的所有标志都将被设置，该关联对等方应置顶于聊天列表顶部。

调用help.hidePromoData以从help.promoData中隐藏 MTProxy 对等体。

基本建议

help.promoData#8a4d87a flags:# proxy:flags.0?true expires:int peer:flags.3?Peer psa_type:flags.1?string psa_message:flags.2?string pending_suggestions:Vector<string> dismissed_suggestions:Vector<string> custom_pending_suggestion:flags.4?PendingSuggestion chats:Vector<Chat> users:Vector<User> = help.PromoData;help.promoDataEmpty#98f6ac75 expires:int = help.PromoData;---functions---help.getPromoData#c0977421 = help.PromoData;help.dismissSuggestion#f50dbaa1 peer:InputPeer suggestion:string = Bool;

help.getPromoData返回的help.promoData字段包含一个建议列表，该pending_suggestions列表应作为工具提示主动显示给用户。

可以调用help.dismissSuggestion来驳回建议（使用peer=inputPeerEmpty），这将从pending_suggestions字段中删除该建议。

建议值列表：

AUTOARCHIVE_POPULAR

用户应调用account.setGlobalPrivacySettings，以globalPrivacySettings.archive_and_mute_new_noncontact_peers = boolTrue自动存档和屏蔽来自非联系人的新聊天信息。

VALIDATE_PASSWORD

用户应确保自己仍然记得两步验证密码。

VALIDATE_PHONE_NUMBER

用户应检查其授权电话号码是否正确，如果无法接通，则应更改电话号码。

NEWCOMER_TICKS

向用户显示已发送消息中一个勾号和两个勾号的含义提示。

SETUP_PASSWORD

向用户显示提示，询问他们是否还记得双因素认证密码。

PREMIUM_ANNUAL

建议用户订阅 Telegram Premium（需按年付费）

PREMIUM_UPGRADE

建议用户将其现有的高级订阅从按月付费升级为按年付费。

PREMIUM_RESTORE

建议用户恢复最近过期的高级订阅

PREMIUM_CHRISTMAS

建议用户在圣诞节期间赠送朋友Telegram Premium会员资格。

PREMIUM_GRACE

建议用户延长即将到期的 Telegram Premium 会员资格

BIRTHDAY_SETUP

建议用户设置生日»。

STARS_SUBSCRIPTION_LOW_BALANCE

当一个或多个有效订阅即将到期，且当前Telegram Star 余额不足以自动续订至少一个订阅时，此建议将被激活：当用户点击此建议时，客户端应通过调用`payments.getStarsSubscriptions`并传递`inputPeerSelf` 参数peer以及设置标志来获取并显示即将到期的订阅列表：返回的订阅可以通过向当前 Telegram Star 余额充值至少`payments.starsStatus`missing_balance来续订。subscriptions_missing_balance

USERPIC_SETUP

建议用户设置个人资料图片 »。

自定义建议

help.promoData#8a4d87a flags:# proxy:flags.0?true expires:int peer:flags.3?Peer psa_type:flags.1?string psa_message:flags.2?string pending_suggestions:Vector<string> dismissed_suggestions:Vector<string> custom_pending_suggestion:flags.4?PendingSuggestion chats:Vector<Chat> users:Vector<User> = help.PromoData;pendingSuggestion#e7e82e12 suggestion:string title:TextWithEntities description:TextWithEntities url:string = PendingSuggestion;---functions---help.getPromoData#c0977421 = help.PromoData;help.dismissSuggestion#f50dbaa1 peer:InputPeer suggestion:string = Bool;

help.getPromoData返回的help.promoData字段custom_pending_suggestion包含一个自定义建议列表，这些建议应该以工具提示的形式主动显示给用户。

自定义建议包含一个预填充的字段title，description一个url在点击建议时应该打开的字段，以及一个suggestion包含标识符的字段，该标识符应在调用help.dismissSuggestion来关闭建议时使用（使用peer=inputPeerEmpty），这将从custom_pending_suggestion字段中删除该建议。

这与基本建议不同，基本建议实际上只有suggestion标识符，客户端应根据标识符填写描述、标题和操作。

反向暗示

help.promoData#8a4d87a flags:# proxy:flags.0?true expires:int peer:flags.3?Peer psa_type:flags.1?string psa_message:flags.2?string pending_suggestions:Vector<string> dismissed_suggestions:Vector<string> custom_pending_suggestion:flags.4?PendingSuggestion chats:Vector<Chat> users:Vector<User> = help.PromoData;help.promoDataEmpty#98f6ac75 expires:int = help.PromoData;---functions---help.getPromoData#c0977421 = help.PromoData;help.dismissSuggestion#f50dbaa1 peer:InputPeer suggestion:string = Bool;

这些建议默认启用，但永远不会在help.getPromoDatapending_suggestions返回的字段中返回。

可以像往常一样通过调用help.dismissSuggestion来忽略它们，但与基本建议（带有peer=inputPeerEmpty）不同，一旦忽略，它们将出现在客户端配置对象的dismissed_suggestions字段中。

反向建议列表：

BIRTHDAY_CONTACTS_TODAY

如果未被忽略，则表示客户端应显示工具提示，建议在联系人生日时赠送 Telegram Premium 订阅 »。

当用户隐藏工具提示时，可以通过调用help.dismissSuggestion来忽略此建议；但如果用户向在接下来的/过去的 24 小时内过生日的朋友赠送一个或多个 Telegram Premium 订阅，服务器也会自动忽略此建议。

频道推荐

messages.chatFull#e5d7d19c full_chat:ChatFull chats:Vector<Chat> users:Vector<User> = messages.ChatFull;channelFull#e4e0b29d flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true flags2:# can_delete_channel:flags2.0?true antispam:flags2.1?true participants_hidden:flags2.2?true translations_disabled:flags2.3?true stories_pinned_available:flags2.5?true view_forum_as_messages:flags2.6?true restricted_sponsored:flags2.11?true can_view_revenue:flags2.12?true paid_media_allowed:flags2.14?true can_view_stars_revenue:flags2.15?true paid_reactions_available:flags2.16?true stargifts_available:flags2.19?true paid_messages_available:flags2.20?true id:long about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:flags.23?ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?long migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?long location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int call:flags.21?InputGroupCall ttl_period:flags.24?int pending_suggestions:flags.25?Vector<string> groupcall_default_join_as:flags.26?Peer theme_emoticon:flags.27?string requests_pending:flags.28?int recent_requesters:flags.28?Vector<long> default_send_as:flags.29?Peer available_reactions:flags.30?ChatReactions reactions_limit:flags2.13?int stories:flags2.4?PeerStories wallpaper:flags2.7?WallPaper boosts_applied:flags2.8?int boosts_unrestrict:flags2.9?int emojiset:flags2.10?StickerSet bot_verification:flags2.17?BotVerification stargifts_count:flags2.18?int send_paid_messages_stars:flags2.21?long main_tab:flags2.22?ProfileTab = ChatFull;---functions---channels.getFullChannel#8736a09 channel:InputChannel = messages.ChatFull;

一些与频道/超群组相关的建议也可以包含在channelFullpending_suggestions构造函数的字段中，该构造函数由channels.getFullChannel返回。以下是一些可能的建议：

CONVERT_GIGAGROUP

超级组有很多参与者：管理员应该调用channels.convertToGigagroup将其转换为千兆组。

驳回建议

boolFalse#bc799737 = Bool; boolTrue#997275b5 = Bool;---functions---help.dismissSuggestion#f50dbaa1 peer:InputPeer suggestion:string = Bool;

help.dismissSuggestion可用于忽略建议。对于基本建议和自定义建议，
请传递inputPeerEmpty；对于频道建议，peer请传递频道/超级组的对等节点。

应用程序特定配置

help.appUpdate#ccbbce30 flags:# can_not_skip:flags.0?true id:int version:string text:string entities:Vector<MessageEntity> document:flags.1?Document url:flags.2?string sticker:flags.3?Document = help.AppUpdate; help.noAppUpdate#c45a6536 = help.AppUpdate;updates#74ae4240 updates:Vector<Update> users:Vector<User> chats:Vector<Chat> date:int seq:int = Updates; updateServiceNotification#ebe46819 flags:# popup:flags.0?true invert_media:flags.2?true inbox_date:flags.1?int type:string message:string media:MessageMedia entities:Vector<MessageEntity> = Update;help.inviteText#18cb9f78 message:string = help.InviteText;---functions---help.getAppUpdate#522d5a7d source:string = help.AppUpdate;help.getInviteText#4d392343 = help.InviteText;

• help.getAppUpdate- 获取应用程序更新信息，可能包含附加文档中的更新后的应用程序二进制文件。
• help.getInviteText- 返回一条本地化的邀请消息，该消息可以通过短信发送给尚未注册 Telegram 的联系人。

服务条款

help.termsOfServiceUpdateEmpty#e3309f7f expires:int = help.TermsOfServiceUpdate; help.termsOfServiceUpdate#28ecf961 expires:int terms_of_service:help.TermsOfService = help.TermsOfServiceUpdate;help.termsOfService#780a0310 flags:# popup:flags.0?true id:DataJSON text:string entities:Vector<MessageEntity> min_age_confirm:flags.1?int = help.TermsOfService;auth.authorizationSignUpRequired#44747e9a flags:# terms_of_service:flags.0?help.TermsOfService = auth.Authorization;---functions---help.getTermsOfServiceUpdate#2ca51fd1 = help.TermsOfServiceUpdate; help.acceptTermsOfService#ee72f79a id:DataJSON = Bool;auth.signIn#8d52a951 flags:# phone_number:string phone_code_hash:string phone_code:flags.0?string email_verification:flags.1?EmailVerification = auth.Authorization;account.deleteAccount#a2c0cf74 flags:# reason:string password:flags.0?InputCheckPasswordSRP = Bool;

这些方法可用于管理用户对 Telegram服务条款的同意情况。

通常情况下，在用户通过调用auth.signUp注册之前，应用程序应该显示一个弹出窗口（如果设置了help.termsOfService方法的标志），要求用户接受 Telegram 的服务条款；如果用户拒绝，则应将用户返回到登录流程的初始页面。popup

首次注册时，应从auth.signIn返回的auth.authorizationSignUpRequired构造函数中获取help.termsOfService。

用户注册后或以现有用户身份登录时，应用应调用`help.getTermsOfServiceUpdate`来检查服务条款是否有更新；此调用应在expires几秒钟后重复执行。
如果服务条款有更新，客户端应显示同意弹出窗口；如果用户接受，客户端应调用`help.acceptTermsOfService`并提供`termsOfService`idJSON 对象；如果用户拒绝，客户端应使用`account.deleteAccount`删除帐户，并提供Decline ToS update删除参数reason。

示例实现：android（注册），android（登录后）

Telegram 支持信息

user#20b1422 flags:# self:flags.10?true contact:flags.11?true mutual_contact:flags.12?true deleted:flags.13?true bot:flags.14?true bot_chat_history:flags.15?true bot_nochats:flags.16?true verified:flags.17?true restricted:flags.18?true min:flags.20?true bot_inline_geo:flags.21?true support:flags.23?true scam:flags.24?true apply_min_photo:flags.25?true fake:flags.26?true bot_attach_menu:flags.27?true premium:flags.28?true attach_menu_enabled:flags.29?true flags2:# bot_can_edit:flags2.1?true close_friend:flags2.2?true stories_hidden:flags2.3?true stories_unavailable:flags2.4?true contact_require_premium:flags2.10?true bot_business:flags2.11?true bot_has_main_app:flags2.13?true id:long access_hash:flags.0?long first_name:flags.1?string last_name:flags.2?string username:flags.3?string phone:flags.4?string photo:flags.5?UserProfilePhoto status:flags.6?UserStatus bot_info_version:flags.14?int restriction_reason:flags.18?Vector<RestrictionReason> bot_inline_placeholder:flags.19?string lang_code:flags.22?string emoji_status:flags.30?EmojiStatus usernames:flags2.0?Vector<Username> stories_max_id:flags2.5?int color:flags2.8?PeerColor profile_color:flags2.9?PeerColor bot_active_users:flags2.12?int bot_verification_icon:flags2.14?long send_paid_messages_stars:flags2.15?long = User;help.support#17c6b5f6 phone_number:string user:User = help.Support; help.supportName#8c05f1c9 name:string = help.SupportName;---functions---help.getSupport#9cdf08cd = help.Support; help.getSupportName#d360e72c = help.SupportName;

这些方法可用于获取有关 Telegram 支持用户的信息，用户可以使用这些信息来获得支持并询问有关该应用程序的问题。

• help.getSupport- 将返回可用于联系支持的用户对象。
• help.getSupportName- 将返回支持聊天的本地化名称。

国家信息和登录手机模式

help.countryCode#4203c5ef flags:# country_code:string prefixes:flags.0?Vector<string> patterns:flags.1?Vector<string> = help.CountryCode;help.country#c3878e23 flags:# hidden:flags.0?true iso2:string default_name:string name:flags.1?string country_codes:Vector<help.CountryCode> = help.Country;help.countriesListNotModified#93cc1f32 = help.CountriesList; help.countriesList#87d0759e countries:Vector<help.Country> hash:int = help.CountriesList;---functions---help.getCountriesList#735787a8 lang_code:string hash:int = help.CountriesList;

help.getCountriesList可用于获取所有可用国家/地区的本地化名称列表以及用于登录的电话区号模式。

显示登录界面或更改电话号码时，应使用电话号码区号模式：例如，模式值为XXX XXX XXX`with`country_code+39表示登录电话号码字段应接受类似`10+39 123 456 789...
123 456 789prefixes

此外，fragment_prefixes客户端配置参数包含匿名Fragment电话号码的电话号码前缀列表。