telegram-post

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Telegram Post

Telegram 帖子发布

Create and schedule posts to Telegram channels and groups using the Publora MCP server. Supports rich markdown formatting, photos, videos, and message delivery options.

使用Publora MCP服务器创建并排期发布Telegram频道和群组帖子。支持丰富的Markdown格式、图片、视频及消息投递选项。

Prerequisites

前提条件

Plans: Free Starter (15 posts/month), Pro, Premium

套餐： 免费入门版（每月15条帖子）、专业版、高级版

Getting Started

快速开始

Create account at publora.com/register (free)
Create Telegram bot:
- Message @BotFather on Telegram
- Send
```
/newbot
```
  and follow instructions
- Save the bot token
Add bot to your channel:
- Add the bot as administrator to your channel/group
- Grant
```
can_post_messages
```
  permission
Connect in Publora at Dashboard with bot token and channel name
Get API key at publora.com/settings/api
Configure MCP in Claude Desktop (
```
~/.claude/claude_desktop_config.json
```
):

json

{
  "mcpServers": {
    "publora": {
      "type": "http",
      "url": "https://mcp.publora.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

创建账户：访问publora.com/register（免费）
创建Telegram机器人：
- 在Telegram上给@BotFather发送消息
- 发送
```
/newbot
```
  并按照指引操作
- 保存机器人令牌
将机器人添加到频道：
- 将机器人添加为频道/群组的管理员
- 授予
```
can_post_messages
```
  权限
在Publora中关联：访问控制台，输入机器人令牌和频道名称
获取API密钥：访问publora.com/settings/api
在Claude Desktop中配置MCP（路径：
```
~/.claude/claude_desktop_config.json
```
）：

json

{
  "mcpServers": {
    "publora": {
      "type": "http",
      "url": "https://mcp.publora.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

REST API Fallback

REST API 备选方案

If the MCP server is unavailable or returns errors, use the REST API directly:

Base URL:

https://api.publora.com/api/v1

Authentication: Use

x-publora-key

header (NOT

Authorization: Bearer

bash

undefined

如果MCP服务器不可用或返回错误，可直接使用REST API：

基础URL：

https://api.publora.com/api/v1

认证方式： 使用

x-publora-key

请求头（而非

Authorization: Bearer

）：

bash

undefined

Get your connected platforms

获取已关联的平台

curl -X GET "https://api.publora.com/api/v1/platform-connections"
-H "x-publora-key: sk_your_api_key"

Create a post

创建帖子

curl -X POST "https://api.publora.com/api/v1/create-post"
-H "x-publora-key: sk_your_api_key"
-H "Content-Type: application/json"
-d '{ "platforms": ["telegram-1001234567890"], "content": "Announcement\n\nYour message here", "scheduledTime": "2026-03-25T10:00:00Z" }'


**Platform ID Format:** `telegram-{chat_id}` where `{chat_id}` is the channel/group numeric ID from `/platform-connections`.

Example IDs: `telegram-1001234567890`, `telegram--1002345678901`

📖 **Full API documentation:** [docs.publora.com](https://docs.publora.com)


**平台ID格式：** `telegram-{chat_id}`，其中`{chat_id}`是从`/platform-connections`获取的频道/群组数字ID。

示例ID：`telegram-1001234567890`, `telegram--1002345678901`

📖 **完整API文档：** [docs.publora.com](https://docs.publora.com)

Plan Limits

套餐限制

Plan	Posts/month	Price
Starter	15	Free
Pro	100/account	$2.99/account/month
Premium	500/account	$9.99/account/month

套餐	每月帖子数量	价格
入门版	15	免费
专业版	100/账户	$2.99/账户/月
高级版	500/账户	$9.99/账户/月

Platform Limits (Bot API)

平台限制（Bot API）

Feature	Limit
Text message	4,096 characters
Media caption	1,024 characters (critical limit!)
Images	10 MB max, 10 per media group
Image formats	JPEG, PNG, GIF, BMP, WebP
Video size	50 MB max (not 4 GB - that's for users!)
Video formats	MP4, MOV, AVI, MKV, WebM
Rate limit	30 msg/sec global, 20 msg/min per group

Critical: Bot API has much lower limits than regular Telegram users. Videos over 50 MB and captions over 1,024 characters will fail.

功能	限制
文本消息	4096字符
媒体说明文字	1024字符（关键限制！）
图片	最大10MB，每组媒体最多10张
图片格式	JPEG、PNG、GIF、BMP、WebP
视频大小	最大50MB（并非4GB——那是普通用户的限制！）
视频格式	MP4、MOV、AVI、MKV、WebM
请求频率限制	全局30条/秒，每组20条/分钟

关键提示： Bot API的限制远低于普通Telegram用户。超过50MB的视频和超过1024字符的说明文字会导致发布失败。

Markdown Formatting

Markdown 格式说明

Telegram uses its own markdown flavor with single asterisks for bold:

Syntax	Result
`bold`	bold
`_italic_`	italic
`code`	`inline code`
code	Code block
`[text](url)`	hyperlink
`> text`	Blockquote

Note: This differs from standard Markdown where

**double asterisks**

make bold.

Telegram使用自有风格的Markdown，用单个星号表示粗体：

语法	效果
`bold`	粗体
`_italic_`	斜体
`code`	`行内代码`
code	代码块
`[text](url)`	超链接
`> text`	引用块

注意： 这与标准Markdown不同，标准Markdown使用

**双 asterisks**

表示粗体。

Available Tools

可用工具

create_post

Create a new Telegram post.

Parameters:

```
platforms
```
: Array with your Telegram connection ID (e.g.,
```
["telegram-1001234567890"]
```
)
```
content
```
: Message text (supports markdown)
```
scheduledTime
```
: ISO 8601 datetime (required - for immediate posting, use current time + 1 minute)

创建新的Telegram帖子。

参数：

```
platforms
```
: 包含Telegram关联ID的数组（例如：
```
["telegram-1001234567890"]
```
）
```
content
```
: 消息文本（支持Markdown）
```
scheduledTime
```
: ISO 8601格式的日期时间（必填——如需立即发布，使用当前时间+1分钟）

get_upload_url

Get presigned URL for media uploads.

获取用于媒体上传的预签名URL。

list_posts / update_post / delete_post

Manage scheduled and draft posts.

管理已排期和草稿状态的帖子。

Post Options (via REST API)

帖子选项（通过REST API）

Telegram-specific options available via REST API

platformSettings.telegram

Option	Description
`disableNotification`	Send silently (no sound)
`disableWebPagePreview`	No link preview cards
`showCaptionAboveMedia`	Caption above image/video
`protectContent`	Prevent forwarding/saving

Note:

platformSettings

is not available via MCP - use REST API for these options.

通过REST API的

platformSettings.telegram

可设置Telegram专属选项：

选项	说明
`disableNotification`	静默发送（无提示音）
`disableWebPagePreview`	禁用链接预览卡片
`showCaptionAboveMedia`	将说明文字显示在图片/视频上方
`protectContent`	禁止转发/保存内容

注意：

platformSettings

无法通过MCP使用——如需这些选项，请使用REST API。

Examples

示例

Simple Channel Post

简单频道帖子

Post this to my Telegram channel:
"*Product Update v2.5*

We have shipped the following improvements:
- _Faster API response times_ (avg 45ms)
- New `batch` endpoint for bulk operations

[Read the changelog](https://example.com/changelog)"

将以下内容发布到我的Telegram频道：
"*Product Update v2.5*

我们已完成以下改进：
- _更快的API响应速度_（平均45ms）
- 新增`batch`端点用于批量操作

[查看更新日志](https://example.com/changelog)"

Formatted Announcement

格式化公告

Create a Telegram post with this formatting:
"*Important Update*

We're launching our new feature tomorrow at 10 AM UTC.

_What's new:_
- Feature A improvements
- Feature B release

[Read the full announcement](https://example.com/update)"

创建带有以下格式的Telegram帖子：
"*重要更新*

我们将于明天UTC时间10点推出新功能。

_新增内容：_
- 功能A优化
- 功能B发布

[查看完整公告](https://example.com/update)"

Post with Image

带图片的帖子

Post this image to my Telegram channel with caption:
"*New Dashboard Preview*

Here's a sneak peek at our redesigned analytics dashboard."

Important: Caption must be under 1,024 characters when posting with media.

将这张图片发布到我的Telegram频道，并附上说明：
"*新控制台预览*

这是我们重新设计的分析控制台抢先看。"

重要提示： 发布媒体内容时，说明文字必须少于1024字符。

Scheduled Post

排期帖子

Schedule this for tomorrow at 8 AM Moscow time:
"*Good morning!* Here's your daily market summary..."

将以下内容排期到明天莫斯科时间8点发布：
"*早上好！* 这是您的每日市场摘要..."

Important Restrictions

重要限制

Caption limit is 1,024 chars: When posting with media (images/videos), text is sent as a caption limited to 1,024 characters. Text-only messages allow 4,096 characters.
Video max 50 MB: Bot API limits videos to 50 MB (not 4 GB like regular users). Large videos will fail.
Bot must be admin: Your bot needs administrator role with
```
can_post_messages
```
permission. This is verified at connection time.
No mixed media: A single post cannot contain both images and videos.
Caption overflow: If caption exceeds 1,024 chars on a media post, it's sent as a separate reply message instead of being truncated.

说明文字限制为1024字符：发布媒体内容（图片/视频）时，文本作为说明文字发送，限制为1024字符。纯文本消息允许4096字符。
视频最大50MB：Bot API限制视频大小为50MB（不像普通用户是4GB）。大视频会发布失败。
机器人必须是管理员：您的机器人需要拥有
```
can_post_messages
```
权限的管理员角色。这会在关联时进行验证。
不支持混合媒体：单个帖子不能同时包含图片和视频。
说明文字溢出处理：如果媒体帖子的说明文字超过1024字符，会作为单独的回复消息发送，而非被截断。

Best Practices

最佳实践

Content

内容方面

Use formatting: Bold headlines, italic emphasis improves readability
Link previews: Great for articles; disable for cleaner announcements
Emoji usage: Common and expected on Telegram
Post length: No penalty for longer posts on text-only messages

使用格式：粗体标题、斜体强调可提升可读性
链接预览：适合文章；如需更简洁的公告可禁用
表情符号使用：Telegram用户普遍接受并期待使用表情
帖子长度：纯文本帖子不受长度限制

Timing

时间安排

Global audience: Telegram users are worldwide; consider timezone posts
Best times: 8-10 AM, 12-2 PM, 7-9 PM in target regions
Frequency: Channels can post more frequently (5-10/day)

全球受众：Telegram用户遍布全球；考虑按时区发布
最佳时段：目标地区的8-10点、12-14点、19-21点
发布频率：频道可更频繁发布（每天5-10条）

Engagement

互动提升

Enable comments in channel settings for discussions
Use polls for engagement
Pin important announcements

在频道设置中启用评论以促进讨论
使用投票提升互动
置顶重要公告

Troubleshooting

故障排查

Error	Cause	Solution
"Bot not admin"	Bot missing admin permissions	Add bot as admin with `can_post_messages`
"Channel not found"	Wrong channel name/ID	Verify `@channelname` or numeric chat ID
`MEDIA_CAPTION_TOO_LONG`	Caption > 1,024 chars	Shorten caption or use text-only post
"Bad Request: file is too big"	File > 50 MB	Compress video/image to under 50 MB
"Mixed media not supported"	Images + video in same post	Use one media type per post

错误	原因	解决方案
"Bot not admin"	机器人缺少管理员权限	将机器人添加为管理员并授予 `can_post_messages` 权限
"Channel not found"	频道名称/ID错误	验证 `@channelname` 或数字聊天ID
`MEDIA_CAPTION_TOO_LONG`	说明文字>1024字符	缩短说明文字或使用纯文本帖子
"Bad Request: file is too big"	文件>50MB	将视频/图片压缩到50MB以下
"Mixed media not supported"	帖子中同时包含图片和视频	每个帖子仅使用一种媒体类型