Update content of files

This commit is contained in:
GitHub Action 2024-07-08 16:27:40 +00:00
parent 005b72d80a
commit 6a9cb1834f
3 changed files with 41 additions and 1 deletions

View file

@ -120,6 +120,7 @@ Thus, the merge result of this special intersection case is two intervals, the f
The timezone ID is contained <a href="/constructor/timezone">timezone</a>.<code>id</code>, a human-readable, localized name of the timezone is available in <a href="/constructor/timezone">timezone</a>.<code>name</code> and the <a href="/constructor/timezone">timezone</a>.<code>utc_offset</code> field contains the UTC offset in seconds, which may be displayed in hh:mm format by the client together with the human-readable name (i.e. <code>$name UTC -01:00</code>).</li>
<li><code>open_now</code> - Ignored when passed by the client, only populated by the server in <a href="/constructor/userFull">userFull</a>.<code>business_work_hours</code>, indicating whether the business is currently open according to the current time and the values in <code>weekly_open</code> and <code>timezone</code>. </li>
</ul>
<p>Changing the opening hours will emit an <a href="/constructor/updateUser">updateUser</a>. </p>
<p>To remove all info about opening hours, invoke <a href="/method/account.updateBusinessWorkHours">account.updateBusinessWorkHours</a> without populating the <code>business_work_hours</code> flag. </p>
<h3><a class="anchor" href="#location" id="location" name="location"><i class="anchor-icon"></i></a>Location</h3>
<pre><code><a href='/constructor/businessLocation'>businessLocation</a>#ac5c1af7 flags:<a href='/type/%23'>#</a> geo_point:flags.0?<a href='/type/GeoPoint'>GeoPoint</a> address:<a href='/type/string'>string</a> = <a href='/type/BusinessLocation'>BusinessLocation</a>;
@ -138,6 +139,7 @@ The timezone ID is contained <a href="/constructor/timezone">timezone</a>.<code>
<p>To remove business location information invoke the method without setting any of the parameters. </p>
<p>If a <code>geo_point</code> is set, the business' location will also be advertised to geographically close users using the nearby users feature, <a href="/api/nearby/#fetching-nearby-users-and-geogroups">as described here »</a>. </p>
<p>Note that even if just the <code>address</code> is set (with or without a <code>geo_point</code>), the current geolocation of the user may not be changed using <a href="/method/contacts.getLocated">contacts.getLocated</a> method (i.e. for the <a href="/api/nearby#advertising-our-current-location">nearby users feature</a>): it will return a <code>BUSINESS_ADDRESS_ACTIVE</code> error, indicating that the location may only be changed (or removed) using <a href="/method/account.updateBusinessLocation">account.updateBusinessLocation »</a>. </p>
<p>Changing the location will emit an <a href="/constructor/updateUser">updateUser</a>. </p>
<h3><a class="anchor" href="#quick-reply-shortcuts" id="quick-reply-shortcuts" name="quick-reply-shortcuts"><i class="anchor-icon"></i></a>Quick reply shortcuts</h3>
<p>Telegram Business allows you to create <strong>quick replies</strong>.<br>
Quick replies are shortcuts for sending preset messages that may contain several messages and support text formatting, links, stickers, media, and files. </p>
@ -291,6 +293,19 @@ This will also emit an <a href="/constructor/updateDeleteQuickReply">updateDelet
<p>Use <a href="/method/account.updateBusinessAwayMessage">account.updateBusinessAwayMessage</a> to set a (list of) away messages in <code>message</code>; to disable greetings, call the method without populating the <code>message</code> field. </p>
<p>If populated, the <code>message</code> field must contain a <a href="/constructor/inputBusinessAwayMessage">inputBusinessAwayMessage</a>, see <a href="/constructor/inputBusinessAwayMessage">the constructor page »</a> for a description of its contents. </p>
<p>The currently configured business away message can be fetched by the current user through <a href="/constructor/userFull">userFull</a>.<code>business_away_message</code>, represented by a <a href="/constructor/businessAwayMessage">businessAwayMessage constructor »</a>, equivalent to the input counterpart. </p>
<h3><a class="anchor" href="#business-introduction" id="business-introduction" name="business-introduction"><i class="anchor-icon"></i></a>Business introduction</h3>
<pre><code><a href='/constructor/inputBusinessIntro'>inputBusinessIntro</a>#09c469cd flags:<a href='/type/%23'>#</a> title:<a href='/type/string'>string</a> description:<a href='/type/string'>string</a> sticker:flags.0?<a href='/type/InputDocument'>InputDocument</a> = <a href='/type/InputBusinessIntro'>InputBusinessIntro</a>;
<a href='/constructor/businessIntro'>businessIntro</a>#5a0a066d flags:<a href='/type/%23'>#</a> title:<a href='/type/string'>string</a> description:<a href='/type/string'>string</a> sticker:flags.0?<a href='/type/Document'>Document</a> = <a href='/type/BusinessIntro'>BusinessIntro</a>;
<a href='/constructor/userFull'>userFull</a>#cc997720 flags:<a href='/type/%23'>#</a> blocked:flags.0?<a href='/constructor/true'>true</a> phone_calls_available:flags.4?<a href='/constructor/true'>true</a> phone_calls_private:flags.5?<a href='/constructor/true'>true</a> can_pin_message:flags.7?<a href='/constructor/true'>true</a> has_scheduled:flags.12?<a href='/constructor/true'>true</a> video_calls_available:flags.13?<a href='/constructor/true'>true</a> voice_messages_forbidden:flags.20?<a href='/constructor/true'>true</a> translations_disabled:flags.23?<a href='/constructor/true'>true</a> stories_pinned_available:flags.26?<a href='/constructor/true'>true</a> blocked_my_stories_from:flags.27?<a href='/constructor/true'>true</a> wallpaper_overridden:flags.28?<a href='/constructor/true'>true</a> contact_require_premium:flags.29?<a href='/constructor/true'>true</a> read_dates_private:flags.30?<a href='/constructor/true'>true</a> flags2:<a href='/type/%23'>#</a> id:<a href='/type/long'>long</a> about:flags.1?<a href='/type/string'>string</a> settings:<a href='/type/PeerSettings'>PeerSettings</a> personal_photo:flags.21?<a href='/type/Photo'>Photo</a> profile_photo:flags.2?<a href='/type/Photo'>Photo</a> fallback_photo:flags.22?<a href='/type/Photo'>Photo</a> notify_settings:<a href='/type/PeerNotifySettings'>PeerNotifySettings</a> bot_info:flags.3?<a href='/type/BotInfo'>BotInfo</a> pinned_msg_id:flags.6?<a href='/type/int'>int</a> common_chats_count:<a href='/type/int'>int</a> folder_id:flags.11?<a href='/type/int'>int</a> ttl_period:flags.14?<a href='/type/int'>int</a> theme_emoticon:flags.15?<a href='/type/string'>string</a> private_forward_name:flags.16?<a href='/type/string'>string</a> bot_group_admin_rights:flags.17?<a href='/type/ChatAdminRights'>ChatAdminRights</a> bot_broadcast_admin_rights:flags.18?<a href='/type/ChatAdminRights'>ChatAdminRights</a> premium_gifts:flags.19?<a href='/type/Vector%20t'>Vector</a>&lt;<a href='/type/PremiumGiftOption'>PremiumGiftOption</a>&gt; wallpaper:flags.24?<a href='/type/WallPaper'>WallPaper</a> stories:flags.25?<a href='/type/PeerStories'>PeerStories</a> business_work_hours:flags2.0?<a href='/type/BusinessWorkHours'>BusinessWorkHours</a> business_location:flags2.1?<a href='/type/BusinessLocation'>BusinessLocation</a> business_greeting_message:flags2.2?<a href='/type/BusinessGreetingMessage'>BusinessGreetingMessage</a> business_away_message:flags2.3?<a href='/type/BusinessAwayMessage'>BusinessAwayMessage</a> business_intro:flags2.4?<a href='/type/BusinessIntro'>BusinessIntro</a> birthday:flags2.5?<a href='/type/Birthday'>Birthday</a> personal_channel_id:flags2.6?<a href='/type/long'>long</a> personal_channel_message:flags2.6?<a href='/type/int'>int</a> = <a href='/type/UserFull'>UserFull</a>;
---functions---
<a href='/method/account.updateBusinessIntro'>account.updateBusinessIntro</a>#a614d034 flags:<a href='/type/%23'>#</a> intro:flags.0?<a href='/type/InputBusinessIntro'>InputBusinessIntro</a> = <a href='/type/Bool'>Bool</a>;</code></pre>
<p>Telegram Business allows to configure the message and sticker of the <a href="/api/profile#introduction">profile introduction »</a>, shown to new users that don't have a private chat with us. </p>
<p>Use <a href="/method/account.updateBusinessIntro">account.updateBusinessIntro</a> to set a custom business introduction; invoke the same method without setting the <code>intro</code> flag to remove the custom business introduction, defaulting to a randomly-chosen introduction message and sticker (see <a href="/api/profile">here »</a> for more info on default profile introductions). </p>
<p>Changing the business introduction will emit an <a href="/constructor/updateUser">updateUser</a>, and the business introduction will be contained in <a href="/constructor/userFull">userFull</a>.<code>intro</code>. </p>
<h3><a class="anchor" href="#business-chat-links" id="business-chat-links" name="business-chat-links"><i class="anchor-icon"></i></a>Business chat links</h3>
<pre><code><a href='/constructor/inputBusinessChatLink'>inputBusinessChatLink</a>#11679fa7 flags:<a href='/type/%23'>#</a> message:<a href='/type/string'>string</a> entities:flags.0?<a href='/type/Vector%20t'>Vector</a>&lt;<a href='/type/MessageEntity'>MessageEntity</a>&gt; title:flags.1?<a href='/type/string'>string</a> = <a href='/type/InputBusinessChatLink'>InputBusinessChatLink</a>;

