后端即时通讯API设计【免费下载链接】aiogramaiogram is a modern and fully asynchronous framework for Telegram Bot API written in Python using asyncio项目地址https://gitcode.com/gh_mirrors/ai/aiogram点击查看免费下载BusinessIntro 是 aiogram 中用于描述Telegram 商业账户Business Account起始页设置的类型对象对应 Telegram Bot API 的BusinessIntro对象。本文以 docs/api/types/business_intro.rst 的 API 文档为骨架结合仓库源码与测试用例系统讲解其三个可选字段title、message、sticker的语义、在ChatFullInfo中的挂载位置、通过get_chat获取的完整调用链以及它在 Business 系列类型家族中的定位。读完本文你将能够准确解析商业账户主页简介数据并在自己的机器人中正确读取与使用这一信息。一、BusinessIntro 是什么商业账户的起始页设置根据 aiogram/types/business_intro.py 中类级别的 docstringContains information about the start page settings of a Telegram Business account.即BusinessIntro 承载了 Telegram 商业账户起始页start page的设置信息。当用户为商业账户配置了主页简介后这份简介的内容标题、正文文案、装饰贴纸就会以BusinessIntro对象的形式随聊天信息返回给机器人。在 aiogram 中它是一个典型的Telegram API 数据对象TelegramObject继承自 aiogram/types/base.py 中定义的TelegramObject基于 PydanticBaseModel配置了frozenTrue、extraallow、validate_assignmentTrue等行为。这意味着实例一旦创建即不可修改多出的未知字段也会被保留方便兼容 Telegram API 的向前演进。class BusinessIntro(TelegramObject): Contains information about the start page settings of a Telegram Business account. title: str | None None message: str | None None sticker: Sticker | None None二、三个可选字段的完整语义BusinessIntro的全部内容由三个全部可选Optional的字段构成下表汇总了源码 aiogram/types/business_intro.py 中的定义字段类型默认值含义源码 docstringtitlestr \| NoneNone商业账户主页简介的标题文本Title text of the business intromessagestr \| NoneNone商业账户主页简介的消息文本Message text of the business introstickerSticker \| NoneNone商业账户主页简介的贴纸Sticker of the business intro2.1 title标题文本title是商业账户起始页上展示的标题文字类型为str | None。它是一个纯文本字段并不强制要求提供——即商业账户主可以在不配置标题的情况下只提供正文。2.2 message正文消息文本message是起始页正文区域的文案类型同样为str | None。它是整个 intro 中最常见的实质内容载体通常用于一句话说明店铺/服务/联系方式等商业信息。2.3 sticker贴纸对象sticker字段的类型不是简单字符串而是一个完整的Sticker对象见 aiogram/types/sticker.py。也就是说当商业账户主为 intro 配置了贴纸时机器人收到的不是file_id字符串而是一个可进一步使用的结构化对象。Sticker自带file_id、file_unique_id、type、width、height、is_animated、is_video等字段可直接用于send_sticker等方法的二次转发或展示。注意由于三个字段都是可选的实际返回的BusinessIntro实例中可能只出现其中一两个字段。从源码结构看当商业账户主没有配置任何起始页内容时Telegram 甚至不会返回business_intro字段本身。三、BusinessIntro 在仓库中的注册与文档挂载3.1 导出位置BusinessIntro通过 aiogram/types/init.py 从模块aiogram.types.business_intro导入并同时加入__all__导出列表同文件第 371 行。因此使用者可以通过from aiogram.types import BusinessIntro或from aiogram import types的方式直接访问from aiogram.types import BusinessIntro intro BusinessIntro(titleAI Coffee, message欢迎光临营业时间 9:00-21:00) print(intro.title) # AI Coffee print(intro.message) # 欢迎光临营业时间 9:00-21:003.2 文档索引在 API 参考文档的类型索引 docs/api/types/index.rst 中business_intro被收录进toctree而 docs/api/types/business_intro.rst 本身通过 Sphinxautomodule指令自动从源码 docstring 生成页面内容这也是它正文极简的原因——真正的内容主体就是上面第 2 节所讲解的类定义与字段文档。仓库内还保留有对应的翻译源文件 docs/locale/uk_UA/LC_MESSAGES/api/types/business_intro.po可进一步印证这三个字段的官方语义描述。四、从哪个接口获取 BusinessIntroGetChat → ChatFullInfo 调用链BusinessIntro并不会单独作为一个更新事件推送而是作为聊天详情数据的一部分下发。在 aiogram 中它的宿主类型有两个其中一个是当前唯一正式生效的路径。4.1 正式路径ChatFullInfo.business_intro推荐在 aiogram/types/chat_full_info.py 中ChatFullInfo声明了字段business_intro: BusinessIntro | None None *Optional*. For private chats with business accounts, the intro of the business字段语义非常明确仅在与商业账户的私聊private chats with business accounts场景下返回普通用户私聊不会携带该字段。获取它的完整调用链是调用 GetChat 方法即bot.get_chat(chat_id...)GetChat的__returning__被声明为ChatFullInfo响应体被反序列化为ChatFullInfo对象从返回对象上读取chat.business_intro得到BusinessIntro | None。示例代码from aiogram import Bot async def show_business_intro(bot: Bot, chat_id: int) - None: chat await bot.get_chat(chat_idchat_id) intro chat.business_intro # type: BusinessIntro | None if intro is None: print(该聊天未提供商业账户起始页简介) return print(标题:, intro.title) print(正文:, intro.message) if intro.sticker: # sticker 是一个完整的 Sticker 对象 print(贴纸 file_id:, intro.sticker.file_id)这一调用链有对应的测试用例佐证tests/test_api/test_methods/test_get_chat.py 中通过MockedBot.add_result_for(GetChat, okTrue, resultChatFullInfo(...))构造响应再调用bot.get_chat(chat_id-42)并断言response prepare_result.result验证了get_chat返回ChatFullInfo的完整往返流程。当然要拿到真实的BusinessIntro数据需要在测试夹具的ChatFullInfo中补充business_introBusinessIntro(...)参数。4.2 已废弃路径Chat.business_intro在 aiogram/types/chat.py 中Chat也曾声明过business_intro字段但该字段通过json_schema_extra{deprecated: True}被标记为废弃docstring 明确说明它仅在getChat方法中返回且已随 Bot API 7.32024 年 5 月 6 日变更迁移.. deprecated:: API:7.3也就是说新版 Telegram Bot API 已把包括business_intro在内的一批聊天详情字段从通用的Chat对象迁移到了专门的ChatFullInfo对象中ChatFullInfo本身继承自Chat见 aiogram/types/chat_full_info.py。在实际开发中应统一从ChatFullInfo.business_intro读取避免依赖Chat上已废弃的字段。五、BusinessIntro 在 Business 类型家族中的定位BusinessIntro是 aiogram 商业账户Business相关类型群的一员。与它同属一个家族的还有BusinessConnectionaiogram/types/business_connection.py描述机器人与商业账户之间的连接包含id、user、user_chat_id、date、is_enabled、rights等字段是处理business_connection更新的入口BusinessLocation商业账户的地点信息BusinessOpeningHours及BusinessOpeningHoursInterval商业账户的营业时间BusinessMessagesDeleted商业账户消息被删除事件。这些类型共同服务于 Telegram 商业账户生态。在 Update 对象 中business_connection、business_message、edited_business_message、deleted_business_messages作为独立的更新字段出现而BusinessIntro不走更新推送只作为get_chat返回的聊天静态信息存在这也是它与上述事件类对象在使用方式上的关键区别。六、使用注意事项与最佳实践综合源码与文档使用BusinessIntro时有以下几点需要留意全字段可选务必判空title、message、sticker均为None默认值业务代码在读取前应做空值判断避免对None做字符串拼接或属性访问。仅商业账户私聊返回business_intro在ChatFullInfo中的 docstring 限定为 private chats with business accounts因此在处理非私聊或普通用户私聊时该字段大概率是None不要假设其必然存在。优先使用 ChatFullInfo虽然Chat上也有同名字段但它已随 API 7.3 废弃应以ChatFullInfo为准可参考 aiogram/types/chat_full_info.py 与 aiogram/types/chat.py 的对比。sticker 是完整对象sticker字段是Sticker类型而非字符串可以直接用其file_id在send_sticker等方法中复用该贴纸。对象不可变BusinessIntro继承的TelegramObject配置了frozenTrueaiogram/types/base.py创建后字段不可再赋值需要修改时应重新构造新实例。七、小结BusinessIntro虽只有三个可选字段却是机器人读取 Telegram 商业账户起始页设置的关键入口。本文从 API 文档出发结合 aiogram/types/business_intro.py 源码确认了title、message、sticker的确切语义与类型沿 GetChat → ChatFullInfo 的调用链说明了其实际获取方式并辨析了Chat.business_intro的历史废弃路径。如果你正在开发面向商业账户的机器人例如读取商家主页简介用于客服引导或展示直接从bot.get_chat(...)返回对象的business_intro字段入手即可配合上述判空与兼容性注意点就能稳妥地完成数据读取。赞分享后端即时通讯API设计【免费下载链接】aiogramaiogram is a modern and fully asynchronous framework for Telegram Bot API written in Python using asyncio项目地址https://gitcode.com/gh_mirrors/ai/aiogram点击查看免费下载相关推荐aiogram 实战指南使用 setBusinessAccountBio 修改托管商业账户简介aiogram 实战指南使用 setBusinessAccountBio 修改托管商业账户简介 本指南围绕 aiogram 框架中的 setBusinessA后端即时通讯API设计aiogram 中 postStory 方法详解用管理型企业账户发布 Telegram 故事aiogram 中 postStory 方法详解用管理型企业账户发布 Telegram 故事 postStory 是 aiogram 提供的 Telegram后端即时通讯API设计aiogram OwnedGift 类型详解从 Telegram 礼物对象到业务账户礼品管理实战aiogram OwnedGift 类型详解从 Telegram 礼物对象到业务账户礼品管理实战 本指南以 aiogram 仓库中的 OwnedGift 类型后端即时通讯API设计创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考