diff --git a/data/web/blogfork.telegram.org/bots/webapps.html b/data/web/blogfork.telegram.org/bots/webapps.html index 8250444f06..71f219b2ba 100644 --- a/data/web/blogfork.telegram.org/bots/webapps.html +++ b/data/web/blogfork.telegram.org/bots/webapps.html @@ -57,6 +57,13 @@
Bot API 6.2
+Bot API 6.1
-TL;DR: Web App Bots can request to be added directly to a user's attachment menu, allowing them to be quickly launched from any chat. To try this mode, open this attachment menu link for @DurgerKingBot, then use the menu in any type of chat.
Web App Bots can request to be added directly to a user's attachment menu, allowing them to be quickly launched from any type of chat. NEW You can configure in which types of chats your web app can be started from the attachment menu (private, groups, supergroups or channels).
+Web App Bots can request to be added directly to a user's attachment menu, allowing them to be quickly launched from any type of chat. You can configure in which types of chats your web app can be started from the attachment menu (private, groups, supergroups or channels).
Attachment menu integration is currently only available for major advertisers on the Telegram Ad Platform. However, all bots can use it in the test server environment.
To enable this feature for your bot, open @BotFather from an account on the test server and send the /setattach
command – or go to Bot Settings > Configure Attachment Menu. Then specify the URL that will be opened to launch the bot's Web App via its icon in the attachment menu.
NEW You can add a 'Settings' item to the context menu of your Web App using @BotFather. When users select this option from the menu, your bot will receive a settingsButtonClicked
event.
You can add a 'Settings' item to the context menu of your Web App using @BotFather. When users select this option from the menu, your bot will receive a settingsButtonClicked
event.
In addition to the user's theme settings, the bot will receive basic user information (ID
, name
, username
, language_code
, photo
), as well as public info about the chat partner (ID
, name
, username
, photo
) or the chat info (ID
, type
, title
, username
, photo
) and a unique identifier for the web view session query_id, which allows messages of any type to be sent to the chat on behalf of the user that opened the bot.
The bot can call the Bot API method answerWebAppQuery, which sends an inline message from the user via the bot to the chat where it was launched and closes the Web App.
@@ -180,7 +187,7 @@An object with input data transferred to the Web App.
WARNING: Data from this field should not be trusted. You should only use data from initData on the bot's server and only after it has been validated.- @@ -210,17 +217,22 @@version NEW +version String The version of the Bot API available in the user's Telegram app. The height of the visible area of the Web App in its last stable state. Also available in CSS as a variable var(--tg-viewport-stable-height)
.
The application can display just the top part of the Web App, with its lower part remaining outside the screen area. From this position, the user can “pull” the Web App to its maximum height, while the bot can do the same by calling the expand() method. Unlike the value ofviewportHeight
, the value ofviewportStableHeight
does not change as the position of the Web App changes with user gestures or during animations. The value ofviewportStableHeight
will be updated after all gestures and animations are completed and the Web App reaches its final size.
Note the eventviewportChanged
with the passed parameterisStateStable=true
, which will allow you to track when the stable state of the height of the visible area changes.- headerColor NEW +headerColor String Current header color in the #RRGGBB
format.- backgroundColor NEW +backgroundColor String Current background color in the #RRGGBB
format.- +BackButton NEW +isClosingConfirmationEnabled NEW +Boolean +True, if the confirmation dialog is enabled while the user is trying to close the Web App. False, if the confirmation dialog is disabled. ++ @@ -230,26 +242,36 @@BackButton BackButton An object for controlling the back button which can be displayed in the header of the Web App in the Telegram interface. An object for controlling the main button, which is displayed at the bottom of the Web App in the Telegram interface. - HapticFeedback NEW +HapticFeedback HapticFeedback An object for controlling haptic feedback. - isVersionAtLeast(version) NEW +isVersionAtLeast(version) Function Returns true if the user's app supports a version of the Bot API that is equal to or higher than the version passed as the parameter. - setHeaderColor(color) NEW +setHeaderColor(color) Function Bot API 6.1+ A method that sets the app header color. You can only pass Telegram.WebApp.themeParams.bg_color or Telegram.WebApp.themeParams.secondary_bg_color as a color or you can use keywords bg_color, secondary_bg_color instead. - setBackgroundColor(color) NEW +setBackgroundColor(color) Function Bot API 6.1+ A method that sets the app background color in the #RRGGBB
format or you can use keywords bg_color, secondary_bg_color instead.+ +enableClosingConfirmation() NEW +Function +Bot API 6.2+ A method that enables a confirmation dialog while the user is trying to close the Web App. ++ +disableClosingConfirmation() NEW +Function +Bot API 6.2+ A method that disables the confirmation dialog while the user is trying to close the Web App. +onEvent(eventType, eventHandler) Function A method that sets the app event handler. Check the list of available events. @@ -265,21 +287,36 @@A method used to send data to the bot. When this method is called, a service message is sent to the bot containing the data data of the length up to 4096 bytes, and the Web App is closed. See the field web_app_data in the class Message.
This method is only available for Web Apps launched via a Keyboard button.- openLink(url) NEW +openLink(url) Function A method that opens a link in an external browser. The Web App will not be closed.
Note that this method can be called only in response to the user interaction with the Web App interface (e.g. click inside the Web App or on the main button)- openTelegramLink(url) NEW +openTelegramLink(url) Function A method that opens a telegram link inside Telegram app. The Web App will be closed. - openInvoice(url[, callback]) NEW +openInvoice(url[, callback]) Function Bot API 6.1+ A method that opens an invoice using the link url. The Web App will receive the event invoiceClosed when the invoice is closed. If an optional callback parameter was passed, the callback function will be called and the invoice status will be passed as the first argument. + +showPopup(params[, callback]) NEW +Function +Bot API 6.2+ A method that shows a native popup described by the params argument of the type PopupParams. The Web App will receive the event popupClosed when the popup is closed. If an optional callback parameter was passed, the callback function will be called and the field id of the pressed button will be passed as the first argument. ++ +showAlert(message[, callback]) NEW +Function +Bot API 6.2+ A method that shows message in a simple alert with a 'Close' button. If an optional callback parameter was passed, the callback function will be called when the popup is closed. ++ +showConfirm(message[, callback]) NEW +Function +Bot API 6.2+ A method that shows message in a simple confirmation window with 'OK' and 'Cancel' buttons. If an optional callback parameter was passed, the callback function will be called when the popup is closed and the first argument will be a boolean indicating whether the user pressed the 'OK' button. +ready() Function A method that informs the Telegram app that the Web App is ready to be displayed. @@ -338,7 +375,7 @@
It is recommended to call this method as early as possible, as soon as all essential interface elements are loaded. Once this method is called, the loading placeholder is hidden and the Web App is shown.
If the method is not called, the placeholder will be hidden only when the page is fully loaded.Optional. Button text color in the #RRGGBB
format.
Also available as the CSS variablevar(--tg-theme-button-text-color)
.- @@ -348,8 +385,64 @@ +secondary_bg_color NEW +secondary_bg_color String Optional. Bot API 6.1+ Secondary background color in the #RRGGBB
format.
Also available as the CSS variablevar(--tg-theme-secondary-bg-color)
.PopupParams
+NEW This object describes the native popup.
++ +
++ + + +Field +Type +Description ++ +title +String +Optional. The text to be displayed in the popup title, 0-64 characters. ++ +message +String +The message to be displayed in the body of the popup, 1-256 characters. ++ + +buttons +Array of PopupButton +Optional. List of buttons to be displayed in the popup, 1-3 buttons. Set to [{“type”:“close”}] by default. +PopupButton
+NEW This object describes the native popup button.
++ +
+ + + +Field +Type +Description ++ +id +String +Optional. Identifier of the button, 0-64 characters. Set to empty string by default. +
If the button is pressed, its id is returned in the callback and the popupClosed event.+ +type +String +Optional. Type of the button. Set to default by default. +
Can be one of these values:
- default, a button with the default style,
- ok, a button with the localized text “OK”,
- close, a button with the localized text “Close”,
- cancel, a button with the localized text “Cancel”,
- destructive, a button with a style that indicates a destructive action (e.g. “Remove”, “Delete”, etc.).+ + +text +String +Optional. The text to be displayed on the button, 0-64 characters. Required if type is default or destructive. Irrelevant for other types. +BackButton
-NEW This object controls the back button, which can be displayed in the header of the Web App in the Telegram interface.
+This object controls the back button, which can be displayed in the header of the Web App in the Telegram interface.
@@ -439,7 +532,7 @@ A method that sets the button press event handler. An alias for Telegram.WebApp.onEvent('mainButtonClicked', callback)
- @@ -482,7 +575,7 @@offClick(callback) NEW +offClick(callback) Function A method that removes the button press event handler. An alias for Telegram.WebApp.offEvent('mainButtonClicked', callback)
All these methods return the MainButton object so they can be chained.
HapticFeedback
-NEW This object controls haptic feedback.
+This object controls haptic feedback.
@@ -537,7 +630,7 @@ Optional. An object containing data about the chat partner of the current user in the chat where the bot was launched via the attachment menu. Returned only for private chats and only for Web Apps launched via the attachment menu. - @@ -547,7 +640,7 @@chat NEW +chat WebAppChat Optional. An object containing data about the chat where the bot was launched via the attachment menu. Returned for supergroups, channels and group chats – only for Web Apps launched via the attachment menu. Optional. The value of the startattach parameter, passed via link. Only returned for Web Apps when launched from the attachment menu via link.
The value of thestart_param
parameter will also be passed in the GET-parametertgWebAppStartParam
, so the Web App can load the correct interface right away.- @@ -605,6 +698,11 @@can_send_after NEW +can_send_after Integer Optional. Time in seconds, after which a message can be sent via the answerWebAppQuery method. Optional. IETF language tag of the user's language. Returns in user field only. + +is_premium NEW +True +Optional. True, if this user is a Telegram Premium user +photo_url String Optional. URL of the user’s profile photo. The photo can be in .jpeg or .svg formats. Only returned for Web Apps launched from the attachment menu. @@ -612,7 +710,7 @@WebAppChat
-NEW This object represents a chat.
+This object represents a chat.
@@ -684,17 +782,21 @@ if (hex(HMAC_SHA256(data_check_string, secret_key)) == hash) { Occurs when the main button is pressed.
eventHandler receives no parameters.- + backButtonClicked
NEWbackButtonClicked
Bot API 6.1+ Occurrs when the back button is pressed.
eventHandler receives no parameters.- + settingsButtonClicked
NEWsettingsButtonClicked
Bot API 6.1+ Occurrs when the Settings item in context menu is pressed.
eventHandler receives no parameters.- ++ invoiceClosed
NEWinvoiceClosed
Bot API 6.1+ Occurrs when the opened invoice is closed.
eventHandler receives an object with the two fields: url – invoice link provided and status – one of the invoice statuses:
- paid – invoice was paid successfully,
- cancelled – user closed this invoice without paying,
- failed – user tried to pay, but the payment was failed,
- pending – the payment is still processing. The bot will receive a service message about a successful payment when the payment is successfully paid.+ + popupClosed
NEWBot API 6.2+ Occurrs when the opened popup is closed. +
eventHandler receives an object with the single field button_id – the value of the field id of the pressed button. If no buttons were pressed, the field button_id will be null.Adding Bots to the Attachment Menu
diff --git a/data/web/blogfork.telegram.org/stickers.html b/data/web/blogfork.telegram.org/stickers.html index 313616c539..7f1483eecc 100644 --- a/data/web/blogfork.telegram.org/stickers.html +++ b/data/web/blogfork.telegram.org/stickers.html @@ -134,7 +134,7 @@
As of version 8.9 released in July 2022, Telegram apps support custom emoji.
Emoji use the same technology as stickers, making it very easy to convert your art to both formats. Check out the video and image sections for details on the different size requirements.
To upload them, use the /newemojipack
command in @Stickers.
As of version 8.9 released in August 2022, Telegram apps support custom emoji.
Emoji use the same technology as stickers, making it very easy to convert your art to both formats. Check out the video and image sections for details on the different size requirements.
To upload them, use the /newemojipack
command in @Stickers.
diff --git a/data/web/core.telegram.org/bots/webapps.html b/data/web/core.telegram.org/bots/webapps.html index 715de93c27..eff53a8588 100644 --- a/data/web/core.telegram.org/bots/webapps.html +++ b/data/web/core.telegram.org/bots/webapps.html @@ -57,6 +57,13 @@Everyone can create new custom emoji, however, adding and using custom sets is currently an exclusive feature of Telegram Premium users.
Bot API 6.2
+Bot API 6.1
-TL;DR: Web App Bots can request to be added directly to a user's attachment menu, allowing them to be quickly launched from any chat. To try this mode, open this attachment menu link for @DurgerKingBot, then use the menu in any type of chat.
Web App Bots can request to be added directly to a user's attachment menu, allowing them to be quickly launched from any type of chat. NEW You can configure in which types of chats your web app can be started from the attachment menu (private, groups, supergroups or channels).
+Web App Bots can request to be added directly to a user's attachment menu, allowing them to be quickly launched from any type of chat. You can configure in which types of chats your web app can be started from the attachment menu (private, groups, supergroups or channels).
Attachment menu integration is currently only available for major advertisers on the Telegram Ad Platform. However, all bots can use it in the test server environment.
To enable this feature for your bot, open @BotFather from an account on the test server and send the /setattach
command – or go to Bot Settings > Configure Attachment Menu. Then specify the URL that will be opened to launch the bot's Web App via its icon in the attachment menu.
NEW You can add a 'Settings' item to the context menu of your Web App using @BotFather. When users select this option from the menu, your bot will receive a settingsButtonClicked
event.
You can add a 'Settings' item to the context menu of your Web App using @BotFather. When users select this option from the menu, your bot will receive a settingsButtonClicked
event.
In addition to the user's theme settings, the bot will receive basic user information (ID
, name
, username
, language_code
, photo
), as well as public info about the chat partner (ID
, name
, username
, photo
) or the chat info (ID
, type
, title
, username
, photo
) and a unique identifier for the web view session query_id, which allows messages of any type to be sent to the chat on behalf of the user that opened the bot.
The bot can call the Bot API method answerWebAppQuery, which sends an inline message from the user via the bot to the chat where it was launched and closes the Web App.
@@ -180,7 +187,7 @@An object with input data transferred to the Web App.
WARNING: Data from this field should not be trusted. You should only use data from initData on the bot's server and only after it has been validated.- @@ -210,17 +217,22 @@version NEW +version String The version of the Bot API available in the user's Telegram app. The height of the visible area of the Web App in its last stable state. Also available in CSS as a variable var(--tg-viewport-stable-height)
.
The application can display just the top part of the Web App, with its lower part remaining outside the screen area. From this position, the user can “pull” the Web App to its maximum height, while the bot can do the same by calling the expand() method. Unlike the value ofviewportHeight
, the value ofviewportStableHeight
does not change as the position of the Web App changes with user gestures or during animations. The value ofviewportStableHeight
will be updated after all gestures and animations are completed and the Web App reaches its final size.
Note the eventviewportChanged
with the passed parameterisStateStable=true
, which will allow you to track when the stable state of the height of the visible area changes.- headerColor NEW +headerColor String Current header color in the #RRGGBB
format.- backgroundColor NEW +backgroundColor String Current background color in the #RRGGBB
format.- +BackButton NEW +isClosingConfirmationEnabled NEW +Boolean +True, if the confirmation dialog is enabled while the user is trying to close the Web App. False, if the confirmation dialog is disabled. ++ @@ -230,26 +242,36 @@BackButton BackButton An object for controlling the back button which can be displayed in the header of the Web App in the Telegram interface. An object for controlling the main button, which is displayed at the bottom of the Web App in the Telegram interface. - HapticFeedback NEW +HapticFeedback HapticFeedback An object for controlling haptic feedback. - isVersionAtLeast(version) NEW +isVersionAtLeast(version) Function Returns true if the user's app supports a version of the Bot API that is equal to or higher than the version passed as the parameter. - setHeaderColor(color) NEW +setHeaderColor(color) Function Bot API 6.1+ A method that sets the app header color. You can only pass Telegram.WebApp.themeParams.bg_color or Telegram.WebApp.themeParams.secondary_bg_color as a color or you can use keywords bg_color, secondary_bg_color instead. - setBackgroundColor(color) NEW +setBackgroundColor(color) Function Bot API 6.1+ A method that sets the app background color in the #RRGGBB
format or you can use keywords bg_color, secondary_bg_color instead.+ +enableClosingConfirmation() NEW +Function +Bot API 6.2+ A method that enables a confirmation dialog while the user is trying to close the Web App. ++ +disableClosingConfirmation() NEW +Function +Bot API 6.2+ A method that disables the confirmation dialog while the user is trying to close the Web App. +onEvent(eventType, eventHandler) Function A method that sets the app event handler. Check the list of available events. @@ -265,21 +287,36 @@A method used to send data to the bot. When this method is called, a service message is sent to the bot containing the data data of the length up to 4096 bytes, and the Web App is closed. See the field web_app_data in the class Message.
This method is only available for Web Apps launched via a Keyboard button.- openLink(url) NEW +openLink(url) Function A method that opens a link in an external browser. The Web App will not be closed.
Note that this method can be called only in response to the user interaction with the Web App interface (e.g. click inside the Web App or on the main button)- openTelegramLink(url) NEW +openTelegramLink(url) Function A method that opens a telegram link inside Telegram app. The Web App will be closed. - openInvoice(url[, callback]) NEW +openInvoice(url[, callback]) Function Bot API 6.1+ A method that opens an invoice using the link url. The Web App will receive the event invoiceClosed when the invoice is closed. If an optional callback parameter was passed, the callback function will be called and the invoice status will be passed as the first argument. + +showPopup(params[, callback]) NEW +Function +Bot API 6.2+ A method that shows a native popup described by the params argument of the type PopupParams. The Web App will receive the event popupClosed when the popup is closed. If an optional callback parameter was passed, the callback function will be called and the field id of the pressed button will be passed as the first argument. ++ +showAlert(message[, callback]) NEW +Function +Bot API 6.2+ A method that shows message in a simple alert with a 'Close' button. If an optional callback parameter was passed, the callback function will be called when the popup is closed. ++ +showConfirm(message[, callback]) NEW +Function +Bot API 6.2+ A method that shows message in a simple confirmation window with 'OK' and 'Cancel' buttons. If an optional callback parameter was passed, the callback function will be called when the popup is closed and the first argument will be a boolean indicating whether the user pressed the 'OK' button. +ready() Function A method that informs the Telegram app that the Web App is ready to be displayed. @@ -338,7 +375,7 @@
It is recommended to call this method as early as possible, as soon as all essential interface elements are loaded. Once this method is called, the loading placeholder is hidden and the Web App is shown.
If the method is not called, the placeholder will be hidden only when the page is fully loaded.Optional. Button text color in the #RRGGBB
format.
Also available as the CSS variablevar(--tg-theme-button-text-color)
.- @@ -348,8 +385,64 @@ +secondary_bg_color NEW +secondary_bg_color String Optional. Bot API 6.1+ Secondary background color in the #RRGGBB
format.
Also available as the CSS variablevar(--tg-theme-secondary-bg-color)
.PopupParams
+NEW This object describes the native popup.
++ +
++ + + +Field +Type +Description ++ +title +String +Optional. The text to be displayed in the popup title, 0-64 characters. ++ +message +String +The message to be displayed in the body of the popup, 1-256 characters. ++ + +buttons +Array of PopupButton +Optional. List of buttons to be displayed in the popup, 1-3 buttons. Set to [{“type”:“close”}] by default. +PopupButton
+NEW This object describes the native popup button.
++ +
+ + + +Field +Type +Description ++ +id +String +Optional. Identifier of the button, 0-64 characters. Set to empty string by default. +
If the button is pressed, its id is returned in the callback and the popupClosed event.+ +type +String +Optional. Type of the button. Set to default by default. +
Can be one of these values:
- default, a button with the default style,
- ok, a button with the localized text “OK”,
- close, a button with the localized text “Close”,
- cancel, a button with the localized text “Cancel”,
- destructive, a button with a style that indicates a destructive action (e.g. “Remove”, “Delete”, etc.).+ + +text +String +Optional. The text to be displayed on the button, 0-64 characters. Required if type is default or destructive. Irrelevant for other types. +BackButton
-NEW This object controls the back button, which can be displayed in the header of the Web App in the Telegram interface.
+This object controls the back button, which can be displayed in the header of the Web App in the Telegram interface.
@@ -439,7 +532,7 @@ A method that sets the button press event handler. An alias for Telegram.WebApp.onEvent('mainButtonClicked', callback)
- @@ -482,7 +575,7 @@offClick(callback) NEW +offClick(callback) Function A method that removes the button press event handler. An alias for Telegram.WebApp.offEvent('mainButtonClicked', callback)
All these methods return the MainButton object so they can be chained.
HapticFeedback
-NEW This object controls haptic feedback.
+This object controls haptic feedback.
@@ -537,7 +630,7 @@ Optional. An object containing data about the chat partner of the current user in the chat where the bot was launched via the attachment menu. Returned only for private chats and only for Web Apps launched via the attachment menu. - @@ -547,7 +640,7 @@chat NEW +chat WebAppChat Optional. An object containing data about the chat where the bot was launched via the attachment menu. Returned for supergroups, channels and group chats – only for Web Apps launched via the attachment menu. Optional. The value of the startattach parameter, passed via link. Only returned for Web Apps when launched from the attachment menu via link.
The value of thestart_param
parameter will also be passed in the GET-parametertgWebAppStartParam
, so the Web App can load the correct interface right away.- @@ -605,6 +698,11 @@can_send_after NEW +can_send_after Integer Optional. Time in seconds, after which a message can be sent via the answerWebAppQuery method. Optional. IETF language tag of the user's language. Returns in user field only. + +is_premium NEW +True +Optional. True, if this user is a Telegram Premium user +photo_url String Optional. URL of the user’s profile photo. The photo can be in .jpeg or .svg formats. Only returned for Web Apps launched from the attachment menu. @@ -612,7 +710,7 @@WebAppChat
-NEW This object represents a chat.
+This object represents a chat.
@@ -684,17 +782,21 @@ if (hex(HMAC_SHA256(data_check_string, secret_key)) == hash) { Occurs when the main button is pressed.
eventHandler receives no parameters.- + backButtonClicked
NEWbackButtonClicked
Bot API 6.1+ Occurrs when the back button is pressed.
eventHandler receives no parameters.- + settingsButtonClicked
NEWsettingsButtonClicked
Bot API 6.1+ Occurrs when the Settings item in context menu is pressed.
eventHandler receives no parameters.- ++ invoiceClosed
NEWinvoiceClosed
Bot API 6.1+ Occurrs when the opened invoice is closed.
eventHandler receives an object with the two fields: url – invoice link provided and status – one of the invoice statuses:
- paid – invoice was paid successfully,
- cancelled – user closed this invoice without paying,
- failed – user tried to pay, but the payment was failed,
- pending – the payment is still processing. The bot will receive a service message about a successful payment when the payment is successfully paid.+ + popupClosed
NEWBot API 6.2+ Occurrs when the opened popup is closed. +
eventHandler receives an object with the single field button_id – the value of the field id of the pressed button. If no buttons were pressed, the field button_id will be null.Adding Bots to the Attachment Menu
diff --git a/data/web/core.telegram.org/stickers.html b/data/web/core.telegram.org/stickers.html index 313616c539..7f1483eecc 100644 --- a/data/web/core.telegram.org/stickers.html +++ b/data/web/core.telegram.org/stickers.html @@ -134,7 +134,7 @@
As of version 8.9 released in July 2022, Telegram apps support custom emoji.
Emoji use the same technology as stickers, making it very easy to convert your art to both formats. Check out the video and image sections for details on the different size requirements.
To upload them, use the /newemojipack
command in @Stickers.
As of version 8.9 released in August 2022, Telegram apps support custom emoji.
Emoji use the same technology as stickers, making it very easy to convert your art to both formats. Check out the video and image sections for details on the different size requirements.
To upload them, use the /newemojipack
command in @Stickers.
diff --git a/data/web/corefork.telegram.org/stickers.html b/data/web/corefork.telegram.org/stickers.html index 2494173b8f..cadc7c9806 100644 --- a/data/web/corefork.telegram.org/stickers.html +++ b/data/web/corefork.telegram.org/stickers.html @@ -134,7 +134,7 @@Everyone can create new custom emoji, however, adding and using custom sets is currently an exclusive feature of Telegram Premium users.
For more info about using the @Stickers bot, click here.
As of version 8.9 released in July 2022, Telegram apps support custom emoji.
Emoji use the same technology as stickers, making it very easy to convert your art to both formats. Check out the video and image sections for details on the different size requirements.
To upload them, use the /newemojipack
command in @Stickers.
As of version 8.9 released in August 2022, Telegram apps support custom emoji.
Emoji use the same technology as stickers, making it very easy to convert your art to both formats. Check out the video and image sections for details on the different size requirements.
To upload them, use the /newemojipack
command in @Stickers.
diff --git a/data/web/telegram.org/faq_premium.html b/data/web/telegram.org/faq_premium.html index 8701649cfb..016fef9bf7 100644 --- a/data/web/telegram.org/faq_premium.html +++ b/data/web/telegram.org/faq_premium.html @@ -2,12 +2,13 @@ -Everyone can create new custom emoji, however, adding and using custom sets is currently an exclusive feature of Telegram Premium users.
a new era of messaging
-++This FAQ covers the main questions about Telegram Premium.
+
Check out our Premium Terms of Service for more information, as well as our Basic FAQ for general questions about Telegram.
General
Features
Availability
Payments
Cancellation
Privacy and Data
Telegram Premium is an optional subscription service that unlocks additional exclusive features, while helping support the development of the app. It is a part of Telegram’s sustainable monetization – driven by our users, rather than advertisers or shareholders. This way, Telegram can remain independent and prioritize its users first.
++ ++
At the moment, all Premium users receive:
+++The @Premium channel contains detailed descriptions of each feature, as well as a list of all Premium stickers.
+
Users can subscribe via the App Store, Google Play (Telegram Settings > Telegram Premium) or @PremiumBot. Subscribing via the bot gives users a discounted price, because the payments are not subject to fees from Apple or Google.
+++@PremiumBot is currently accessible from the direct versions of Telegram's Android, Desktop and macOS apps.
+
Yes! All features that existed before Telegram Premium was introduced remain free to use – including unlimited cloud storage, large groups and channels, voice and video calls, support for multiple devices and accounts, tens of thousands of stickers and countless other features. Moreover, future Telegram updates will continue to add new features for all users.
+There are no restrictions for non-Premium users. On the contrary, many premium features also benefit free users. For example, anyone can download 4 GB files uploaded by premium users, watch the animations of premium stickers, or tap to increase the count of exclusive reactions already added by premium users.
+++The full list of premium features is available on the @Premium channel.
+
Yes, users who do not subscribe will still continue to receive many new features. Telegram Premium allows us to offer all the resource-heavy features users have asked for over the years, while preserving free access to the most powerful messenger on the planet.
+If you subscribe to Telegram Premium, your account gains access to all available premium features. Some clients may not immediately support one or several of these features – to take full advantage of your subscription, consider using one of our official apps, such as Telegram for Android, iOS, Desktop and MacOS.
+Subscribing lifts any media download speed limits from your account on Telegram’s side. If your download speed does not increase, you may be facing other limits caused by your hardware, internet provider, etc.
+++See our Terms of Service for a more detailed explanation.
+
The badge is currently visible next to the names of all Telegram Premium subscribers.
+Some premium features can be accessed by users who did not subscribe, provided that a subscriber uses them first. For example, if you subscribe and add a premium reaction to a message, your friends can add reactions of the same type to that message. This also applies to files: any user can download large 2+ GB files uploaded by premium users.
+Official Sponsored Messages are minimalist, non-targeted advertisements that Telegram may show in some large, public one-to-many channels that have a high number of subscribers. These advertisements will be hidden for users that subscribe to Telegram Premium.
+Channel admins may independently post promotional content via messages or media in their communities – this is outside Telegram’s control, and would still appear for Premium users.
+++See our Terms of Service for a detailed explanation.
+
Yes, you can subscribe to Telegram Premium from any app or platform you prefer – even if you don’t use that particular device very often. Premium features sync across your entire account, and are available on all your devices.
+++Subscribing via @PremiumBot in Direct Apps is cheaper than signing up via Google Play or the App Store.
+
No. A single Google account/Apple ID only supports one ongoing subscription at any given time. For more accounts, you can use @PremiumBot on a supported app to buy additional subscriptions.
+It’s possible that local laws and regulations prevent people from accessing Telegram Premium in your country. It’s also possible that your country isn’t supported by the payment processors Telegram relies on. In either case, we continue to do our best to keep all Telegram services available for everyone.
+This is due to two possible reasons – either Telegram Premium is not available in your country, or your app was downloaded from the App Store or Google Play, and therefore does not support @PremiumBot.
+Telegram Premium features are currently supported by Telegram for Android, iOS and macOS, as well as Telegram Desktop and Telegram Web. Other clients, such as Telegram X or third-party apps may not support some Premium features at the moment.
+If you use several accounts, Premium applies only to your accounts that have a subscription – however, those accounts will be able to use Premium features on any connected devices.
+This is currently not possible, however, you can freely change the number associated with your account without losing your subscription.
+Premium features are currently tied to individual users, and can be utilized in any chat – benefiting not only the Premium user, but also their contacts and subscribers. That said, future developments for Telegram Premium could include community-focused options.
+Premium bots are currently not supported. Telegram evolves quickly, be sure to follow our blog to find out if this feature becomes available in the future.
+When subscribing via @PremiumBot, the currency and price of your first month of Premium is based on the phone number of your Telegram account. After this initial payment, all future payments are calculated for the default currency of your payment method.
+In order to qualify for localized pricing, your payment method must be issued by a financial institution in that country and have a local billing address.
+If you subscribe via the Play Store or App Store, your currency will be based off your account with Google or Apple.
+We do our best to keep the cost of Telegram Premium as consistent as possible – this may include slight variations to reflect local living standards and keep Telegram Premium obtainable for everyone. When you subscribe, the price you see may include store or third-party fees, local taxes and any other applicable fees that are outside of Telegram’s control.
+Telegram works with payment providers and app stores to provide a wide range of supported payment methods. If your payment method is not available, you should consider trying all available subscription options: the premium subscription will apply to all supported apps regardless of which one was used to subscribe.
+Yes – if you open a user’s profile, you’ll see a 'Gift Premium' button under or to send them a prepaid subscription for 3, 6 or 12 months.
+You can cancel your premium subscription via the same provider you used to purchase it.
+/stop
command.Telegram Premium purchases are handled by third-parties (e.g. @PremiumBot, Google Play, Apple App Store).
+When you cancel your subscription, all future payments for Telegram Premium are also canceled. You will still have access to all your Premium features until the end of the current billing period, after which they will expire.
+Once your subscription expires, your features will be revoked as follows:
+All free functionality will remain exactly as it was before subscribing.
+You can freely change the phone number associated with your account without losing your subscription – the subscription is linked to your Telegram account, not to your phone number.
+Uninstalling Telegram does not cancel your subscription – it will remain available on any device at any time. Note that uninstalling the app or not opening it for some time does not pause your subscription, and you will be billed on its original renewal date.
+If you subscribe via @PremiumBot, deleting your account will terminate your recurring payments, as the Bot will not be able to charge an account that no longer exists. It will not be possible to refund any ‘unused’ portion of your billing period.
+If you subscribe to Premium via the App Store or Google Play, you will need to cancel your subscription through your Apple or Google account settings – as these platforms may continue to charge you, even if you deleted your Telegram account or application.
+Telegram Premium does not come with any special treatment – if you don’t play nice, Telegram may limit some of the functionalities available to you, including your access to the Telegram platform. Therefore, if you violate our Terms of Service and receive a ban, you might lose the benefits of Telegram Premium and we will not compensate you for this loss.
+++Check out our full privacy policy for more details.
+
No, Telegram does not store your credit card information. You purchase a premium subscription via a third-party (e.g. Google Play, Apple App Store, or a payment provider via bots like @PremiumBot), so you additionally agree to their terms of service and you should check their individual privacy policies.
+Telegram only requires a phone number to sign up and access all of its functionality. Subscribing to Telegram Premium additionally requires that a user provide a payment method, which is directly transferred to a third-party payment processor. Any personal details from your payment method never reach Telegram’s servers, and are securely processed solely by the payment provider.
+No, payment processors cannot access your Telegram activity in any way.
+Other users will see that you are subscribed by your Telegram Premium badge.
They will not be able to see how you subscribed or how much you spent.