Contains a Telegram Premium giftcode link.
Constructor schema is available as of layer 168. Switch »| Name | Type | Description |
|---|---|---|
| flags | # | Flags, see TL conditional fields |
| via_giveaway | flags.0?true | If set, this gift code was received from a giveaway » started by a channel/supergroup we're subscribed to. |
| unclaimed | flags.2?true | If set, the link was not redeemed yet. |
| boost_peer | flags.1?Peer | Identifier of the channel/supergroup that created the gift code either directly or through a giveaway: if we import this giftcode link, we will also automatically boost this channel/supergroup. |
| months | int | Duration in months of the gifted Telegram Premium subscription. |
| slug | string | Slug of the Telegram Premium giftcode link |
| currency | flags.2?string | Three-letter ISO 4217 currency code |
| amount | flags.2?long | Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). |
| crypto_currency | flags.3?string | If set, the gift was made using the specified cryptocurrency. |
| crypto_amount | flags.3?long | If crypto_currency is set, contains the paid amount, in the smallest units of the cryptocurrency. |
| message | flags.4?TextWithEntities | Message attached with the gift |
Telegram channel and supergroup administrators may launch giveaways to randomly distribute Telegram Premium subscriptions and other gifts among their followers, in exchange for boosts.
Telegram clients must handle special tg:// and t.me deep links encountered in messages, link entities and in other apps by registering OS handlers.
Telegram Premium users can grant their favorite channels and supergroups additional features like the ability to post stories by giving them boosts.
Telegram Premium is an optional subscription service that unlocks additional exclusive client-side and API-side features, while helping support the development of the app.