Telegram story API orqali story qanday joylanadi

Telegram story API orqali qanday joylanadi?

Bot API va MTProto: story bo'yicha farq

Bu birinchi va eng ko'p vaqt yeydigan savol. Bot tokeni bilan story joylash imkoni yo'q va bu vaqtinchalik cheklov emas.

Bot story'ni faqat qabul qiladi va unga javob yoza oladi. Shuning uchun Socialift'da story metodlari Telegram (bot) klientida takrorlanmaydi — ular faqat TelegramAccount da.

Nega bot story joylay olmaydi

Avval tekshirish: can_send_story

Telegram hujjati aynan shuni talab qiladi: «Before posting a story, clients should invoke stories.canSendStory». Xatoni fayl yuklangandan keyin emas, oldin ko'rasiz.

import asyncio
from socialift import ApiError, TelegramAccount

async def main():
    async with TelegramAccount.from_env() as tg:
        targets = await tg.story_targets()
        print("kanal nomidan mumkin:", targets.chats)

        try:
            check = await tg.can_send_story("me")
        except ApiError as exc:
            print("hozir story joylab bo'lmaydi:", exc)
            return
        print("bo'sh slot:", check.count)

asyncio.run(main())

Kim story joylay oladi va qanday xato keladi

Shartlar bajarilmasa Telegram aniq xato kodini qaytaradi — SDK ularni o'z xato turlariga tarjima qiladi.

Davomiylik: period qiymatlari

Telegram period uchun aynan to'rtta qiymatni qabul qiladi, boshqasi serverda rad etiladi. Socialift SDK buni faylni yuklashdan oldin tekshiradi.

period berilmasa maydon umuman yuborilmaydi va Telegram 24 soat qo'yadi. Muddat tugagach story arxivga tushadi; pinned=True bo'lsa u profilda ham qoladi.

Maxfiylik: kim story'ni ko'radi

MTProto'da bu Vector<InputPrivacyRule>. SDK uni to'rtta qisqartmaga keltiradi, murakkab holatlar uchun esa tayyor qoidalar ro'yxatini ham qabul qiladi.

everyone

Standart qiymat, ilovadagi kabi — InputPrivacyValueAllowAll. Story'ni hamma ko'radi.

contacts

Faqat kontaktlar — InputPrivacyValueAllowContacts.

close_friends

Faqat «yaqin do'stlar» — InputPrivacyValueAllowCloseFriends. Ro'yxatning o'zi contacts.editCloseFriends bilan boshqariladi.

selected

Faqat tanlangan foydalanuvchilar — InputPrivacyValueAllowUsers. Bu qiymatda allow ro'yxati majburiy.

deny

Istisnolar — InputPrivacyValueDisallowUsers. Qoidalar berilgan tartibda qo'llanadi, shuning uchun deny oxiriga qo'shiladi: «kontaktlar, lekin falonchi emas».

Media va matn: vertikal, 30 MB va caption tuzog'i

Socialift SDK bilan story yuborish

send_story faylni yuklaydi, maxfiylik qoidalarini yig'adi va stories.sendStory ni chaqiradi. Javob — Updates, ichida yangi story id si.

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("faol story chegarasi to'lgan")
            return
        try:
            result = await tg.send_story(
                "me",
                "story.mp4",
                caption="Yangi kolleksiya",
                period=43200,
                privacy="close_friends",
                deny=["@raqobatchi"],
                pinned=True,
                noforwards=True,
            )
        except RateLimitError as exc:
            print("haftalik yoki oylik chegara, kutish:", exc.retry_after)
            return
        print(result)

asyncio.run(main())

O'qish, tahrirlash va o'chirish

Tahrirda faqat berilgan maydonlar yuboriladi, qolgani o'zgarmaydi — shuning uchun edit_story da privacy standart 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="Tuzatilgan matn")
        await tg.edit_story("me", 42, privacy="contacts", deny=["@raqobatchi"])
        await tg.delete_story("me", [42, 43])

asyncio.run(main())

Ishga tushirishdan oldin tekshiruv ro'yxati

• ▸Bot tokeni bilan story joylashga urinmayapsizmi — bu metod Bot API'da yo'q.
• ▸Har safar joylashdan oldin can_send_story() chaqiring va count ni tekshiring.
• ▸Media vertikal va 30 MB dan kichik bo'lsin; nisbatni o'zingiz nazorat qiling, Telegram uni hujjatda belgilamagan.
• ▸period sifatida faqat 21600, 43200, 86400 yoki 172800 bering; Premium yo'q bo'lsa faqat 86400.
• ▸privacy="selected" bo'lsa allow ro'yxati majburiy.
• ▸STORY_SEND_FLOOD_WEEKLY va MONTHLY xatolarini RateLimitError sifatida tuting va retry_after ni kuting.
• ▸Kanal nomidan joylashda post_stories huquqi va boost holatini oldindan tekshiring.
• ▸Seans faylini shifrlab saqlang — u akkauntga to'liq kirish beradi.
• ▸Story matnidagi formatlash serverdagi stories_entities sozlamasiga bog'liq: hamma akkauntda ishlamaydi.