通过 Maton 托管认证安全接入 Telegram Bot API，支持消息发送、聊天管理、轮询交互等完整功能，需配合 API 密钥使用。
说明：
## 核心功能与用法
Telegram Skill 提供对 Telegram Bot API 的托管式集成，通过 Maton 平台实现统一认证管理。用户无需直接暴露 bot token，仅需配置 `MATON_API_KEY` 环境变量，即可调用完整的 Bot API 功能。
**主要能力覆盖：**
– **消息交互**：发送文本、图片、视频、音频、文档、位置、联系人、骰子动画及投票
– **聊天管理**：获取聊天信息、管理员列表、成员数量及权限查询
– **消息操作**：编辑、删除、转发、复制消息，支持富文本格式化（HTML/Markdown）
– **交互组件**：内联键盘、回复键盘、回调查询响应
– **Bot 配置**：设置命令菜单、个人资料描述、名称、Webhook 及长轮询获取更新
**使用流程**：创建 Connection → 浏览器授权配置 bot token → 通过 `Authorization: Bearer $MATON_API_KEY` 调用 API，`:token` 占位符由系统自动替换。
## 显著优点
– **托管认证安全**：bot token 不落地本地，降低密钥泄露风险
– **多 Bot 支持**：通过 `Maton-Connection` 头部可在同一 API Key 下管理多个机器人
– **完整 API 覆盖**：几乎涵盖 Telegram Bot API 所有核心方法
– **多语言示例**：提供 Bash、Python、JavaScript 的即用代码片段
– **显式写入确认**：所有写操作需用户明确批准，增加安全缓冲
## 局限性与潜在缺点
– **依赖第三方托管**：Maton 平台可用性直接影响服务连续性
– **网络访问强制**：无法离线使用，需稳定网络连接
– **速率限制继承**：受 Telegram 原生 API 限制（如 20 条/秒消息发送限制）
– **文件上传限制**：复杂场景需自行处理 multipart/form-data
– **环境变量依赖**：`MATON_API_KEY` 配置错误将导致全部请求失败
## 适用人群
– 需要快速部署 Telegram 机器人的开发者
– 希望通过统一平台管理多平台（Telegram + 其他）集成的团队
– 不愿直接处理 token 安全存储的中小型项目
– 构建客服、通知、投票等交互式 Bot 的场景
## 常规风险提示
– **API Key 保护**：`MATON_API_KEY` 等同于账户主密钥，泄露将导致全部连接暴露
– **消息内容合规**：发送内容需遵守 Telegram 服务条款及当地法规
– **权限边界**：Bot 仅能操作其被添加的群组/频道，私聊需用户主动发起
– **Webhook 安全**：若使用自定义 Webhook，需自行验证 secret_token 防止伪造请求
– **数据隐私**：消息内容经 Maton 中继，需评估是否符合数据合规要求（GDPR 等）
