Вопросы и ответы

Instagram, Facebook, LinkedIn, TikTok и Telegram (аккаунт и бот), а также реклама Facebook и Instagram через Meta Marketing API. Возможности зависят от платформы — например, чат есть в Instagram Direct и Telegram, но не в LinkedIn.

Да, но связка работает в вашем бэкенде: готового коннектора к CRM у Socialift нет. Ваш сервер принимает вебхуки Meta (проверка — verify_request, разбор — parse_events), получает сообщения, комментарии или заявки через SDK и записывает их в API CRM. Direct и комментарии работают через Instagram Login или аккаунт, привязанный к странице; для Lead Ads нужна страница Facebook. Для чужих аккаунтов Meta требует Advanced Access (App Review и Business Verification).

Универсального ответа нет — важно, чтобы у CRM был открытый API (или приём входящих вебхуков). Тогда ваш бэкенд читает Direct, комментарии и Lead Ads через SDK Socialift и записывает их в этот API. CRM без API и без приёма вебхуков интегрировать нельзя.

Источников три: формы Lead Ads (вебхук leadgen содержит только ID, саму заявку получают через fb.lead), вопросы в Direct и комментарии под постами (вебхуки messages и comments). Ваш бэкенд превращает каждое событие в лид или сделку через API CRM.

Meta отправляет вебхук messages на ваш сервер. Ваш код проверяет его через verify_request, разбирает через parse_events, при необходимости получает профиль отправителя через ig.contact(igsid, token) и записывает контакт и диалог в API CRM. Сам Socialift сообщения на ваш endpoint не пересылает.

Нет. Instagram API работает только с профессиональными аккаунтами (Business или Creator). Страница Facebook нужна только при входе через Facebook Login; Instagram Login (Instagram(app_id, app_secret) в SDK) работает без страницы, но без доступа к рекламе.

Да, в течение 24 часов после последнего сообщения пользователя и только в диалогах, которые начал он. Живой оператор может ответить до 7 дней с тегом HUMAN_AGENT (нужен App Review), а на комментарий можно отправить один приватный ответ в течение 7 дней — автоматические сообщения вне этих окон запрещены.

Вебхук — POST-запрос, который платформа отправляет на ваш HTTPS-адрес в момент события. В теле — содержимое события, в заголовке — подпись. Вы проверяете подпись и возвращаете 200.

Чаще всего подпись считают по повторно сериализованному JSON вместо сырого тела. Другие причины: неверный app secret или прокси, изменяющий тело запроса.

Да. Meta повторяет неудачные доставки до 36 часов, поэтому одно событие может прийти несколько раз. Дедуплицируйте по стабильному ключу из payload (например, leadgen_id, mid сообщения, ID комментария) — его строит socialift.webhooks.dedupe_key().

Не всегда. Через Facebook Login for Business один поток OAuth охватывает страницы и привязанные к ним аккаунты Instagram (Instagram.via_facebook в SDK). Аккаунты Instagram без страницы подключаются через отдельный Instagram Login, без доступа к рекламе.

Нет. Messages API LinkedIn доступен только одобренным партнёрам, поэтому в Socialift его нет. Для LinkedIn доступны OAuth, профиль и публикация контента.

Да. Видео — по URL (домен должен быть подтверждён) или загрузкой файла; есть фото-карусели и черновики. Перед публикацией приложение должно вызвать creator_info(), а до аудита TikTok посты только SELF_ONLY, не более 5 пользователей за 24 часа и только в приватные аккаунты. Комментарии и статистика — только для Business-аккаунта.

Аккаунт подключается по номеру телефона, коду и 2FA: читает полную историю чатов, в которых состоит, и списки участников, если админы их не скрыли, создаёт группы и каналы, управляет участниками, отправляет отложенные сообщения и опросы. Бот подключается по токену от BotFather: сообщения, файлы, модерация и вебхуки со своим секретом — но полную историю и списки участников бот не видит. Для работы с аккаунтом из SDK нужен pip install "socialift[telegram]".

Да, через Meta Marketing API для Facebook и Instagram: поиск таргетинга по интересам, локациям и языкам, оценка охвата без расходов, кампании, группы объявлений, объявления и креативы (создаются в статусе PAUSED), продвижение поста Instagram одним вызовом, custom и lookalike аудитории.

Тестовая среда внутри кабинета: для каждого из 191 методов — описание (что делает, подводные камни, нужные разрешения), форма по реальной схеме API, выбор подключённого аккаунта, настоящий запрос с просмотром ответа и код на Python SDK, cURL или JavaScript. Удаление и действия с бюджетом требуют подтверждения.

Для Meta — да, если приложение работает с аккаунтами людей без роли в нём: Standard Access покрывает только ваши аккаунты и пользователей с ролью в приложении, а Advanced Access требует App Review и Business Verification. У TikTok для публичных постов нужен отдельный аудит, у LinkedIn продукты вроде Community Management API одобряются отдельно.

Нет. Socialift — независимый слой интеграции поверх публичных API Meta, LinkedIn, TikTok и Telegram и не является официальным партнёром ни одной из этих компаний.

Сейчас есть официальный пакет для Python: pip install socialift.

Новый токен из кабинета не требует карты: первые 30 дней он работает в пробном режиме и открывает все возможности SDK — базовые методы, помощники для вебхуков, публикацию, Instagram Direct, аккаунт Telegram (TelegramAccount), статистику, рекламу и Lead Ads. Затем токен продлевают 30-дневными периодами с баланса: цена указана в кабинете, а возможности зависят от плана токена — точный список показывает кнопка «Tekshirish va muhitlar» (проверка и окружения) у токена в кабинете. Playground в кабинете работает при любом плане.

Токен перейдёт в статус истёкшего, и вызовы SDK перестанут проходить. Чтобы продолжить, пополните баланс и продлите токен в кабинете.

Токены социальных сетей и сессии Telegram, подключённые в кабинете, и добавленные вами ключи приложений хранятся на сервере в зашифрованном виде, не передаются в браузер и используются только для запрошенных вами операций. SDK же ничего не хранит — при работе через него токены остаются в вашем приложении. Подробности — в политике конфиденциальности.

SDK при ответах 429, 5xx и ошибках лимитов Meta (коды 4, 17, 32, 613) делает до 3 попыток с экспоненциальной задержкой. Если RateLimitError всё же дошёл до вас, retry_after заполнен, только когда платформа прислала заголовок Retry-After — Meta обычно его не шлёт, а её лимиты считаются в скользящем часовом окне, поэтому ждите минуты, а не секунды.