View file

@ -74,6 +74,16 @@
<p>Use <a href="/method/photos.updateProfilePhoto">photos.updateProfilePhoto</a> or <a href="/method/photos.uploadProfilePhoto">photos.uploadProfilePhoto</a> to set a profile (optionally animated) picture, emitting an <a href="/constructor/updateUser">updateUser</a>. </p>
<p>The photo will be contained in <a href="/constructor/user">user</a>.<code>photo</code>. </p>
<p>See <a href="/api/files#uploading-profile-or-chat-pictures">here »</a> for full info on profile pictures and how to work with them. </p>
<h3><a class="anchor" href="#introduction" id="introduction" name="introduction"><i class="anchor-icon"></i></a>Introduction</h3>
<pre><code><a href='/constructor/messages.stickersNotModified'>messages.stickersNotModified</a>#f1749a22 = <a href='/type/messages.Stickers'>messages.Stickers</a>;
<a href='/constructor/messages.stickers'>messages.stickers</a>#30a6ec7e hash:<a href='/type/long'>long</a> stickers:<a href='/type/Vector%20t'>Vector</a>&lt;<a href='/type/Document'>Document</a>&gt; = <a href='/type/messages.Stickers'>messages.Stickers</a>;
---functions---
<a href='/method/messages.getStickers'>messages.getStickers</a>#d5a5d3a1 emoticon:<a href='/type/string'>string</a> hash:<a href='/type/long'>long</a> = <a href='/type/messages.Stickers'>messages.Stickers</a>;</code></pre>
<p>When the user opens a private chat with a user they don't have a history with, the UI should display a randomly chosen greeting sticker+invitation to send a message. </p>
<p>To fetch this special list of greeting stickers, invoke <a href="/method/messages.getStickers">messages.getStickers</a> with <code>emoticon=<img class="emoji" src="//telegram.org/img/emoji/40/F09F918B.png" width="20" height="20" alt="👋" /><img class="emoji" src="//telegram.org/img/emoji/40/E2AD90.png" width="20" height="20" alt="⭐️" /></code>. </p>
<p>Note that if a custom <a href="/api/business#business-introduction">Telegram Business introduction »</a> is enabled, the message+sticker specified in <a href="/constructor/userFull">userFull</a>.<code>intro</code> should be used, instead. </p>
<h3><a class="anchor" href="#emoji-status" id="emoji-status" name="emoji-status"><i class="anchor-icon"></i></a>Emoji status</h3>
<pre><code><a href='/constructor/user'>user</a>#215c4438 flags:<a href='/type/%23'>#</a> self:flags.10?<a href='/constructor/true'>true</a> contact:flags.11?<a href='/constructor/true'>true</a> mutual_contact:flags.12?<a href='/constructor/true'>true</a> deleted:flags.13?<a href='/constructor/true'>true</a> bot:flags.14?<a href='/constructor/true'>true</a> bot_chat_history:flags.15?<a href='/constructor/true'>true</a> bot_nochats:flags.16?<a href='/constructor/true'>true</a> verified:flags.17?<a href='/constructor/true'>true</a> restricted:flags.18?<a href='/constructor/true'>true</a> min:flags.20?<a href='/constructor/true'>true</a> bot_inline_geo:flags.21?<a href='/constructor/true'>true</a> support:flags.23?<a href='/constructor/true'>true</a> scam:flags.24?<a href='/constructor/true'>true</a> apply_min_photo:flags.25?<a href='/constructor/true'>true</a> fake:flags.26?<a href='/constructor/true'>true</a> bot_attach_menu:flags.27?<a href='/constructor/true'>true</a> premium:flags.28?<a href='/constructor/true'>true</a> attach_menu_enabled:flags.29?<a href='/constructor/true'>true</a> flags2:<a href='/type/%23'>#</a> bot_can_edit:flags2.1?<a href='/constructor/true'>true</a> close_friend:flags2.2?<a href='/constructor/true'>true</a> stories_hidden:flags2.3?<a href='/constructor/true'>true</a> stories_unavailable:flags2.4?<a href='/constructor/true'>true</a> contact_require_premium:flags2.10?<a href='/constructor/true'>true</a> bot_business:flags2.11?<a href='/constructor/true'>true</a> id:<a href='/type/long'>long</a> access_hash:flags.0?<a href='/type/long'>long</a> first_name:flags.1?<a href='/type/string'>string</a> last_name:flags.2?<a href='/type/string'>string</a> username:flags.3?<a href='/type/string'>string</a> phone:flags.4?<a href='/type/string'>string</a> photo:flags.5?<a href='/type/UserProfilePhoto'>UserProfilePhoto</a> status:flags.6?<a href='/type/UserStatus'>UserStatus</a> bot_info_version:flags.14?<a href='/type/int'>int</a> restriction_reason:flags.18?<a href='/type/Vector%20t'>Vector</a>&lt;<a href='/type/RestrictionReason'>RestrictionReason</a>&gt; bot_inline_placeholder:flags.19?<a href='/type/string'>string</a> lang_code:flags.22?<a href='/type/string'>string</a> emoji_status:flags.30?<a href='/type/EmojiStatus'>EmojiStatus</a> usernames:flags2.0?<a href='/type/Vector%20t'>Vector</a>&lt;<a href='/type/Username'>Username</a>&gt; stories_max_id:flags2.5?<a href='/type/int'>int</a> color:flags2.8?<a href='/type/PeerColor'>PeerColor</a> profile_color:flags2.9?<a href='/type/PeerColor'>PeerColor</a> = <a href='/type/User'>User</a>;
@ -167,7 +177,7 @@ Updating/reordering usernames will emit an <a href="/constructor/updateUserName"
<a href='/method/account.updateBusinessGreetingMessage'>account.updateBusinessGreetingMessage</a>#66cdafc4 flags:<a href='/type/%23'>#</a> message:flags.0?<a href='/type/InputBusinessGreetingMessage'>InputBusinessGreetingMessage</a> = <a href='/type/Bool'>Bool</a>;
<a href='/method/account.updateBusinessAwayMessage'>account.updateBusinessAwayMessage</a>#a26a7fa5 flags:<a href='/type/%23'>#</a> message:flags.0?<a href='/type/InputBusinessAwayMessage'>InputBusinessAwayMessage</a> = <a href='/type/Bool'>Bool</a>;
<a href='/method/account.updateBusinessIntro'>account.updateBusinessIntro</a>#a614d034 flags:<a href='/type/%23'>#</a> intro:flags.0?<a href='/type/InputBusinessIntro'>InputBusinessIntro</a> = <a href='/type/Bool'>Bool</a>;</code></pre>
<p>A large number of <a href="/api/business">Telegram Business-related</a> information should be displayed on the profile page, see <a href="/api/business">here »</a> for the full list of fields and how they can be changed. </p>
<p>A large number of various <a href="/api/business">Telegram Business-related</a> information should be displayed on the profile page, see <a href="/api/business">here »</a> for the full list of fields and how they can be changed. </p>
<h3><a class="anchor" href="#online-status" id="online-status" name="online-status"><i class="anchor-icon"></i></a>Online status</h3>
<pre><code><a href='/constructor/userStatusEmpty'>userStatusEmpty</a>#9d05049 = <a href='/type/UserStatus'>UserStatus</a>;
<a href='/constructor/userStatusOnline'>userStatusOnline</a>#edb93949 expires:<a href='/type/int'>int</a> = <a href='/type/UserStatus'>UserStatus</a>;

