Giveaway

^{ref / types / Giveaway}

This object represents a message about a scheduled giveaway.

^Source

Properties

chats

chats: Chat[];

The list of chats which the user must join to participate in the giveaway

^Source

winners_selection_date

winners_selection_date: number;

Point in time (Unix timestamp) when winners of the giveaway will be selected

^Source

winner_count

winner_count: number;

The number of users which are supposed to be selected as winners of the giveaway

^Source

only_new_members

only_new_members?: true;

True, if only users who join the chats after the giveaway started should be eligible to win

^Source

has_public_winners

has_public_winners?: true;

True, if the list of giveaway winners will be visible to everyone

^Source

prize_description

prize_description?: string;

Description of additional giveaway prize

^Source

country_codes

country_codes?: string[];

A list of two-letter ISO 3166-1 alpha-2 country codes indicating the countries from which eligible users for the giveaway must come. If empty, then all users can participate in the giveaway. Users with a phone number that was bought on Fragment can always participate in giveaways.

^Source

prize_star_count

prize_star_count?: number;

The number of Telegram Stars to be split between giveaway winners; for Telegram Star giveaways only

^Source

premium_subscription_month_count

premium_subscription_month_count?: number;

The number of months the Telegram Premium subscription won from the giveaway will be active for; for Telegram Premium giveaways only

^Source