messageActionStarGift

You received a gift, see here » for more info.

messageActionStarGift#9bb3ef44 flags:# name_hidden:flags.0?true saved:flags.2?true converted:flags.3?true gift:StarGift message:flags.1?TextWithEntities convert_stars:long = MessageAction;

Parameters

Name Type Description
flags # Flags, see TL conditional fields
name_hidden flags.0?true If set, the name of the sender of the gift will be hidden if the destination user decides to display the gift on their profile
saved flags.2?true Whether this gift was added to the destination user's profile (may be toggled using payments.saveStarGift and fetched using payments.getSavedStarGifts)
converted flags.3?true Whether this gift was converted to Telegram Stars and cannot be displayed on the profile anymore.
upgraded flags.5?true This gift was upgraded to a collectible gift ».
refunded flags.9?true This gift is not available anymore because a request to refund the payment related to this gift was made, and the money was returned.
can_upgrade flags.10?true If set, this gift can be upgraded to a collectible gift; can only be set for the receiver of a gift.
gift StarGift Info about the gift
message flags.1?TextWithEntities Additional message from the sender of the gift
convert_stars flags.4?long The receiver of this gift may convert it to this many Telegram Stars, instead of displaying it on their profile page.
convert_stars will be equal to stars only if the gift was bought using recently bought Telegram Stars, otherwise it will be less than stars.
upgrade_msg_id flags.5?int If set, this gift was upgraded to a collectible gift, and the corresponding messageActionStarGiftUnique is available at the specified message ID.
upgrade_stars flags.8?long The number of Telegram Stars the user can pay to convert the gift into a collectible gift ».
from_id flags.11?Peer Sender of the gift (unset for anonymous gifts).
peer flags.12?Peer Receiver of the gift.
saved_id flags.12?long For channel gifts, ID to use in inputSavedStarGiftChat constructors.

Type

MessageAction

Related pages

payments.saveStarGift

Display or remove a received gift » from our profile.

payments.getSavedStarGifts

Fetch the full list of gifts owned by a peer.

Note that unlike what the name suggests, the method can be used to fetch both "saved" and "unsaved" gifts (aka gifts both pinned and not pinned) to the profile, depending on the passed flags.

Telegram Stars

Telegram Stars are virtual items that allow users to purchase digital goods and services from bots and mini apps inside the Telegram ecosystem, send gifts to content creators on the Telegram platform, and more.

Telegram Gifts

Users can send Gifts to their friends. The recipients of gifts can display them on their profile pages or turn them into Telegram Stars ». Telegram Stars can be used for many things, including supporting creators and buying services in mini apps.

messageActionStarGiftUnique

A gift » was upgraded to a collectible gift ».

inputSavedStarGiftChat

A gift received by a channel we own.