Telegram

Broadcast videos, images, and text posts to your Telegram channels and groups directly from ShortSync.

Requirements

  • Destination: Channels, groups, or supergroups you own or admin
  • Video Size: Up to 50 MB per video (Telegram Bot API limit). Bigger videos up to 10 minutes long are compressed automatically.
  • Image Size: Up to 10 MB per photo
  • Supported Formats: MP4 video, JPEG or PNG images, plain text messages
  • Caption Length: Up to 1,024 characters on media, up to 4,096 characters for text-only
  • Bot Access: Your bot must be an admin of the channel or group with the 'Post Messages' permission

How It Works

Every Telegram post from ShortSync goes out through a bot you own. You create one in @BotFather (takes about a minute), paste the token into ShortSync, and add the bot as an admin in your channel.

Setup

1. Create a bot in @BotFather

Open @BotFather in Telegram and send the /newbot command. BotFather asks for a display name (what people see in chats) and a unique username that must end in bot, for example MyChannelBot.

When the bot is created, BotFather replies with an HTTP API token that looks like 123456789:ABC-DEF.... Copy this token, you will need it in the next step.

Creating a new Telegram bot in @BotFather using the /newbot command, receiving the HTTP API token

2. Paste the token into ShortSync

In ShortSync, open the Telegram connection modal and paste the token you got from BotFather. ShortSync validates it, encrypts it at rest, and registers a per-bot webhook so only your bot's events reach your workspace.

Keep the token secret

Anyone with the token can post as your bot. If it leaks, run /revoke in BotFather to invalidate it, then reconnect in ShortSync with the new token. Your channel binding is preserved.

Pasting the BotFather HTTP API token into the ShortSync Telegram custom-bot connection flow

3. Link your channel

After the token is validated, ShortSync shows two paths for linking a channel. Pick whichever is easier for your situation.

Paste a channel handle

If your bot is already an admin in a public channel, paste the channel's handle (@mychannel) or its full link (https://t.me/mychannel) into the shortcut field. ShortSync verifies your bot has the right permissions and links the channel in one call.

Best for: public channels where the bot is already an admin.

Add the bot as admin

In your channel: Manage Channel → Administrators → Add Admin → search for your bot's username and grant the 'Post Messages' permission. The channel appears in ShortSync within a few seconds automatically.

Best for: private channels, groups, or channels without a public handle.

Adding the Bot as Admin

Whether you use the handle shortcut or the automatic admin path, your bot needs to be an admin of the target channel or group with the 'Post Messages' permission. The three shots below walk through the flow on Telegram Desktop; mobile is nearly identical.

Telegram channel info panel showing the administrators row that opens the admin list

a. Open the channel or group, tap the header, and select the administrators row in the info panel.

Telegram administrators list with the Add Administrator button highlighted

b. In the Administrators panel, tap Add Administrator at the bottom.

Telegram Add Administrator search dialog with a bot username typed to locate the bot

c. Search for your bot by username, pick it from the list, and confirm the Post Messages permission. Your chat shows up in ShortSync within a few seconds.

Polls

On a text post, click Add a poll under the caption. Your caption is the question, so Telegram gets just the poll. Click Ask a different question when your caption says more: then the caption goes out as a message with the poll right after it. Tick Let people choose more than one option for a multiple-choice poll.

To end voting automatically, pick a time under Close the poll in the Telegram settings: After 1 hour, After 1 day, After 3 days, After 7 days or After 30 days. Telegram stops taking votes at that time. The default, Stays open, keeps the poll open until you close it in Telegram.

Telegram polls are anonymous. When you post to Telegram alone you can add up to 10 options of 100 characters.

Post options

Hide behind a spoiler

On photo and video posts, turn on Hide behind a spoiler to blur the media until people tap it.

Send silently

Turn on Send silently and subscribers get the post without a notification sound. Works on every post type, polls included.

Telegram settings with Hide behind a spoiler and Send silently both turned on

Inbox

Comments on your channel posts show up in your Inbox. Telegram keeps channel comments in the channel's linked discussion group, so two things are needed:

  1. Add your bot as an admin in the discussion group too, not just in the channel. Bots can't see group messages otherwise.
  2. Click Sync in the Inbox once. This links the channel to its group. After that, new comments arrive on their own.

When you reply from the Inbox, the bot posts your reply in the group as a reply to that comment. Comments written before the sync aren't imported.

Common Issues

Channel does not show up after adding the bot

Telegram only tells us about the bot when its status in the channel changes. If you added the bot before ShortSync was ready, dismiss it as admin and re-add it, or use the "Paste a channel handle" shortcut in the connection modal. Also confirm the bot has the 'Post Messages' permission specifically, not just generic admin.

Channel comments don't show up in the Inbox

Check that the channel has a discussion group (Manage Channel → Discussion), that your bot is an admin in that group, and that you've clicked Sync in the Inbox at least once since linking the group. Only comments posted after that show up.

Bot is already connected to another workspace

Each bot can only be linked to one ShortSync workspace at a time. If you need to move it, disconnect it from the current workspace first. If you want a channel in a different workspace, create a separate bot in BotFather for that workspace.

Video is larger than 50 MB

Telegram's Bot API caps video uploads at 50 MB. ShortSync compresses bigger videos to fit when it publishes, which uses one of your monthly video compressions. Videos longer than 10 minutes can't get small enough without losing too much quality, so trim them or post the caption as text only.

Bot token invalid or revoked

If you ran /revoke in BotFather to reset the token, your existing token stops working. Reconnect the channel in ShortSync and paste the new token BotFather gave you. The channel binding is preserved.