Platforms

Telegram

Telegram over the overads API: status, connection, limits, media rules and platformSettings keys.

Status: Live. Posts created over the API deliver to this channel today.

Publishes today to channels where the overads bot is an administrator. The deployment needs TELEGRAM_BOT_TOKEN set; the app tells you the bot's handle to add.

Connecting#

Add the overads bot as an administrator of the channel, then enter the channel handle in the app.

Once connected the account appears in GET /connections with platform: "telegram". Use its id in connectionIds.

Limits#

• Up to 10 images and up to 10 videos, sent as an album.
• Each video up to 20 MB: Telegram fetches media by URL itself and caps it there.
• Media is optional.

Limits are checked when the post is created or edited, so an over-limit post is refused then with a sentence naming the cap, not at the scheduled minute. A video over the channel's size cap is MEDIA_TOO_LARGE; over its duration cap is MEDIA_TOO_LONG.

Settings#

Pass these under platformSettings.telegram. Every key is optional. An unknown key is refused with PLATFORM_SETTING_UNKNOWN and the dotted path of the key.

{ "telegram": { "disableNotification": true, "disableWebPagePreview": true } }