Telegram Bot API 9.0 lets bots post stories for business accounts

What this means for you

Stories are photos or short videos that disappear after a while. Until April 2025, apps could not post Telegram stories for you. Now a business can connect a bot, and that bot can post, change and delete stories for the business. This makes scheduled Telegram stories possible.

The details

• Methods: postStory, editStory, deleteStory; repostStory since Bot API 9.3. All require a business_connection_id; posting requires the can_manage_stories business bot right.
• Lifetime: active_period must be 6, 12, 24 or 48 hours (21600, 43200, 86400 or 172800 seconds). post_to_chat_page keeps the story visible on the profile after it expires.
• Caption: 0 to 2,048 characters after entities parsing.
• Video: per InputStoryContentVideo, 720x1280, streamable, H.265, key frames every second, MPEG4, up to 30 MB and 0 to 60 seconds. Videos must be uploaded as new files, not reused by file_id.
• Areas: StoryArea types for location, suggested reaction, link, weather and unique gift.
• Scope: business accounts only. The changelog does not add story posting for channels.

What to do next

• Business owners: If you want stories scheduled on Telegram, check whether your tool offers it through a business bot connection.
• Marketers and agencies: Export story videos at 720x1280 in H.265 and under 30 MB for Telegram.
• Developers: Request can_manage_stories, validate media against the InputStoryContentVideo rules, and send active_period as one of the four allowed values.