Как подключить Instagram к CRM

Короткий ответ

Пошагово

1. 1

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

   Переведите аккаунт Instagram в тип Business или Creator — личные аккаунты не поддерживаются. Страницу Facebook привязывайте, если используете вход через Facebook или нужны Lead Ads.

2. 2

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

   Заведите приложение в Meta for Developers, добавьте продукты Instagram и Webhooks, надёжно сохраните app secret.

3. 3

   Запросите разрешения

   Для диалогов — instagram_manage_messages (или instagram_business_manage_messages при Instagram Login); для заявок — leads_retrieval, pages_manage_ads и ads_management; для страниц и вебхуков — pages_show_list, pages_read_engagement и pages_manage_metadata. Просите только то, что используете.

4. 4

   Напишите поток OAuth

   Кнопка «Подключить Instagram» в CRM ведёт на выбранное окно входа (Facebook или Instagram). Полученный код меняете на токен на сервере: при Facebook Login сохраняете страницы и ID привязанного Instagram-аккаунта, при Instagram Login — ID пользователя Instagram.

5. 5

   Подключите вебхук

   Откройте HTTPS-endpoint с валидным сертификатом, отвечайте на проверку hub.challenge (verify_challenge), сверяйте X-Hub-Signature-256 по сырому телу (verify_request) и подпишите каждую страницу на приложение (fb.subscribe_page). Для вебхуков комментариев нужны Advanced Access и режим Live.

6. 6

   Сопоставьте события

   Новый диалог → контакт и сделка; лид-форма → лид; комментарий → задача. Проставляйте метку источника на каждую запись.

7. 7

   Замкните поток ответа

   Пусть менеджер отвечает прямо из CRM. Это работает внутри 24-часового окна — показывайте окно в интерфейсе. За пределами окна тег human_agent позволяет ответить до 7 дней (нужна функция Human Agent); ig.send_message() тег не ставит.

OAuth-callback — страницы и Instagram-аккаунты

Путь Facebook Login: код меняется на токен, и каждая страница сохраняется вместе с привязанным Instagram-аккаунтом.

import asyncio
from socialift import Facebook

async def main(code: str):
    # FACEBOOK_APP_ID, FACEBOOK_APP_SECRET, SOCIALIFT_LICENSE_KEY — env
    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):
            # страница, её токен (храните зашифрованным) и привязанный Instagram
            crm.save_connection(page.id, page.access_token, page.instagram_id)

asyncio.run(main("CODE_FROM_CALLBACK"))

Превращаем диалоги в контакты CRM

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())

Самые частые ошибки

• ▸Аккаунт остался личным (не Business и не Creator) — API не работает вообще.
• ▸Не пройден App Review: то, что работало на аккаунтах с ролью в приложении, не работает у других клиентов.
• ▸Приложение не переведено в Live или страница не подписана на приложение — вебхуки не приходят.
• ▸Подпись вебхука посчитана по повторно сериализованному JSON.
• ▸Нет дедупликации событий — в CRM появились дублирующиеся сделки.
• ▸Не учтено 24-часовое окно — ответ вернулся неотправленным.
• ▸Не отслеживается срок токена — интеграция тихо остановилась.

Сколько это занимает