Publora — Telegram

Publora API 的 Telegram 平台技能。有关认证、核心调度、媒体上传以及工作区/网络钩子（webhook）文档，请参阅 publora 核心技能。

基础 URL： https://api.publora.com/api/v1
请求头（Header）： x-publora-key: sk_YOUR_KEY
平台 ID 格式： telegram-{chatId}

前提条件

1. 通过 Telegram 中的 @BotFather 创建一个 Bot
2. 复制 Bot Token
3. 将该 Bot 添加为目标频道或群组的管理员
4. 在 Publora 后台中，使用 Bot Token 与频道名称完成连接

平台限制（API — Bot API）

⚠️ Telegram Bot API 对文件大小有严格限制：最大为 50 MB（用户客户端支持高达 4 GB）。

常见错误：

• MEDIA_CAPTION_TOO_LONG — 标题超过 1,024 字符 → 缩减长度，或将文字移至消息正文中
• Bad Request: file is too big — 文件超出 50 MB → 压缩文件或改用更小的文件

发送纯文本消息

await fetch('https://api.publora.com/api/v1/create-post', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    content: '📢 **公告**：我们的新功能已上线！立即访问 publora.comnn#update #publora',
    platforms: ['telegram--1001234567890']  // 注意：群组聊天 ID 为负数
  })
});

Telegram 消息支持 Markdown 格式化。

定时发送消息

body: JSON.stringify({
  content: '此处为您的 Telegram 频道消息内容',
  platforms: ['telegram--1001234567890'],
  scheduledTime: '2026-03-20T09:00:00.000Z'
})

发送图片

import requests

HEADERS = { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' }

# 步骤 1：创建帖子（content 即为 media caption，最长 1,024 字符）
post = requests.post('https://api.publora.com/api/v1/create-post', headers=HEADERS, json={
    'content': '查看我们最新的更新！ 🚀',   # 若附带媒体文件，需控制在 1,024 字符以内
    'platforms': ['telegram--1001234567890']
}).json()

# 步骤 2：获取上传 URL（单张图片最大 10 MB）
upload = requests.post('https://api.publora.com/api/v1/get-upload-url', headers=HEADERS, json={
    'postGroupId': post['postGroupId'],
    'fileName': 'image.jpg',
    'contentType': 'image/jpeg',
    'type': 'image'
}).json()

# 步骤 3：执行上传
with open('image.jpg', 'rb') as f:
    requests.put(upload['uploadUrl'], headers={'Content-Type': 'image/jpeg'}, data=f)

发送视频（最大 50 MB）

流程与发送图片相同，但需将 contentType 设为 'video/mp4'，并将 type 设为 'video'。请确保文件大小不超过 50 MB。

平台特性说明（Platform Quirks）

• Bot API 文件大小限制为 50 MB — 不同于 Telegram 用户客户端支持的 4 GB。如需上传更大文件，需部署本地 Bot API 服务器（Publora 当前不支持）
• 标题（caption）与消息正文的区别：当附带媒体时，content 将作为标题（最多 1,024 字符）；对于纯文本帖子，content 最多可为 4,096 字符
• 支持 Markdown：可在消息正文中使用 **bold**、_italic_、`code`、[link](url) 等语法
• 群组聊天 ID 为负数：例如 telegram--1001234567890
• Bot 必须拥有管理员权限：在频道中发布消息需 Bot 具备管理员权限；在群组中则至少需要“发送消息”权限
• 速率限制：全局限速为 30 条消息/秒；每群组限速为 20 条消息/分钟 — Publora 会自动处理队列调度