核心用法
Publora Telegram Skill 是专为 Telegram 平台设计的自动化内容发布工具，基于 Publora API 构建。用户可通过 API 调用实现文本消息即时发布、定时推送、图片/视频多媒体发送等完整功能。
认证流程：需先在 Telegram 通过 @BotFather 创建机器人，获取 bot token，并将机器人设为目标频道/群组的管理员，最后在 Publora 控制台完成绑定。
平台标识格式：telegram-{chatId}，注意群组 ID 为负数（如 telegram--1001234567890）。
发布类型：
- 纯文本消息（支持 Markdown，最高 4,096 字符）
- 定时发布（ISO 8601 格式时间戳）
- 图片消息（单图最高 10 MB，最多 10 张）
- 视频消息（最高 50 MB，支持 MP4/MOV/AVI/MKV/WebM）
图片/视频发布采用三步流程：创建 post → 获取预签名上传 URL → 直接上传至存储。带媒体时，content 字段变为 caption，限制 1,024 字符。
显著优点
1. Markdown 原生支持：无需额外处理格式，支持粗体、斜体、代码块、链接等 Telegram 标准语法
2. 自动化程度高：支持定时发布、批量多平台同步，适合内容日历管理
3. 速率限制友好：Publora 内置队列处理 Telegram 的 30 msg/sec 全局限制和 20 msg/min 单群限制
4. 媒体上传优化：预签名 URL 机制避免大文件流经 Publora 服务器，降低延迟
潜在缺点与局限性
- 严格的文件大小限制：Bot API 仅支持 50 MB 视频（非用户客户端的 4 GB），大视频需预先压缩
- Caption 长度瓶颈：带媒体时 1,024 字符上限易触发
MEDIA_CAPTION_TOO_LONG错误 - 功能边界：不支持 Telegram 的高级功能如实况、投票、贴纸、地理位置等；Local Bot API Server 大文件方案不被 Publora 支持
- 权限依赖重：机器人必须拥有频道管理员或群组发消息权限，配置失败率高
- 负数 ID 易错：新手常忽略群组 ID 的负号前缀导致发布失败
适合人群
- 自媒体运营者：管理多个 Telegram 频道的内容排期
- 社群管理员：自动化群公告、活动提醒
- SaaS/工具类产品：需要集成 Telegram 通知渠道的技术团队
- 多平台内容分发用户：已有 Publora 账号，需同步至 Telegram 的跨平台运营者
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 权限失效 | 机器人被移除管理员或 token 泄露 | 定期检查频道成员权限，token 存放于密钥管理 |
| 内容违规 | 自动发布违反 Telegram ToS 的内容导致频道封禁 | 前置内容审核，避免垃圾信息/版权素材 |
| 定时任务堆积 | 高峰期队列延迟导致发布时间偏移 | 预留 5-10 分钟缓冲时间，避免精确到秒的依赖 |
| API 变更 | Telegram Bot API 更新可能导致兼容问题 | 关注 Publora 官方更新日志，保留降级方案 |