Post to Telegram with Media

This skill posts and schedules Telegram channel/group content via the Publora MCP server (or REST API fallback), supporting rich markdown formatting, photos, videos, and Telegram-specific message options like silent sends or disabled link previews.

Use it when posting or scheduling content to a Telegram channel or group through Publora - immediate or scheduled text/image/video posts, for example a simple channel announcement, a formatted product update, an image post with a caption, or a post scheduled for a specific time in a target timezone. Setup requires a Telegram bot (via @BotFather) added as channel administrator with can_post_messages permission, a Publora account/API key, and MCP configured in Claude Desktop. If the MCP server is unavailable, fall back to the REST API directly (using an x-publora-key header, not Authorization: Bearer).

Five tools: create_post (platforms array like ["telegram-1001234567890"], markdown content, and a required ISO 8601 scheduledTime - current time + 1 minute for immediate posting), get_upload_url (presigned media upload URL), and list_posts/update_post/delete_post for managing scheduled/draft posts. The platform ID follows a telegram-{chat_id} format, where the numeric chat ID (which can be negative for groups, e.g. telegram--1002345678901) comes from the /platform-connections endpoint. Telegram-specific options (disableNotification, disableWebPagePreview, showCaptionAboveMedia, protectContent) are only available via the REST API's platformSettings.telegram, not through MCP. Plans: Starter (free, 15 posts/month), Pro ($2.99/account/month, 100/account), Premium ($9.99/account/month, 500/account).

REST fallback example:

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"
  }'

Telegram's Bot API imposes stricter limits than regular Telegram accounts: 4,096-character text messages but only a 1,024-character media caption, images up to 10MB (10 per media group, JPEG/PNG/GIF/BMP/WebP), videos up to 50MB (not the 4GB regular-user limit; MP4/MOV/AVI/MKV/WebM), 30 messages/sec globally and 20/min per group, and Telegram's own markdown flavor (single *asterisks* for bold, unlike standard Markdown's double asterisks). A post cannot mix images and videos, and an over-length caption on a media post is sent as a separate reply rather than truncated.

Social media managers and marketers publishing or scheduling Telegram channel/group content through Publora who need Telegram's specific Bot API limits (caption length, file size, rate limits) handled correctly rather than hitting silent failures - including named troubleshooting fixes for a bot missing admin rights, a wrong channel name/ID, an oversized caption or file, and mixed media in one post.