IM Gateway & Telegram

Telegram Bot API 对接与 BotCommand 动态装载

解密 gateway/platforms/telegram.py 的消息接收环、MarkdownV2 逃逸细节
多平台接入
📊 图 5-2-1：多租户网关分流、多渠道适配器总线与消息标准收发图

🔌 1. 轮询接收环与 Webhook 网桥分发

在 gateway/platforms/telegram.py 中，系统提供 Webhook 触发与 Long Polling 双重轮询泵：

接收到 Telegram 的 Json Payload 后，系统将其统一反序列化为标准的 GatewayEvent，包含用户的 text 及其独有的 Telegram File ID。

Telegram 接收分流
📊 图 5-2-2：网关并发去重、Telegram 消息指纹哈希与重入判定流图

✏️ 2. MarkdownV2 转义避障与命令注入

Telegram MarkdownV2 要求对极其广泛的特殊字符（如 _ * [ ] ( ) ~ ` > # + - = | { } . !）进行强制转义，否则返回 400 Bad Request。适配器内置了 escape_markdown_v2() 状态自动转义函数解决此问题。