Интеграция Instagram с CRM

Что такое интеграция Instagram с CRM?

Что Socialift делает и чего не делает

Границу важно обозначить сразу — это влияет на архитектуру интеграции.

Socialift ДЕЛАЕТ

Работает с API Instagram, Facebook, LinkedIn, TikTok и Telegram: OAuth и подключения, диалоги Direct, комментарии, посты, Lead Ads, реклама и проверка подписи вебхуков. SDK возвращает нормализованные данные, а в вашу систему их записывает ваш бэкенд.

Socialift НЕ ДЕЛАЕТ

Socialift не CRM. В нём нет воронки сделок, задач, отчётов и базы клиентов. Эти функции остаются в вашей CRM — Socialift становится для них источником данных.

Кому подходит

Командам, которые пишут собственную CRM; интеграторам, добавляющим канал Instagram в существующую CRM; агентствам и техническим командам бизнесов, продающих через Instagram.

Какие данные может получить CRM

Каждый поток — отдельный вызов SDK или поле вебхука: используйте только нужное.

Шаги интеграции с Socialift SDK

Полный путь для технической команды. Заложите время на App Review в Meta: заявка подаётся с видеозаписью уже работающей интеграции.

1. 1

   Переведите аккаунт Instagram в бизнес-тип

   Аккаунт должен быть Business или Creator. Привязанная страница Facebook нужна для входа через Facebook (Instagram.via_facebook) и для Lead Ads; вход через Instagram (Instagram(app_id, app_secret)) работает без страницы, но без доступа к рекламе.

2. 2

   Подготовьте приложение Meta и разрешения

   Создайте приложение в Meta for Developers и запросите только нужное: instagram_manage_messages (Facebook Login) или instagram_business_manage_messages (Instagram Login), для заявок — leads_retrieval. Advanced Access требует App Review.

3. 3

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

   Войдите через Google или email и создайте в разделе «Tokenlar» (токены) кабинета лицензионный ключ, начинающийся с slk_. Первый месяц бесплатно, и в это время открыты все возможности SDK — Direct, Lead Ads, статистика и остальное. После продления возможности зависят от плана токена: точный список показывает «Tekshirish va muhitlar» (проверка и окружения).

4. 4

   Встройте поток OAuth в CRM

   Пользователь нажимает «Подключить Instagram» внутри CRM и проходит OAuth: в Facebook Login fb.exchange_code() и fb.pages() возвращают токен страницы и ID Instagram-аккаунта, в Instagram Login ig.exchange_code() выдаёт токен Instagram.

5. 5

   Зарегистрируйте адрес вебхука

   Укажите callback URL и verify token в App Dashboard (ответ — через verify_challenge) и подпишите каждую страницу через fb.subscribe_page(). Проверяйте подпись по сырому телу (verify_request) и делайте дедупликацию через dedupe_key() — ID события Meta не присылает.

6. 6

   Сопоставьте события с объектами CRM

   Новый диалог → контакт и сделка; лид-форма → лид; комментарий → задача. Именно это сопоставление и есть основная ценность интеграции.

Три способа работать с Instagram

У каждого подхода своё место — ниже честное сравнение.

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

Если у вас один аккаунт и несколько сообщений в день, ручной работы достаточно. Интеграция имеет смысл, когда поток растёт.

Практический пример — превращаем диалоги в контакты CRM

Conversations API возвращает об участнике только ID и username; CRM нужны имя и признаки качества. Socialift отдаёт и то, и другое сразу.

import asyncio, os
from socialift import Instagram

async def main():
    async with Instagram.via_facebook(app_secret=os.environ["FACEBOOK_APP_SECRET"]) as ig:
        chats = await ig.conversations(page_token, page_id=PAGE_ID, ig_user_id=IG_USER_ID)
        for chat in chats["data"]:
            c = chat["contact"]
            if not c:
                continue
            crm.upsert_contact(external_id=c["id"], name=c.get("name") or c.get("username"),
                               source="instagram_direct", followers=c.get("follower_count"),
                               is_follower=c.get("is_user_follow_business"))

asyncio.run(main())

Какой результат даёт интеграция Instagram с CRM