Почему подключение к Instagram API перестаёт работать и как его сохранить
Подключение Instagram API перестаёт работать, когда Meta больше не принимает его токен или аккаунт перестаёт подходить под требования: долгоживущий токен не обновлялся 60 дней, сменён пароль, владелец удалил разрешение или всё приложение, аккаунт переключён на личный или на него наложено ограничение. Каждый случай возвращает свою ошибку, и чаще всего владелец исправляет её, войдя заново.
easyCoexistence круглосуточно следит за каждым подключением Instagram: обновляет токен задолго до истечения 60 дней, проверяет аккаунт каждые 6 часов, один раз пишет вам на почту, когда Meta отказывает в доступе, и отправляет платформам событие channel.disconnected, чтобы пропавшее подключение возвращалось одним входом.
Токены Instagram, не обновлённые в течение 60 дней, истекают и больше не могут быть обновлены.
Подкод Graph API под кодом 190 для сессии, завершённой сменой пароля; человеку нужно войти заново.
Доля неудачных доставок вебхуков сообщений, после которой Meta их отключает и отписывает приложение от аккаунта.
Meta может прекратить доступ приложения к разрешениям или функциям, которыми оно не пользовалось в течение 28 дней.
Как часто easyCoexistence проверяет каждый подключённый аккаунт Instagram и продлевает токен задолго до истечения 60 дней.
Почему подключение к Instagram API перестаёт работать?
Потому что Meta перестаёт принимать токен или аккаунт перестаёт подходить для API. В документации Meta названы причины; для каждой указано, что возвращает API и какой шаг восстанавливает доступ. Большинство из них сначала проявляется как неудачный вызов, поэтому проверки ниже ищут их по расписанию:
| What the API returns | What restores it | |
|---|---|---|
| Token not refreshed for 60 days | Code 190; a refresh is no longer possible | The owner signs in again |
| Password changed | Code 190 with subcode 460 | The owner signs in again |
| Permission missing or removed | Code 10, or a code from 200 to 299 | A new sign-in that grants it |
| App removed in Instagram's settings | A call to the app's deauthorize callback | A 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 off | Code 200 with subcode 2534041, on DMs | The owner turns the setting back on |
| Account restricted, inactive or checkpointed | Code 25 with subcode 2207050 | The owner acts in the Instagram app |
| Webhook endpoint failing for an hour | A Webhooks Disabled alert, the account unsubscribed | A 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.
От US$ 9 до US$ 0,75 за подключение в месяц, снижаясь по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Продлевает ли использование токена Instagram срок его действия?
Нет. Продлевает только обновление долгоживущего токена, и токен, который 60 дней не обновлялся, истекает, как бы часто им ни пользовались.
Удаляет ли Instagram бизнес-приложение после 90 дней без использования?
Нет. Справочный центр Instagram сообщает, что приложения с разрешениями на управление бизнес- и креатор-аккаунтами не истекают через 90 дней бездействия.
Учитывается ли отключённый аккаунт в счёте easyCoexistence?
Да, пока вы его не переподключите или не удалите. Аккаунт, владелец которого удалил приложение в настройках Instagram, выходит из подсчёта, как только Meta сообщает об удалении.
Сколько стоит мониторинг аккаунта Instagram в easyCoexistence?
Мониторинг входит в каждое подключение: от US$ 9 до US$ 0,75 за подключение в месяц, снижаясь по мере добавления подключений, первые 3 дня бесплатно.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на