ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Почему подключение к Instagram API перестаёт работать и как его сохранить

Подключение Instagram API перестаёт работать, когда Meta больше не принимает его токен или аккаунт перестаёт подходить под требования: долгоживущий токен не обновлялся 60 дней, сменён пароль, владелец удалил разрешение или всё приложение, аккаунт переключён на личный или на него наложено ограничение. Каждый случай возвращает свою ошибку, и чаще всего владелец исправляет её, войдя заново.

easyCoexistence круглосуточно следит за каждым подключением Instagram: обновляет токен задолго до истечения 60 дней, проверяет аккаунт каждые 6 часов, один раз пишет вам на почту, когда Meta отказывает в доступе, и отправляет платформам событие channel.disconnected, чтобы пропавшее подключение возвращалось одним входом.

60 days

Токены Instagram, не обновлённые в течение 60 дней, истекают и больше не могут быть обновлены.

460

Подкод Graph API под кодом 190 для сессии, завершённой сменой пароля; человеку нужно войти заново.

1 hour

Доля неудачных доставок вебхуков сообщений, после которой Meta их отключает и отписывает приложение от аккаунта.

28 days

Meta может прекратить доступ приложения к разрешениям или функциям, которыми оно не пользовалось в течение 28 дней.

6 hours

Как часто easyCoexistence проверяет каждый подключённый аккаунт Instagram и продлевает токен задолго до истечения 60 дней.

Почему подключение к Instagram API перестаёт работать?

Потому что Meta перестаёт принимать токен или аккаунт перестаёт подходить для API. В документации Meta названы причины; для каждой указано, что возвращает API и какой шаг восстанавливает доступ. Большинство из них сначала проявляется как неудачный вызов, поэтому проверки ниже ищут их по расписанию:

