Как опубликовать историю Telegram через API

Как опубликовать историю через Telegram API?

Bot API и MTProto: разница по историям

Это первый и самый дорогой по времени вопрос. С токеном бота истории не публикуются, и это не временное ограничение.

Бот только получает историю и может на неё ответить. Поэтому в Socialift методы историй не дублируются в клиенте Telegram (бот) — они есть только в TelegramAccount.

Почему бот не может публиковать истории

Сначала проверка: can_send_story

Документация Telegram требует именно этого: «Before posting a story, clients should invoke stories.canSendStory». Ошибку видно до загрузки файла, а не после.

import asyncio
from socialift import ApiError, TelegramAccount

async def main():
    async with TelegramAccount.from_env() as tg:
        targets = await tg.story_targets()
        print("можно от имени канала:", targets.chats)

        try:
            check = await tg.can_send_story("me")
        except ApiError as exc:
            print("сейчас опубликовать нельзя:", exc)
            return
        print("свободных слотов:", check.count)

asyncio.run(main())

Кто может публиковать и какие ошибки приходят

Если условия не выполнены, Telegram возвращает конкретный код ошибки — SDK переводит их в свои типы исключений.

Длительность: значения period

Telegram принимает ровно четыре значения period, остальные отклоняет сервер. Socialift SDK проверяет это до загрузки файла.

Если period не передан, поле не отправляется и Telegram ставит 24 часа. По истечении срока история уходит в архив; при pinned=True она остаётся и в профиле.

Приватность: кто увидит историю

В MTProto это Vector<InputPrivacyRule>. SDK сводит его к четырём сокращениям, а для сложных случаев принимает готовый список правил.

everyone

Значение по умолчанию, как в приложении — InputPrivacyValueAllowAll. Историю видят все.

contacts

Только контакты — InputPrivacyValueAllowContacts.

close_friends

Только «близкие друзья» — InputPrivacyValueAllowCloseFriends. Сам список управляется через contacts.editCloseFriends.

selected

Только выбранные пользователи — InputPrivacyValueAllowUsers. При этом значении список allow обязателен.

deny

Исключения — InputPrivacyValueDisallowUsers. Правила применяются в переданном порядке, поэтому deny добавляется последним: «контакты, но не вот эти».

Медиа и текст: вертикаль, 30 МБ и ловушка подписи

Публикация истории через Socialift SDK

send_story загружает файл, собирает правила приватности и вызывает stories.sendStory. Ответ — Updates, внутри id новой истории.

import asyncio
from socialift import RateLimitError, TelegramAccount

async def main():
    async with TelegramAccount.from_env() as tg:
        check = await tg.can_send_story("me")
        if not check.count:
            print("лимит активных историй исчерпан")
            return
        try:
            result = await tg.send_story(
                "me",
                "story.mp4",
                caption="Новая коллекция",
                period=43200,
                privacy="close_friends",
                deny=["@konkurent"],
                pinned=True,
                noforwards=True,
            )
        except RateLimitError as exc:
            print("недельный или месячный лимит, ждать:", exc.retry_after)
            return
        print(result)

asyncio.run(main())

Чтение, редактирование и удаление

При редактировании отправляются только переданные поля, остальные не меняются — поэтому в edit_story у privacy значение по умолчанию None.

import asyncio
from socialift import TelegramAccount

async def main():
    async with TelegramAccount.from_env() as tg:
        peer = await tg.stories("me")
        for story in peer.stories:
            print(story.id, story.expire_date)

        await tg.edit_story("me", 42, caption="Исправленный текст")
        await tg.edit_story("me", 42, privacy="contacts", deny=["@konkurent"])
        await tg.delete_story("me", [42, 43])

asyncio.run(main())

Чек-лист перед запуском

• ▸Не пытаетесь ли вы публиковать историю токеном бота — такого метода в Bot API нет.
• ▸Перед каждой публикацией вызывайте can_send_story() и проверяйте count.
• ▸Медиа вертикальное и меньше 30 МБ; соотношение сторон контролируйте сами — Telegram его не зафиксировал.
• ▸В period передавайте только 21600, 43200, 86400 или 172800; без Premium — только 86400.
• ▸При privacy="selected" список allow обязателен.
• ▸Ошибки STORY_SEND_FLOOD_WEEKLY и MONTHLY ловите как RateLimitError и ждите retry_after.
• ▸Для публикации от имени канала заранее проверяйте право post_stories и бусты.
• ▸Файл сессии храните зашифрованным — он даёт полный доступ к аккаунту.
• ▸Форматирование в тексте истории зависит от серверной настройки stories_entities и работает не у всех.