Telegram channel administrators may launch giveaways to randomly distribute Telegram Premium subscriptions and other gifts among their followers, in exchange for boosts.
+Telegram channel administrators may launch giveaways to randomly distribute Telegram Premium subscriptions and other gifts among their followers, in exchange for boosts.
Schema:
premiumGiftCodeOption#257e962b flags:# users:int months:int store_product:flags.0?string store_quantity:flags.1?int currency:string amount:long = PremiumGiftCodeOption;
@@ -89,8 +89,8 @@
Additional channels that the user must join to participate to the giveaway can be specified in additional_peers.
The set of users that can participate to the giveaway can be restricted by passing an explicit whitelist of up to giveaway_countries_max countries, specified as two-letter ISO 3166-1 alpha-2 country codes in countries_iso2.
The end date of the giveaway must be specified in until_date; at that date, Telegram will randomly choose option.users subscribers according to the conditions specified above, and send them a Telegram Premium giftcode as a messageActionGiftCode constructor, that should be used client-side to generate a giftcode link .
-The channel specified in boost_peer will receive giveaway_boosts_per_premium boosts from each user, that cannot be reassigned to another channel for the duration of the gifted subscription.
-or inputStorePaymentPremiumGiftCode, to gift Telegram Premium subscriptions only to some specific subscribers (purpose.users) of the channel specified in purpose.boost_peer, which will receive giveaway_boosts_per_premium boosts from each user, that cannot be reassigned to another channel for the duration of the gifted subscription.
+The channel specified in boost_peer will receive giveaway_boosts_per_premium boosts from each user, that cannot be reassigned to another channel for the duration of the gifted subscription.
+or inputStorePaymentPremiumGiftCode, to gift Telegram Premium subscriptions only to some specific subscribers (purpose.users) of the channel specified in purpose.boost_peer, which will receive giveaway_boosts_per_premium boosts from each user, that cannot be reassigned to another channel for the duration of the gifted subscription.
Then, follow the invoice payment flow as described in the payments documentation ยป.
Two alternative payment flows are also available, offering more affordable pricing:
@@ -115,7 +115,7 @@ The messageActionGiftCode.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.
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.
-To claim the Telegram Premium subscription, simply invoke payments.applyGiftCode.
To claim the Telegram Premium subscription, simply invoke payments.applyGiftCode, passing the link's slug.