View file

@ -368,6 +368,21 @@ The <a href="/api/config#stickers-emoji-cache-time">stickers_emoji_cache_time ap
</ul>
</li>
</ul>
<h3><a class="anchor" href="#special-stickers" id="special-stickers" name="special-stickers"><i class="anchor-icon"></i></a>Special stickers</h3>
<pre><code><a href='/constructor/messages.stickersNotModified'>messages.stickersNotModified</a>#f1749a22 = <a href='/type/messages.Stickers'>messages.Stickers</a>;
<a href='/constructor/messages.stickers'>messages.stickers</a>#30a6ec7e hash:<a href='/type/long'>long</a> stickers:<a href='/type/Vector%20t'>Vector</a>&lt;<a href='/type/Document'>Document</a>&gt; = <a href='/type/messages.Stickers'>messages.Stickers</a>;
---functions---
<a href='/method/messages.getStickers'>messages.getStickers</a>#d5a5d3a1 emoticon:<a href='/type/string'>string</a> hash:<a href='/type/long'>long</a> = <a href='/type/messages.Stickers'>messages.Stickers</a>;</code></pre>
<p>Some places in the UI require the usage of a server-specified list of stickers, independent from the installed stickersets, that may be fetched from the server using <a href="/method/messages.getStickers">messages.getStickers</a> and a specific value of <code>emoticon</code>. </p>
<h4><a class="anchor" href="#premium-sticker-examples" id="premium-sticker-examples" name="premium-sticker-examples"><i class="anchor-icon"></i></a>Premium sticker examples</h4>
<p>Some places in the UI might require showing a list of Premium stickers, as an example of stickers that may be used if the user buys a <a href="/api/premium">Premium subscription</a>. </p>
<p>To fetch this special list, invoke <a href="/method/messages.getStickers">messages.getStickers</a> with <code>emoticon=<img class="emoji" src="//telegram.org/img/emoji/40/E2AD90.png" width="20" height="20" alt="⭐️" /><img class="emoji" src="//telegram.org/img/emoji/40/E2AD90.png" width="20" height="20" alt="⭐️" /></code></p>
<h4><a class="anchor" href="#greeting-stickers" id="greeting-stickers" name="greeting-stickers"><i class="anchor-icon"></i></a>Greeting stickers</h4>
<p>When the user opens a private chat with a user they don't have a history with, the UI should display a randomly chosen greeting sticker+invitation to send a message. </p>
<p>To fetch this special list of greeting stickers, invoke <a href="/method/messages.getStickers">messages.getStickers</a> with <code>emoticon=<img class="emoji" src="//telegram.org/img/emoji/40/F09F918B.png" width="20" height="20" alt="👋" /><img class="emoji" src="//telegram.org/img/emoji/40/E2AD90.png" width="20" height="20" alt="⭐️" /></code>. </p>
<p>Note that if a custom <a href="/api/business#business-introduction">Telegram Business introduction »</a> is enabled, the message+sticker specified in <a href="/constructor/userFull">userFull</a>.<code>intro</code> should be used, instead. </p>
<h3><a class="anchor" href="#attached-stickers" id="attached-stickers" name="attached-stickers"><i class="anchor-icon"></i></a>Attached stickers</h3>
<pre><code><a href='/constructor/inputMediaUploadedPhoto'>inputMediaUploadedPhoto</a>#1e287d04 flags:<a href='/type/%23'>#</a> spoiler:flags.2?<a href='/constructor/true'>true</a> file:<a href='/type/InputFile'>InputFile</a> stickers:flags.0?<a href='/type/Vector%20t'>Vector</a>&lt;<a href='/type/InputDocument'>InputDocument</a>&gt; ttl_seconds:flags.1?<a href='/type/int'>int</a> = <a href='/type/InputMedia'>InputMedia</a>;