Contains info about a giveaway, see here » for more info.
Constructor schema is available as of layer 168. Switch »| Name | Type | Description |
|---|---|---|
| flags | # | Flags, see TL conditional fields |
| only_new_subscribers | flags.0?true | If set, only new subscribers starting from the giveaway creation date will be able to participate to the giveaway. |
| winners_are_visible | flags.2?true | If set, giveaway winners are public and will be listed in a messageMediaGiveawayResults message that will be automatically sent to the channel once the giveaway ends. |
| channels | Vector<long> | The channels that the user must join to participate in the giveaway. |
| countries_iso2 | flags.1?Vector<string> | If set, only users residing in these countries can participate in the giveaway, (specified as a list of two-letter ISO 3166-1 alpha-2 country codes); otherwise there are no country-based limitations. |
| prize_description | flags.3?string | Can contain a textual description of additional giveaway prizes. |
| quantity | int | Number of Telegram Premium subscriptions given away. |
| months | flags.4?int | Duration in months of each Telegram Premium subscription in the giveaway. |
| stars | flags.5?long | For Telegram Star giveaways, the total number of Telegram Stars being given away. |
| until_date | int | The end date of the giveaway. |
A giveaway with public winners has finished, this constructor contains info about the winners.
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.
Telegram Stars are virtual items that allow users to purchase digital goods and services from bots and mini apps inside the Telegram ecosystem, send gifts to content creators on the Telegram platform, and more.
Telegram channel and supergroup administrators may launch giveaways to randomly distribute Telegram Premium subscriptions and other gifts among their followers, in exchange for boosts.