Gift

Raw MD
This object represents a gift that can be sent by the bot

This object represents a gift that can be sent by the bot.

Fields

FieldTypeRequiredDescription
idStringAlwaysUnique identifier of the gift
stickerStickerAlwaysThe sticker that represents the gift
star_countIntegerAlwaysThe number of Telegram Stars that must be paid to send the sticker
upgrade_star_countIntegerOptionalThe number of Telegram Stars that must be paid to upgrade the gift to a unique one
is_premiumTrueOptionalTrue, if the gift can only be purchased by Telegram Premium subscribers
has_colorsTrueOptionalTrue, if the gift can be used (after being upgraded) to customize a user's appearance
total_countIntegerOptionalThe total number of gifts of this type that can be sent by all users; for limited gifts only
remaining_countIntegerOptionalThe number of remaining gifts of this type that can be sent by all users; for limited gifts only
personal_total_countIntegerOptionalThe total number of gifts of this type that can be sent by the bot; for limited gifts only
personal_remaining_countIntegerOptionalThe number of remaining gifts of this type that can be sent by the bot; for limited gifts only
backgroundGiftBackgroundOptionalBackground of the gift
unique_gift_variant_countIntegerOptionalThe total number of different unique gifts that can be obtained by upgrading the gift
publisher_chatChatOptionalInformation about the chat that published the gift
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.