Instagram API integratsiyasi

Instagram API nima va u nima uchun kerak?

Instagram tomonida nimalar qo'llab-quvvatlanadi

Quyidagilar SDK'da tayyor holda keladi — har biri uchun alohida Graph API bilimi talab qilinmaydi.

Birinchi so'rov — OAuth'dan Instagram akkauntgacha

Facebook Login yo'lida foydalanuvchi kirgach, uning sahifalari va ularga bog'langan Instagram akkauntlari bitta chaqiruvda qaytadi.

import asyncio
from socialift import Facebook

async def main(code: str):
    # FACEBOOK_APP_ID, FACEBOOK_APP_SECRET, SOCIALIFT_LICENSE_KEY
    async with Facebook.from_env() as fb:
        token = await fb.exchange_code(code, redirect_uri="https://siz.uz/cb")
        for page in await fb.pages(token.access_token):
            print(page.name, "→ instagram:", page.instagram_username)

asyncio.run(main(code="..."))  # ?code= from the OAuth callback

Direct suhbatlarini o'qish

Suhbatlar API'si ishtirokchi haqida faqat ID va username beradi. conversations() har bir suhbatdosh uchun User Profile API'dan ism, obunachilar soni va kuzatish holatini qo'shadi — so'rovlar parallel, bir vaqtda 8 tagacha.

import asyncio, os
from socialift import Instagram

async def main(page_token: str):
    async with Instagram.via_facebook(app_secret=os.environ["FACEBOOK_APP_SECRET"]) as ig:
        chats = await ig.conversations(page_token, page_id="1111", ig_user_id="2222")
        for chat in chats["data"]:
            c = chat["contact"]
            if c:
                print(c.get("name"), c.get("follower_count"), "kuzatadimi:", c.get("is_user_follow_business"))

asyncio.run(main("PAGE_TOKEN"))

Story'ni API orqali qanday joylash mumkin?

Story oddiy postdan bitta narsa bilan farq qiladi: konteynerga media_type=STORIES qo'shiladi va u xuddi shu media_publish orqali chiqadi. Caption yo'q — story'da izoh matni ko'rinmaydi. Meta talablari: rasm JPEG, 8 MB gacha, tavsiya etilgan nisbat 9:16; video MOV yoki MP4, 3–60 soniya, 100 MB gacha.

import asyncio, os
from socialift import Instagram

async def main(page_token: str):
    async with Instagram.via_facebook(app_secret=os.environ["FACEBOOK_APP_SECRET"]) as ig:
        story = await ig.publish_story(page_token, ig_user_id="2222",
                                       image_url="https://cdn.siz.uz/story.jpg")
        print(story["media_id"])

        live = await ig.stories(page_token, ig_user_id="2222", limit=25)
        print(len(live), "ta story hozir ko'rinib turibdi")

asyncio.run(main("PAGE_TOKEN"))

Instagramni ulash — to'rt qadam

1. 1

   Instagram akkauntni tayyorlang

   Akkauntni Business yoki Creator turiga o'tkazing. Facebook sahifasiga bog'lash faqat Facebook Login yo'lida shart; Instagram Login (Instagram(app_id, app_secret)) sahifasiz ishlaydi.

2. 2

   Facebook ilovasini yarating

   Meta for Developers'da ilova oching va faqat ishlatadigan ruxsatlaringizni so'rang. Instagram Login uchun: instagram_business_basic va vazifaga qarab instagram_business_content_publish, instagram_business_manage_comments, instagram_business_manage_messages, instagram_business_manage_insights. Facebook Login uchun: pages_show_list, pages_read_engagement, instagram_basic va vazifaga qarab instagram_content_publish, instagram_manage_comments, instagram_manage_messages, instagram_manage_insights (leadlar uchun leads_retrieval). O'zingizga tegishli bo'lmagan akkauntlarga xizmat qilsangiz, Advanced Access uchun App Review va Business Verification kerak.

3. 3

   Socialift tokenini oling

   Google yoki email bilan kiring, kabinetdagi «Tokenlar» bo'limida «Yangi token» tugmasini bosing va slk_ bilan boshlanadigan kalitni oling. Birinchi oy bepul.

4. 4

   SDK'ni ulang

   pip install socialift, kalitni SOCIALIFT_LICENSE_KEY muhit o'zgaruvchisiga qo'ying va birinchi chaqiruvni yuboring.

Instagram, Facebook, LinkedIn, TikTok va Telegram imkoniyatlari

Barcha platformalar bitta SDK va bitta xato modeli ostida ishlaydi.

boryo'qJadvalni yon tomonga suring

Ishlab chiqarishga chiqishdan oldin

Instagram integratsiyalarida eng ko'p uchraydigan xatolar ro'yxati.

• ▸Server so'rovlarida appsecret_proof borligini tekshiring: ilova sozlamalarida «Require App Secret» yoqilgan bo'lsa, usiz Meta so'rovni rad etadi (SDK app_secret berilganda uni o'zi qo'shadi).
• ▸Instagram so'rovlari (Direct xabarlaridan tashqari) Business Use Case limitiga tushadi: X-Business-Use-Case-Usage sarlavhasini kuzating va RateLimitError'da backoff bilan qayta urining.
• ▸Webhook imzosini xom (raw) tanaga qarab hisoblang — JSON qayta serializatsiya qilinsa imzo mos kelmaydi.
• ▸Bir xil hodisa bir necha marta kelishi mumkin: Meta hodisa ID bermaydi, shuning uchun mazmundan kalit yasang (mid, leadgen_id, comment_id — SDK'da dedupe_key) va uni unikal ustunda saqlang.
• ▸Instagram Login tokeni 60 kun amal qiladi: 24 soatdan katta va muddati o'tmagan tokenni refresh_token bilan muntazam uzaytiring. Uzoq muddatli foydalanuvchi tokenidan olingan sahifa tokenining muddati yo'q, lekin u ma'lum holatlarda (masalan, ruxsat bekor qilinganda) bekor bo'ladi.
• ▸Foydalanuvchi ruxsatni bekor qilsa AuthError keladi — bu holatni CRM interfeysida ko'rsating.