Giveaway

Raw MD
This object represents a message about a scheduled giveaway

This object represents a message about a scheduled giveaway.

Fields

FieldTypeRequiredDescription
chatsArray of ChatAlwaysThe list of chats which the user must join to participate in the giveaway
winners_selection_dateIntegerAlwaysPoint in time (Unix timestamp) when winners of the giveaway will be selected
winner_countIntegerAlwaysThe number of users which are supposed to be selected as winners of the giveaway
only_new_membersTrueOptionalTrue, if only users who join the chats after the giveaway started should be eligible to win
has_public_winnersTrueOptionalTrue, if the list of giveaway winners will be visible to everyone
prize_descriptionStringOptionalDescription of additional giveaway prize
country_codesArray of StringOptionalA 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.
prize_star_countIntegerOptionalThe number of Telegram Stars to be split between giveaway winners; for Telegram Star giveaways only
premium_subscription_month_countIntegerOptionalThe number of months the Telegram Premium subscription won from the giveaway will be active for; for Telegram Premium giveaways only
Botlify Cloud Runtime
Credentials are auto-injected in .env — always load them with getenv(): BOT_TOKEN, ADMIN_CHAT_ID, BOT_USERNAME. Main database: database.db (SQLite, WAL mode). Runtime errors: error.log. Quick test: send to $ADMIN_CHAT_ID. Full details: Runtime Reference.