What the API returnsWhat restores it
Token not refreshed for 60 daysCode 190; a refresh is no longer possibleThe owner signs in again
Password changedCode 190 with subcode 460The owner signs in again
Permission missing or removedCode 10, or a code from 200 to 299A new sign-in that grants it
App removed in Instagram's settingsA call to the app's deauthorize callbackA new sign-in, if the owner wants it back
Switched to a personal account(#10) Access is denied because the instagram account type is not business or creator.Back to Business or Creator, then a new sign-in
Allow access to messages offCode 200 with subcode 2534041, on DMsThe owner turns the setting back on
Account restricted, inactive or checkpointedCode 25 with subcode 2207050The owner acts in the Instagram app
Webhook endpoint failing for an hourA Webhooks Disabled alert, the account unsubscribedA working endpoint, then a new subscription

Когда истекает токен и когда его ещё можно обновить?

При входе через Instagram долгоживущий токен действует 60 дней с момента последнего обновления. Обновление с grant_type=ig_refresh_token продлевает его ещё на 60 дней, если токену не меньше 24 часов, он не истёк и владелец выдал разрешение instagram_business_basic. Когда 60 дней проходят, вызовы возвращают код 190, и помогает только новый вход. При Unified Login настройка конфигурации определяет, истекает ли токен вообще.

Что делают смена пароля и снятое разрешение?

Смена пароля может завершить сессию, к которой принадлежит токен: справочник ошибок Graph API от Meta описывает это как код 190 с подкодом 460, и человек должен войти в приложение заново. Разрешение, которое никогда не выдавали или которое сняли, возвращает код 10 или код от 200 до 299; в личных сообщениях код 200 с подкодом 2534041 означает, что владелец отключил доступ к сообщениям. Условия платформы Meta также позволяют ей прекратить доступ приложения к разрешению или функции, которыми не пользовались 28 дней.

Что происходит, когда владелец удаляет приложение?

Его доступ к непубличным данным прекращается. Владелец удаляет приложение в Instagram: Website permissions, Apps and websites, Active, а Meta вызывает URL колбэка деавторизации, сохранённый в настройках входа через бизнес-аккаунт. Справочный центр Instagram сообщает, что после удаления приложение получает доступ только к публичной информации аккаунта, поэтому подключение завершено, пока владелец не войдёт снова.

Что происходит, когда аккаунт меняет тип или получает ограничение?

Любое из этого выводит аккаунт за пределы того, что обслуживает API. API Meta работает только с профессиональными аккаунтами; таблица устранения неполадок Unified Login выдаёт для аккаунта, переключённого на личный, сообщение (#10) «Access is denied because the instagram account type is not business or creator». Владелец переключает аккаунт обратно и подключается снова. Ограниченный, неактивный или находящийся на проверке аккаунт возвращает код 25 с подкодом 2207050, который владелец устраняет в приложении Instagram.

Почему перестают приходить вебхуки?

Из-за неработающего эндпоинта. Meta повторяет уведомление Instagram в течение до 36 часов, но доставки сообщений строже: после 15 минут сбоев аккаунт разработчика получает оповещение, а через час Meta отправляет оповещение Webhooks Disabled и отписывает приложение от аккаунта. Когда эндпоинт снова работает, POST /<IG_ID>/subscribed_apps с теми же полями снова включает уведомления.

Как заметить сбой раньше пользователей?

Проверяя подключение по расписанию, а не дожидаясь, пока публикация не провалится:

  • Сохраняйте expires_in из каждого обмена и обновления токена и обновляйте его задолго до 60-го дня, когда токену уже больше суток.
  • Делайте дешёвый аутентифицированный вызов по расписанию, например GET /me?fields=user_id,username, и считайте код 190 или 102 сигналом к переподключению.
  • Поднимите URL колбэка деавторизации, чтобы удаление в настройках Instagram сразу доходило до вас.
  • Читайте Developer Alerts и деловую почту, привязанную к приложению, куда Meta присылает уведомления о вебхуках и проверках.
  • Логируйте код, подкод и fbtrace_id каждой ошибки по аккаунту, чтобы ограничение отличалось от неверного запроса.

Как переподключить каждый случай?

Большинство причин решается одним шагом: владелец аккаунта входит заново, и выдаётся новый код и токен. Исключения касаются настроек, которые владелец меняет в приложении Instagram:

  • Истёкший токен, смена пароля, удалённое приложение или разрешение: отправьте владельца на вход снова и пусть он одобрит разрешения.
  • Личный аккаунт: переключите его на Business или Creator в приложении Instagram, затем войдите заново.
  • Сообщения отключены: включите Allow access to messages в разделе Connected tools; новый вход не нужен.
  • Ограниченный аккаунт: выполните то, что просит приложение Instagram; новый вход ничего не меняет.
  • Вебхуки отключены: исправьте эндпоинт, затем снова подпишите аккаунт.

Что easyCoexistence делает, чтобы подключение не пропадало?

Он круглосуточно следит за каждым подключённым аккаунтом Instagram. Токен обновляется, когда остаётся меньше 20 из 60 дней; аккаунт проверяется каждые 6 часов через GET /me. Подключение помечается для переподключения в тот момент, когда Meta отказывает в токене, будь то при этой проверке или при вызове инструмента. Вебхуки Meta принимаются сразу и пересылаются потом. Когда владелец удаляет приложение в настройках Instagram, колбэк деавторизации Meta завершает подключение и исключает его из счёта.

Как easyCoexistence сообщает о сбое и как переподключиться?

Один раз, по электронной почте, с названием аккаунта и кнопкой перехода на страницу канала; платформы также получают подписанное событие channel.disconnected. Пока владелец не действует, list_social_accounts показывает статус и последнюю ошибку Meta, а инструменты отвечают, что аккаунт нужно переподключить. Переподключение требует одного входа под тем же аккаунтом Instagram, который восстанавливает то же подключение с его настройками.

Распространённые ошибки

  • Обновление токена только после неудачного вызова. Когда он истёк, Meta отказывает в обновлении, поэтому планируйте продление, пока токен ещё действителен.
  • Отправка ограниченного аккаунта на повторный вход. Код 25 с подкодом 2207050 описывает состояние аккаунта, которое владелец устраняет в приложении Instagram.
  • Незаданный URL колбэка деавторизации. Удаление в настройках Instagram тогда проявится, только когда упадёт следующий вызов.
  • Исправление неработающего эндпоинта и ожидание. После оповещения Webhooks Disabled уведомления остаются выключенными, пока аккаунт снова не будет подписан через POST /<IG_ID>/subscribed_apps.
Настройка с EasyCoexistence

От US$ 9 до US$ 0,75 за подключение в месяц, снижаясь по мере добавления подключений, первые 3 дня бесплатно.

Часто задаваемые вопросы

Продлевает ли использование токена Instagram срок его действия?

Нет. Продлевает только обновление долгоживущего токена, и токен, который 60 дней не обновлялся, истекает, как бы часто им ни пользовались.

Удаляет ли Instagram бизнес-приложение после 90 дней без использования?

Нет. Справочный центр Instagram сообщает, что приложения с разрешениями на управление бизнес- и креатор-аккаунтами не истекают через 90 дней бездействия.

Учитывается ли отключённый аккаунт в счёте easyCoexistence?

Да, пока вы его не переподключите или не удалите. Аккаунт, владелец которого удалил приложение в настройках Instagram, выходит из подсчёта, как только Meta сообщает об удалении.

Сколько стоит мониторинг аккаунта Instagram в easyCoexistence?

Мониторинг входит в каждое подключение: от US$ 9 до US$ 0,75 за подключение в месяц, снижаясь по мере добавления подключений, первые 3 дня бесплатно.

Читайте дальше

Токены доступа Instagram: долгоживущие токены, 60 дней и обновлениеКак работают токены доступа Instagram Login: токен на один час после входа, долгоживущий на 60 дней и обновление через 24 часа.Instagram API на Python и Node.js: рабочие примерыРабочий код на Python и Node.js для Instagram API: публикация фото и Reel, ответы на комментарии, инсайты, проверка вебхуков и обработка ошибок.Автоматизация Instagram: что приводит к ограничению аккаунтов, официальный API и ботыЧто говорят условия Instagram и Meta об автоматизации, почему боты с паролем попадают под проверку и как отвечать в Direct и комментариях по правилам Meta.Как подключить аккаунт Instagram к API или ИИ-агентуКак подключить аккаунт Instagram к API или ИИ-агенту: вход через Instagram, какое разрешение что даёт, доступ к сообщениям и ссылки для клиентов.Разрешения Instagram API: области доступа для каждой функцииРазрешения, которые API Instagram использует с Instagram Login: от instagram_business_basic до manage_insights и что нужно каждой функции.Instagram API в 2026 году: от приложения до первой публикацииInstagram API в 2026 году по шагам: аккаунт, вход, приложение Meta, разрешения, токены, первая публикация, комментарии, сообщения, вебхуки и лимиты.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на