Интеграция Instagram API

Что такое Instagram API и зачем он нужен

Что поддерживается на стороне Instagram

Всё перечисленное доступно в SDK сразу — глубокое знание Graph API не требуется.

Первый запрос — от OAuth до Instagram-аккаунта

При входе через Facebook Login страницы пользователя и связанные с ними Instagram-аккаунты возвращаются одним вызовом.

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://ваш-домен/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

Conversations API отдаёт об участнике только ID и username. conversations() дополняет каждого собеседника данными User Profile API — имя, число подписчиков, статус подписки; запросы идут параллельно, до 8 одновременно.

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"), "подписан:", c.get("is_user_follow_business"))

asyncio.run(main("PAGE_TOKEN"))

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

История отличается от обычного поста ровно одним: в контейнер добавляется media_type=STORIES, а публикуется она тем же media_publish. Подписи нет — текст caption в истории не показывается. Требования Meta: фото JPEG до 8 МБ, рекомендуемое соотношение 9:16; видео MOV или MP4, 3–60 секунд, до 100 МБ.

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.ваш-домен/story.jpg")
        print(story["media_id"])

        live = await ig.stories(page_token, ig_user_id="2222", limit=25)
        print(len(live), "историй сейчас активно")

asyncio.run(main("PAGE_TOKEN"))

Подключение Instagram — четыре шага

1. 1

   Подготовьте аккаунт Instagram

   Переведите аккаунт в тип Business или Creator. Привязка к странице Facebook обязательна только для Facebook Login; Instagram Login (Instagram(app_id, app_secret)) работает без страницы.

2. 2

   Создайте приложение Facebook

   Создайте приложение в Meta for Developers и запрашивайте только те разрешения, которые используете. Для Instagram Login: instagram_business_basic и по задаче instagram_business_content_publish, instagram_business_manage_comments, instagram_business_manage_messages, instagram_business_manage_insights. Для Facebook Login: pages_show_list, pages_read_engagement, instagram_basic и по задаче instagram_content_publish, instagram_manage_comments, instagram_manage_messages, instagram_manage_insights (для лидов — leads_retrieval). Если приложение обслуживает чужие аккаунты, для Advanced Access нужны App Review и Business Verification.

3. 3

   Получите токен Socialift

   Войдите через Google или email, в разделе «Tokenlar» (токены) кабинета нажмите «Yangi token» (новый токен) и скопируйте ключ, начинающийся с slk_. Первый месяц бесплатно.

4. 4

   Подключите SDK

   pip install socialift, положите ключ в переменную окружения SOCIALIFT_LICENSE_KEY и отправьте первый запрос.

Возможности Instagram, Facebook, LinkedIn, TikTok и Telegram

Все платформы работают в одном SDK и под единой моделью ошибок.

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

Перед выходом в прод

Список ошибок, которые чаще всего встречаются в интеграциях с Instagram.

• ▸Проверьте, что серверные запросы несут appsecret_proof: если в настройках приложения включён «Require App Secret», без него Meta отклонит запрос (SDK добавляет подпись сам, если передан app_secret).
• ▸Запросы Instagram (кроме сообщений Direct) подпадают под лимиты Business Use Case: следите за заголовком X-Business-Use-Case-Usage и при RateLimitError повторяйте с экспоненциальной задержкой.
• ▸Считайте подпись вебхука по сырому (raw) телу запроса — после повторной сериализации JSON подпись не совпадёт.
• ▸Одно событие может прийти несколько раз: Meta не даёт ID события, поэтому стройте ключ из содержимого (mid, leadgen_id, comment_id — в SDK dedupe_key) и храните его в уникальном столбце.
• ▸Токен Instagram Login живёт 60 дней: регулярно продлевайте через refresh_token токен старше 24 часов, пока он не истёк. Токен страницы из долгоживущего пользовательского токена бессрочный, но аннулируется в ряде случаев (например, при отзыве доступа).
• ▸Если пользователь отозвал доступ, приходит AuthError — покажите это состояние в интерфейсе CRM.