GiftInfo

Raw MD
Describes a service message about a regular gift that was sent or received

Describes a service message about a regular gift that was sent or received.

Fields

FieldTypeRequiredDescription
giftGiftAlwaysInformation about the gift
owned_gift_idStringOptionalUnique identifier of the received gift for the bot; only present for gifts received on behalf of business accounts
convert_star_countIntegerOptionalNumber of Telegram Stars that can be claimed by the receiver by converting the gift; omitted if conversion to Telegram Stars is impossible
prepaid_upgrade_star_countIntegerOptionalNumber of Telegram Stars that were prepaid for the ability to upgrade the gift
is_upgrade_separateTrueOptionalTrue, if the gift's upgrade was purchased after the gift was sent
can_be_upgradedTrueOptionalTrue, if the gift can be upgraded to a unique gift
textStringOptionalText of the message that was added to the gift
entitiesArray of MessageEntityOptionalSpecial entities that appear in the text
is_privateTrueOptionalTrue, if the sender and gift text are shown only to the gift receiver; otherwise, everyone will be able to see them
unique_gift_numberIntegerOptionalUnique number reserved for this gift when upgraded. See the number field in UniqueGift.
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.