#1. 背景

之前的课程有详细讲过《Telegram Stickers、Gifts & NFT》，但是主要是用户视角的分析，本节课就从开发者视角看看，Telegram 通过 Bot API 给开发者开放了哪些操作 Gifts 的能力。

#2. BOT API 中 Gifts 更新历史

2024年 11 月 17 日，Bot API 8.0 首次更新 Gifts 相关功能：

• Bot 可以接受用户支付 Stars 后发送 Gifts 给用户。
• ✅ 添加了类 Gift 和 Gifts 以及方法 getAvailableGifts，允许机器人获取所有可发送的礼物。
• ✅ 新增 sendGift 方法，允许 Bot 向用户发送礼物。(注意：bot 发送给用户的 gift 不能转为 Stars)
• 向类 TransactionPartnerUser(描述一个用户相关的交易) 添加了字段 gift。

2025年 1 月 1 日 ，Bot API 8.2 更新 Gifts 可升级相关参数

• 向 类 Gift 添加了字段 upgrade_star_count。
• sendGift 方法中新增参数 pay_for_upgrade。(如果为 True 则以从机器人的余额中支付礼物升级，从而使接收者可以免费升级)

2025年 2 月 12 日 ，Bot API 8.3 更新可以向频道发送 Gift 的参数

• 在 sendGift 方法中添加了参数 chat_id，允许机器人向频道聊天发送礼物。
• 向类 ChatFullInfo 添加了字段 can_send_gift。(如果为True，表示可以接受发送礼物)