Skip to content

upgradeGift

Returns boolean

Upgrades a given regular gift to a unique gift. Requires the can_transfer_and_upgrade_gifts business bot right. Additionally requires the can_transfer_stars business bot right if the upgrade is paid.

Required: business_connection_id, owned_gift_id · Optional: 2 parameters

Try it
Token saved
Response

TypeScript example · @effect-ak/tg-bot-client
import { makeTgBotClient } from "@effect-ak/tg-bot-client"
const client = makeTgBotClient({ bot_token: "YOUR_BOT_TOKEN" })
const result = await client.execute("upgrade_gift", {
business_connection_id: "...",
owned_gift_id: "..."
})

Parameters

business_connection_id string Required
Unique identifier of the business connection.

owned_gift_id string Required
Unique identifier of the regular gift that should be upgraded to a unique one.

keep_original_details boolean
Pass True to keep the original gift text, sender and receiver in the upgraded gift.

star_count number
The amount of Telegram Stars that will be paid for the upgrade from the business account balance. If gift.prepaid_upgrade_star_count > 0, then pass 0, otherwise, the can_transfer_stars business bot right is required and gift.upgrade_star_count must be passed.