git:20260325.14bb7f1 to git:20260325.8e5bffe

---

name: telegram-post

description: Post to Telegram channels and groups with markdown formatting, media support, and message options via Publora MCP

---

# Telegram Post

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

## Prerequisites

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

### Getting Started

1. **Create account** at [publora.com/register](https://publora.com/register) (free)

2. **Create Telegram bot:**

- Message [@BotFather](https://t.me/BotFather) on Telegram

- Send `/newbot` and follow instructions

- Save the bot token

4. **Add bot to your channel:**

- Add the bot as **administrator** to your channel/group

- Grant `can_post_messages` permission

5. **Connect in Publora** at [Dashboard](https://publora.com/dashboard) with bot token and channel name

6. **Get API key** at [publora.com/settings/api](https://publora.com/settings/api)

7. **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"

}

}

}

}

```

### REST API Fallback

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

# 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)

### Plan Limits

| Plan | Posts/month | Price |

|------|-------------|-------|

| Starter | 15 | Free |

| Pro | 100/account | $2.99/account/month |

| Premium | 500/account | $9.99/account/month |

## Platform Limits (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.

## Markdown Formatting

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](url) |

| `> text` | Blockquote |

**Note:** This differs from standard Markdown where `**double asterisks**` make bold.

## 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)

### get_upload_url

Get presigned URL for media uploads.

### list_posts / update_post / delete_post

Manage scheduled and draft posts.

## Post Options (via 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.

## 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)"

```

### 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)"

```

### 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.

### Scheduled Post

```

Schedule this for tomorrow at 8 AM Moscow time:

"*Good morning!* Here's your daily market summary..."

```

## Important Restrictions

1. **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.

2. **Video max 50 MB**: Bot API limits videos to 50 MB (not 4 GB like regular users). Large videos will fail.

3. **Bot must be admin**: Your bot needs administrator role with `can_post_messages` permission. This is verified at connection time.

4. **No mixed media**: A single post cannot contain both images and videos.

5. **Caption overflow**: If caption exceeds 1,024 chars on a media post, it's sent as a separate reply message instead of being truncated.

## Best Practices

### Content

1. **Use formatting**: Bold headlines, italic emphasis improves readability

2. **Link previews**: Great for articles; disable for cleaner announcements

3. **Emoji usage**: Common and expected on Telegram

4. **Post length**: No penalty for longer posts on text-only messages

### 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)

### 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 |