← 所有文章
对比选型

Telegram Bot API 10.1 发布富文本消息功能——对接收端团队来说,什么变了,什么没变 — UnifyPort

6 月 11 日,Telegram 发布了 Bot API 10.1——这一次,更新日志确实值得兴奋。机器人现在可以发送包含表格、标题、嵌套列表、内联媒体、折叠段落、数学公式、脚注和引用块的富文本消息。全新的 sendRichMessageDraft 方法支持流式传输部分消息,这意味着 AI 智能体可以推送”思考中”的渐进式回复,而不是延迟后一次性输出一大段文字。消息最大长度提升至 32,768 个字符,超过约 8,000 字符后会出现”显示更多”按钮。

几天之内,各大主流机器人库——python-telegram-bot、puregram、Telegraf——都开了 issue 来跟进 10.1 的支持。AI 智能体框架也开始提交工单,准备将基于 Markdown 的回复渲染替换为新的 RichMessage 块。如果你做 Telegram 机器人开发,这是自 2019 年 MarkdownV2 以来最大的格式化升级。

但如果你的团队是在 Telegram 和其他平台上接收消息,值得问一个更尖锐的问题:这些更新对你的入站流程有影响吗?

Bot API 10.1 到底增加了什么

新功能全部在发送端——即机器人如何格式化和发送消息用户。以下是本次更新内容:

功能方法说明
富文本格式sendRichMessage表格、标题、列表、内联媒体、数学公式、折叠块、脚注
流式回复sendRichMessageDraft边生成边推送消息——专为 AI 智能体设计
更长的消息最大 32,768 字符,此前有效上限约 4,096
富文本内联结果InputRichMessageContent内联查询、访客模式和 Web App 查询中支持富文本
编辑支持editMessageText新增 rich_message 参数,可编辑已发送的富文本消息

这些功能全部提升的是机器人能什么。没有任何一项改变机器人能听到什么。Update 对象——用户给机器人发消息时 Telegram 推送给你的数据结构——和 10.1 之前完全一样。用户的文本消息依然以 message 更新中的 text 字段到达。媒体依然以 photodocumentvoice 等形式到达。入站 schema 没变,因为它不需要变:用户不会给你的机器人发带 LaTeX 公式和折叠段落的富文本消息。

为什么这对多平台团队来说没那么重要

如果 Telegram 是你唯一的渠道,10.1 毫无疑问是好消息。机器人回复更漂亮了,AI 智能体的流式输出更流畅了,你也不用再和 MarkdownV2 的转义规则较劲了。

但 2026 年接收入站消息的大多数团队并不只用 Telegram。他们同时在处理 WhatsApp 私信、LINE 消息、TikTok 电商客服对话、X 上的提及和 Zalo 公众号消息——他们的痛点不是如何格式化回复,而是如何把所有这些入站消息汇集到同一个地方,用同一种格式,足够快地响应。

以下是各平台官方 API 在入站消息推送方面的对比:

平台官方入站方式格式费用接入时间
TelegramBot API webhook (setWebhook)Telegram Update JSON免费几分钟
WhatsAppCloud API webhookMeta webhook 格式按消息计费 + BSP 加价数天至数周
LINEMessaging API webhookLINE 事件 JSON免费额度,超出按消息计费数天至数周(仅 3 个国家)
XAPI v2(轮询或过滤流)X API JSON$0.001–$0.20/次数小时至数天
TikTok无通用私信 API无编程化路径
ZaloOA API webhookZalo 事件 JSON分级 OA 定价数天至数周

六个平台,六种认证模型,六种 webhook 格式,六种计费方式。Telegram 的 Bot API 10.1 让这张表中的一列更强大了——Telegram 的发送端格式化列——但没有改变真正决定你集成复杂度的那一行:入站消息的数据格式。

入站的核心问题是格式归一化,不是格式化

多平台入站团队需要的不是任何单一渠道上更丰富的发送格式,而是一种归一化的入站事件——无论消息来自哪个平台都长一个样——这样一个 webhook 处理器、一套签名验证逻辑、一个路由函数就能覆盖全部六个渠道。

这正是 UnifyPort 提供的能力。连接你的账号——Telegram、WhatsApp、LINE、TikTok、Zalo、X——每条入站消息都以 message.received 事件的统一 schema 到达你的 webhook:

{
  "event": "message.received",
  "data": {
    "account_id": "acct_tg_support",
    "provider": "telegram",
    "chat_id": "chat_7d3a1f",
    "sender": "user_9c4b2e",
    "message": {
      "id": "tg_msg_8e1f4a",
      "type": "text",
      "text": "你好,这款有 L 码吗?",
      "reply_token": "rt_3f7b9c..."
    },
    "timestamp": 1750636800
  }
}

provider 换成 whatsapplinetiktok,数据结构完全不变。你的处理器用创建 webhook 时设置的 signing_secret 验证一次 HMAC-SHA256 签名,然后路由消息——不需要按平台引入 SDK,不需要按渠道写解析逻辑,不需要六路分支判断事件格式。

无需官方 API 审批或企业认证。个人账号和普通账号即可使用。没有按消息计费,也没有模板审核队列。

面对 10.1,应该怎么做

如果你在做 Telegram 机器人开发:升级你的库,开始用 sendRichMessage。格式化能力确实出色,通过 sendRichMessageDraft 实现流式输出对生成长回复的 AI 机器人来说是明显的提升。

如果你在多个平台接收消息:10.1 不会改变你的入站架构。用户发给你的消息依然以原来的格式到达——Telegram 如此,其他平台也一样。集成的挑战始终是把六种不同的入站格式归一到同一个处理器里,而这正是统一 webhook 消除逐平台集成工作的层级。

Telegram 发布了一支更好的画笔。管道工程——把客户的消息送到你的团队——是另一个问题,而且它天然与平台无关。