From 9feae224aa30b136c0844a5f0868c238a10ad28d Mon Sep 17 00:00:00 2001 From: GitHub Action Date: Tue, 25 Jun 2024 21:18:05 +0000 Subject: [PATCH] Update content of files --- .../corefork.telegram.org/api/giveaways.html | 28 +- .../constructor/boost.html | 4 +- .../inputStorePaymentPremiumGiftCode.html | 2 +- .../constructor/messageActionGiftCode.html | 4 +- .../constructor/premium.boostsStatus.html | 8 +- .../mtproto/samples-auth_key.html | 412 +++++++++--------- 6 files changed, 229 insertions(+), 229 deletions(-) diff --git a/data/web/corefork.telegram.org/api/giveaways.html b/data/web/corefork.telegram.org/api/giveaways.html index 984f2498c1..dbefd7b23a 100644 --- a/data/web/corefork.telegram.org/api/giveaways.html +++ b/data/web/corefork.telegram.org/api/giveaways.html @@ -4,10 +4,10 @@ Giveaways - + - + @@ -44,7 +44,7 @@
-

Telegram channel administrators may launch giveaways to randomly distribute Telegram Premium subscriptions and other gifts among their followers, in exchange for boosts.

+

Telegram channel and supergroup administrators may launch giveaways to randomly distribute Telegram Premium subscriptions and other gifts among their followers, in exchange for boosts.

This functionality should only be enabled if the giveaway_gifts_purchase_available config value is set to true.

Note that the flow described below can also be used to gift a Premium subscriptions to multiple friends, and is different from the old gift flow, which allowed gifting only one subscription with some extra limitations, not present in this flow.

Note that premium multigift links lead to a page that uses the new gift flow described below.

@@ -89,12 +89,12 @@

First of all, invoke payments.getPremiumGiftCodeOptions to obtain a list of premiumGiftCodeOption constructors, containing a list of giveaway options that may be chosen by the admin, indicating the number and duration of the of Telegram Premium subscriptions that will be gifted in the giveaway, along with their price (amount) in the specified currency (see the constructor page » for more info on these fields).

Once the admin has chosen a specific gift code option, invoke payments.getPaymentForm, passing an inputInvoicePremiumGiftCode, with the chosen premiumGiftCodeOption in option and a purpose containing either:

Then, follow the invoice payment flow as described in the payments documentation ».

