send_gift_purchase_offer()

Client.send_gift_purchase_offer()

Sends an offer to purchase an upgraded gift.

Usable by Users Bots
Parameters:
  • owner_id (int | str) – Unique identifier (int) or username (str) of the target chat that currently owns the gift and will receive the offer. For a contact that exists in your Telegram address book you can use his phone number (str).

  • gift_name (str) – Name or link of the upgraded gift.

  • price (GiftResalePrice) – The price that the user agreed to pay for the gift.

  • duration (int) – Duration of the offer, in seconds. Must be one of 21600, 43200, 86400, 129600, 172800, or 259200.

  • paid_message_star_count (int, optional) – The number of Telegram Stars the user agreed to pay additionally for sending of the offer message to the current gift owner. Pass User.paid_message_star_count for users and None otherwise.

Returns:

Message – On success, the sent Message is returned.