Unified Login от Meta для Instagram: что это и что меняется для приложений в 2026 году
Unified Login это третья схема подключения Instagram API от Meta и та, которую компания рекомендует для новых интеграций: клиент входит через Instagram или Facebook Login, выбирает Business Portfolio и аккаунты Instagram для доступа, и приложение получает один токен Business Integration System User. Новые функции Instagram API выпускаются только здесь, а существующие интеграции с Instagram Login продолжают работать, дата их отключения не объявлена.
easyCoexistence подключает Instagram через Instagram Login: владелец входит через Instagram и подтверждает пять разрешений, а Claude, ChatGPT или ваша собственная платформа публикует, планирует, отвечает на комментарии и личные сообщения и читает статистику через официальный API Meta.
Meta выпускает новые функции Instagram API только для Instagram API с Unified Login.
Интеграции с Instagram Login продолжают работать; Meta объявит любое изменение в журнале изменений Instagram Platform.
Руководство Meta по миграции говорит, что новые приложения не могут настроить Instagram API с Instagram Login.
Охватывает аккаунты, которыми делится клиент, и принадлежит Business Portfolio клиента, а не человеку, который вошёл в систему.
Профессиональные аккаунты Instagram, которые приложение может пригласить как Instagram Testers во время тестирования Unified Login в режиме Development.
Что такое Instagram API с Unified Login?
Один процесс входа для двух типов клиентов: люди входят через аккаунт Instagram или через Facebook Login, и Страница не нужна. Построенный на Facebook Login for Business, он запрашивает у клиента Business Portfolio, аккаунты Instagram для доступа и дополнительные активы, например рекламный аккаунт, а затем передаёт приложению токен для сообщений, публикаций, модерации комментариев и, при разрешениях на рекламу, для рекламы.
Чем он отличается от Instagram Login?
В том, кто входит, что выбирает и что остаётся у приложения после входа. Руководство Meta по миграции сравнивает оба варианта; третья схема, Facebook Login, использует тот же хост Graph и разрешения instagram_*, что и Unified Login, но требует, чтобы аккаунт был связан со Страницей:
| Unified Login | Instagram Login | |
|---|---|---|
| Clients sign in with | Instagram, or Facebook Login | |
| Clients choose | A business portfolio, then the accounts to share | Nothing beyond the account signing in |
| App credentials | Meta app ID and app secret | Instagram app ID and app secret |
| Login link | A login URL with the configuration's config_id | An embed URL with the Instagram app ID and scopes |
| Access token | Business Integration System User, expiry set by the configuration | Instagram User, 60 days, refreshable |
| API host | Facebook Login's Graph host | graph.instagram.com |
| Account ID | GET /me/assigned_instagram_accounts | Returned with the token, or /me |
| Permissions | The instagram_* family | The instagram_business_* family |
| Business portfolio | Required | Not required |
Что доступно только в Unified Login?
Руководство Meta даёт ему эти возможности по сравнению с Instagram Login. Первая и последняя принадлежат только Unified Login; остальные он делит с Facebook Login, которому нужна Страница:
- Новые функции Instagram API, которые Meta выпускает только для Unified Login.
- Поиск по хештегам, отметки товаров и партнёрская реклама, которые Meta отмечает как не поддерживаемые в Instagram Login.
- Audio API, Collaboration API и Business Discovery, описанные для Facebook Login и Unified Login.
- Реклама через Marketing API и события через Conversions API при разрешениях на рекламу в конфигурации.
- Токен, который принадлежит Business Portfolio клиента, поэтому продолжает работать, если человек, который вошёл, покинет бизнес.
Что Unified Login пока не поддерживает?
Четыре вещи, которые руководство Meta по миграции перечисляет как отсутствующие на запуске. Приложение, которое зависит от одной из них, должно пока остаться на Instagram Login, как советует Meta. Клиенты, которые входят через Facebook Login, сами включают «Разрешить доступ к сообщениям» в приложении Instagram, так как только вход через Instagram показывает этот шаг:
- Handover Protocol.
- Переключение личного аккаунта на профессиональный во время входа; клиенты сначала переключают его в приложении Instagram.
- Вход через приложение Instagram: логин открывается в браузере, поэтому клиентам нужен пароль от Instagram.
- Помощник интеграции API на панели управления приложением.
Как приложение настраивает Unified Login?
Из приложения, принадлежащего Business Portfolio, в разделе «Use cases», затем «Manage messaging & content on Instagram», «Customize», далее «API setup with Unified login». Руководство Meta состоит из четырёх шагов; Standard Access предоставляется разрешениям конфигурации сразу после её сохранения:
- Создайте конфигурацию: разрешения и активы для запроса, в которую всегда входят
instagram_basicиinstagram_manage_messages; сохраните URL перенаправления и скопируйте URL входа. - Создайте тестовые токены, пригласив до 50 Instagram Testers, которые принимают приглашение в разделах «Website permissions», «Apps and websites», «Tester Invites».
- Настройте вебхуки для объекта Instagram в приложении Meta, затем подпишите каждый аккаунт, к которому дан доступ.
- Запросите Advanced Access к разрешениям instagram_* через App Review при приложении в режиме Live.
Как меняются токен и вызовы API?
Код обменивается на сервере с ID приложения Meta и секретом, а не с данными Instagram, на токен Business Integration System User, который принадлежит Business Portfolio клиента. С этим токеном /me возвращает системного пользователя, поэтому приложение читает ID аккаунтов из GET /me/assigned_instagram_accounts и подставляет один в каждый путь. Токен перестаёт работать, если клиент удаляет приложение из Business Portfolio или переносит аккаунт в другой.
Что должна сделать существующая интеграция с Instagram Login?
Ничего срочного: Meta говорит, что такие интеграции продолжают работать и любое изменение появится в журнале изменений. Переход даёт новые функции, но требует проверки и одного повторного подключения на клиента, в таких шагах из руководства Meta по миграции:
- Запросите Advanced Access к соответствию instagram_* для каждого используемого разрешения instagram_business_*.
- Замените URL встраивания на URL входа конфигурации, а учётные данные приложения Instagram на данные приложения Meta.
- Переведите вызовы на ID аккаунта на хосте Graph Facebook Login; ID сообщений приходят в другом формате.
- Подпишите каждый аккаунт заново, так как подписки Instagram Login не переносятся.
- Подключайте клиентов небольшими группами, сохраняя каждый старый токен, пока один вызов и один вебхук не сработают.
Какие разрешения чем заменяются?
Unified Login использует разрешения instagram_* из Facebook Login for Business, и каждое разрешение instagram_business_*, которое приложение Instagram Login имеет сейчас, имеет прямое соответствие. Приложение, у которого уже есть Advanced Access к ним, например из прежней интеграции Facebook Login, не запрашивает его повторно:
Какой вход использует easyCoexistence?
Прямо: Instagram Login. easyCoexistence отправляет владельца на собственную страницу авторизации Instagram с ID своего приложения Instagram и пятью разрешениями instagram_business_*, обменивает код на своём сервере на токен на 60 дней, читает аккаунт через GET /me и подписывает его на поля вебхука comments, messages и mentions на graph.instagram.com. С Instagram Login Meta включает упоминания в уведомления о комментариях. easyCoexistence продлевает этот токен до истечения срока и проверяет аккаунт каждые 6 часов.
Распространённые ошибки
- Отправка Instagram User токена в интеграцию Unified Login. Meta говорит, что такие токены и graph.instagram.com там не работают, поэтому каждому клиенту нужно подключиться заново.
- Вызов /me для аккаунта Instagram. С токеном Unified Login он возвращает системного пользователя интеграции бизнеса; читайте ID из /me/assigned_instagram_accounts.
- Обмен кода с ID приложения Instagram и секретом. Unified Login принимает ID приложения Meta и секрет.
- Удаление подключения Instagram Login до того, как новое заработает. Meta советует оставить оба, пока один вызов и один вебхук не сработают, и предупреждает, что сообщения вебхуков могут приходить дважды.
Токен продлевается, а аккаунт проверяется каждые 6 часов. От US$ 9 до US$ 0,75 за подключение в месяц, снижаясь по мере добавления подключений, с бесплатным пробным периодом 3 дня.
Часто задаваемые вопросы
Instagram Login закрывают?
Meta не объявила даты окончания. В её руководстве по миграции сказано, что существующие интеграции Instagram Login продолжают работать, а любое изменение будет объявлено в журнале изменений Instagram Platform.
Клиентам обязательно входить через Facebook Login?
Нет. Unified Login позволяет войти через аккаунт Instagram, и ни один вариант не требует Страницы. Но нужен доступ к Business Portfolio, которому принадлежит аккаунт Instagram.
Нужна ли Unified Login проверка App Review?
Чтобы подключать клиентов без роли в приложении, да: Advanced Access к каждому разрешению instagram_* в конфигурации через App Review при режиме Live.
Сколько стоит easyCoexistence за аккаунт Instagram?
Каждый подключённый аккаунт Instagram считается одним подключением: от US$ 9 до US$ 0,75 за подключение в месяц, снижаясь по мере добавления подключений, с бесплатным пробным периодом 3 дня.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на