@@ -110,15 +110,15 @@ Users may also use this method to simply gift subscriptions to contacts by If the payment was made using the payments.getPaymentForm or payments.assignAppStoreTransaction/payments.assignPlayMarketTransaction payment flows, the giveaway will launch as soon as the payment is complete.

  • -

    Otherwise, if the Premium bot or Fragment flows were used, once the payment for the giveaway is made, invoke premium.getBoostsStatus, passing to peer the ID of the channel that we selected when paying for the giveaway, to obtain a prepaidGiveaway constructor in premium.boostsStatus.prepaid_giveaways, containing info about the prepaid giveaway.

    -

    To actually launch the giveaway for the Fragment and bot flows, invoke payments.launchPrepaidGiveaway, passing prepaidGiveaway.id to giveaway_id, the ID of the channel to peer and giveaway settings in purpose (populated as specified above).

    +

    Otherwise, if the Premium bot or Fragment flows were used, once the payment for the giveaway is made, invoke premium.getBoostsStatus, passing to peer the ID of the channel/supergroup that we selected when paying for the giveaway, to obtain a prepaidGiveaway constructor in premium.boostsStatus.prepaid_giveaways, containing info about the prepaid giveaway.

    +

    To actually launch the giveaway for the Fragment and bot flows, invoke payments.launchPrepaidGiveaway, passing prepaidGiveaway.id to giveaway_id, the ID of the channel/supergroup to peer and giveaway settings in purpose (populated as specified above).

  • Finally:

    • -

      If the payment succeeds and we're launching a giveaway using inputStorePaymentPremiumGiveaway: a messageActionGiveawayLaunch service message and a media message containing a messageMediaGiveaway will be sent to the channel.

      -

      Once the giveaway is over, a messageActionGiveawayResults will be sent to the channel and the winners will automatically receive a messageActionGiftCode service message from Telegram's service user, containing the slug that can be used to generate a giftcode link to redeem the Premium subscription.
      +

      If the payment succeeds and we're launching a giveaway using inputStorePaymentPremiumGiveaway: a messageActionGiveawayLaunch service message and a media message containing a messageMediaGiveaway will be sent to the channel/supergroup.

      +

      Once the giveaway is over, a messageActionGiveawayResults will be sent to the channel/supergroup and the winners will automatically receive a messageActionGiftCode service message from Telegram's service user, containing the slug that can be used to generate a giftcode link to redeem the Premium subscription.
      The messageActionGiftCode.via_giveaway flag will be set.

    • @@ -129,9 +129,9 @@ Clients should display this message, along with a sticker from the messageActionGiftCode.slug should be used to generate a giftcode link, that the user can use to redeem the subscription, or re-gift it to someone else.

      -

      If winners_are_visible flag is set while starting a giveaway, giveaway winners are public and will be listed in a messageMediaGiveawayResults message that will be automatically sent to the channel once the giveaway ends.

      -

      Any user can invoke payments.checkGiftCode with the link's slug to obtain info about the giveaway, such as the channel that gifted the subscription (from_id), and the user that originally received the gift (to_id).
      -This can also be useful to channel administrators to precisely determine the winners of a giveaway, for example if the giveaway also included some extra gifts apart from Premium subscriptions (like Teslas): the winners can simply send their link as undisputable proof that they won the giveaway, because the user that received the gift can be viewed in the to_id field returned by Telegram when invoking payments.checkGiftCode on the slug.
      +

      If winners_are_visible flag is set while starting a giveaway, giveaway winners are public and will be listed in a messageMediaGiveawayResults message that will be automatically sent to the channel/supergroup once the giveaway ends.

      +

      Any user can invoke payments.checkGiftCode with the link's slug to obtain info about the giveaway, such as the channel/supergroup that gifted the subscription (from_id), and the user that originally received the gift (to_id).
      +This can also be useful to channel/supergroup administrators to precisely determine the winners of a giveaway, for example if the giveaway also included some extra gifts apart from Premium subscriptions (like Teslas): the winners can simply send their link as undisputable proof that they won the giveaway, because the user that received the gift can be viewed in the to_id field returned by Telegram when invoking payments.checkGiftCode on the slug.
      Another way for admins to check who received the gifts is to simply use premium.getBoostsList while the boosts received by the gifts are still active.

      To claim the Telegram Premium subscription, simply invoke payments.applyGiftCode, passing the link's slug.

    diff --git a/data/web/corefork.telegram.org/constructor/boost.html b/data/web/corefork.telegram.org/constructor/boost.html index 0795b89660..6f1bf00cdd 100644 --- a/data/web/corefork.telegram.org/constructor/boost.html +++ b/data/web/corefork.telegram.org/constructor/boost.html @@ -74,12 +74,12 @@ gift flags.1?true -Whether this boost was applied because the channel directly gifted a subscription to the user. +Whether this boost was applied because the channel/supergroup directly gifted a subscription to the user. giveaway flags.2?true -Whether this boost was applied because the user was chosen in a giveaway started by the channel. +Whether this boost was applied because the user was chosen in a giveaway started by the channel/supergroup. unclaimed diff --git a/data/web/corefork.telegram.org/constructor/inputStorePaymentPremiumGiftCode.html b/data/web/corefork.telegram.org/constructor/inputStorePaymentPremiumGiftCode.html index 9264c5f962..fc907efb3a 100644 --- a/data/web/corefork.telegram.org/constructor/inputStorePaymentPremiumGiftCode.html +++ b/data/web/corefork.telegram.org/constructor/inputStorePaymentPremiumGiftCode.html @@ -42,7 +42,7 @@

    inputStorePaymentPremiumGiftCode

    -

    Used to gift Telegram Premium subscriptions only to some specific subscribers of a channel or to some of our contacts, see here » for more info on giveaways and gifts.

    +

    Used to gift Telegram Premium subscriptions only to some specific subscribers of a channel/supergroup or to some of our contacts, see here » for more info on giveaways and gifts.