GiveawayWinners
This object represents a message about the completion of a giveaway with public winners
This object represents a message about the completion of a giveaway with public winners.
Fields
| Field | Type | Required | Description |
|---|---|---|---|
chat | Chat | Always | The chat that created the giveaway |
giveaway_message_id | Integer | Always | Identifier of the message with the giveaway in the chat |
winners_selection_date | Integer | Always | Point in time (Unix timestamp) when winners of the giveaway were selected |
winner_count | Integer | Always | Total number of winners in the giveaway |
winners | Array of User | Always | List of up to 100 winners of the giveaway |
additional_chat_count | Integer | Optional | The number of other chats the user had to join in order to be eligible for the giveaway |
prize_star_count | Integer | Optional | The number of Telegram Stars that were split between giveaway winners; for Telegram Star giveaways only |
premium_subscription_month_count | Integer | Optional | The number of months the Telegram Premium subscription won from the giveaway will be active for; for Telegram Premium giveaways only |
unclaimed_prize_count | Integer | Optional | Number of undistributed prizes |
only_new_members | True | Optional | True, if only users who had joined the chats after the giveaway started were eligible to win |
was_refunded | True | Optional | True, if the giveaway was canceled because the payment for it was refunded |
prize_description | String | Optional | Description of additional giveaway prize |
Botlify Cloud Runtime
Credentials are auto-injected in
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.