Почему подключение Facebook Page API перестаёт работать и как его сохранить
Подключение Страницы Facebook перестаёт работать, когда Meta перестаёт принимать её токен или перестаёт отправлять её события: токен получен из краткосрочного входа, пользователь сменил пароль (ошибка 190, подкод 460), потерял роль на Странице (492) или удалил приложение в разделе «Business Integrations» (458), разрешение не использовалось 90 дней, приложение оставалось неактивным или Meta ограничила Страницу.
easyCoexistence берёт токен каждой Страницы из долгоживущего входа, проверяет Страницу каждые 6 часов и пишет вам письмо, когда Meta отклоняет токен.
Срок жизни стандартных пользовательских токенов и токенов Страницы в Meta; токен Страницы, полученный из долгоживущего пользовательского токена, не имеет срока истечения.
Если в течение этого срока нет входов, вызовов API или вебхуков, Meta считает приложение неактивным и аннулирует все его токены.
Разрешения Страницы, например pages_manage_posts и read_insights, не истекают вместе с 90-дневным периодом доступа к данным.
Ограничение Page Integrity, которое блокирует отправку сообщений через Messenger Platform API от имени Страницы.
Как часто easyCoexistence проверяет каждую подключённую Страницу лёгким вызовом Graph и пишет владельцу письмо, если Meta отклонила токен.
Что может привести к остановке подключения Страницы?
Причины делятся на четыре уровня: вход пользователя, разрешения и статус приложения, сама Страница и подписка на вебхук. Каждая проявляется по-своему, и большинство возвращается как ошибка 190 с подкодом, который называет причину:
Почему токен Страницы может истечь за несколько часов?
Потому что он был прочитан из /me/accounts с краткосрочным пользовательским токеном, и поэтому он тоже краткосрочный. Стандартные пользовательские токены и токены Страницы в Meta истекают в течение часов: у краткосрочного токена это примерно от одного до двух часов. Если обменять его на сервере через fb_exchange_token, пользовательский токен живёт около 60 дней, а токен Страницы, прочитанный с его помощью, не имеет срока истечения. Meta не продлевает уже истёкший токен: возвращается ошибка «Сессия истекла» с подкодом 463, и человеку нужно войти снова.
Что происходит после смены пароля или проверки безопасности?
Meta аннулирует токены этого человека. Выход из системы или смена пароля возвращают ошибку 190 с подкодом 460: «Сессия недействительна, так как пользователь вышел из системы». Meta предупреждает, что события безопасности могут аннулировать токены раньше ожидаемого срока истечения. Подкоды 459 и 464 означают, что сам аккаунт требует внимания: человеку нужно войти на facebook.com и устранить проблему, а затем снова войти в приложение. В остальных случаях помогает новый вход: этим человеком или кем-то другим, у кого есть роль на Странице.
Что происходит, когда человек теряет роль на Странице?
Его токен Страницы перестаёт работать с ошибкой 190, подкод 492. Meta описывает это так: пользователь, связанный с токеном доступа к Странице, больше не имеет подходящей роли на Странице. Токены выдаются отдельно для каждой Страницы, человека и приложения, поэтому токены других людей с ролью продолжают работать. Решение: подключить Страницу заново из аккаунта, у которого ещё есть полный контроль или доступ к задачам, желательно того, кто не собирается покидать бизнес.
Что происходит, когда кто-то удаляет приложение в разделе «Business integrations»?
Meta аннулирует пользовательские токены доступа, которые приложение получило от этого человека, и токены Страницы, прочитанные с их помощью, тоже перестают работать: ошибка 190, подкод 458, пользователь не авторизовал приложение. Удалить приложение можно в настройках Facebook, в разделе «Business integrations»; после этого Meta вызывает обратный вызов deauthorize приложения. Токен системного пользователя аннулируется так же, но в Business Manager: Business Settings, Integrations, Connected apps. Приложение может завершить собственный доступ запросом DELETE /{user-id}/permissions.
Истекают ли разрешения Страницы через 90 дней?
Существуют два разных правила на 90 дней, и на разрешения Страницы действует только одно. Истечение доступа к данным, которое отключает приложение через 90 дней после последней активности человека, не касается pages_show_list, pages_manage_posts, pages_messaging, read_insights и других разрешений Страницы, которые Meta перечисляет как не истекающие. А вот истечение разрешения действует: разрешение, которым приложение не пользовалось 90 дней, может истечь, даже одобренное в App Review, и человеку придётся выдать его заново. Вызовы, которым оно нужно, падают с кодом 10 или кодом из диапазона 200, пока новый вход не вернёт разрешение.
Может ли приложение потерять доступ целиком?
Да, тремя задокументированными способами, о которых Meta предупреждает срочным уведомлением во входящих оповещениях панели управления приложением. Приложение, у которого 90 дней нет входов, вызовов Graph API или Marketing API и уведомлений вебхуков, считается неактивным, и Meta аннулирует все его токены. Восстановление из панели управления обновляет приложение до последней версии, но старые токены остаются недействительными, а разрешения, снятые из-за неиспользования, проходят App Review заново. Нужно пройти ежегодную Data Use Checkup, а нарушение условий или политик Meta может ограничить доступ к API или отозвать разрешения.
Что происходит, когда Meta ограничивает Страницу?
Ограниченные действия перестают работать: ошибка 368, временная блокировка за нарушение политики, или для сообщений код 10 с подкодом 1893063. Page Integrity API от Meta показывает, какое именно: GET /{page-id}/page_status с разрешением pages_manage_metadata возвращает статус ok, warning, restricted или suspended, каждое действующее ограничение, например page_publish, page_read_only, page_messaging или page_messaging_api, с его expiration_time, и рекомендуемые действия, например FILE_APPEAL. Поле вебхука business_integrity сообщает об изменениях по мере их возникновения.
Почему события перестают приходить, хотя вызовы API работают?
Потому что вебхуки отказывают по собственным правилам. После часа неудачных доставок Meta отправляет оповещение «Webhooks Disabled» и отписывает приложение от Страницы, пока оно не подпишется снова. Meta ничего не присылает для Страницы, которая отключила App platform в настройках приложения. Токен при этом может оставаться действительным в обоих случаях, поэтому после сбоя проверьте GET /{page-id}/subscribed_apps, а когда эндпоинт снова ответит, отправьте на него POST с токеном Страницы.
Как заметить разорванное подключение до сбоя публикации?
Проверяя по расписанию, потому что Meta не уведомляет приложение, когда токен становится недействительным. Лёгкий вызов, например GET /{page-id}?fields=id,name с токеном Страницы, падает так же, как упала бы публикация. debug_token, вызванный с ID и секретом приложения в качестве токена доступа, возвращает is_valid, expires_at и выданные области доступа (scopes), а также код ошибки и подкод для токена, который уже не работает. page_status показывает ограничения, а обратный вызов deauthorize сообщает об удалённом приложении.
curl -G "https://graph.facebook.com/v26.0/debug_token" \
--data-urlencode "input_token=$PAGE_TOKEN" \
--data-urlencode "access_token=$APP_ID|$APP_SECRET"
# data.is_valid, data.expires_at, data.scopes, data.granular_scopes,
# and data.error.code with data.error.subcode once the token stops workingКак переподключить Страницу?
Тем же потоком, которым она подключалась. Его запускает человек, у которого всё ещё есть роль на Странице, после устранения причины, если она есть: аккаунт на проверке (checkpoint) входит на facebook.com, ограничение снимается по рекомендуемому действию, а сбойный эндпоинт снова отвечает 200. Новый вход возвращает новые строки токенов, поэтому замените сохранённые, а не храните оба:
Что делает easyCoexistence, когда подключение Страницы рвётся?
Он следит за разрывами, которые видит, и сообщает о них. Каждые 6 часов он проверяет каждую подключённую Страницу вызовом GET /{page-id}?fields=id,name. Когда Meta отклоняет токен с ошибкой 190 или 102 при этой проверке или при любом вызове инструмента, Страница получает статус «Reconnect needed», её владелец получает одно письмо, а партнёрская платформа получает channel.disconnected. Другие отказы, например отсутствующее разрешение или блокировка по политике, возвращаются в результате инструмента вместе с кодом и сообщением Meta.
Когда кто-то удаляет приложение в разделе «Business integrations», обратный вызов deauthorize от Meta доходит до easyCoexistence, который удаляет Страницы, подключённые этим человеком, стирает их токены и назначения вебхуков, снимает их со счёта и отправляет channel.removed. Новый вход из панели управления возвращает Страницу как то же подключение, с её правилами комментариев и автоматизациями, снова подписанное на ленту, сообщения и упоминания. После статуса «Reconnect needed» назначение вебхука тоже остаётся; после удаления set_social_webhook_destination задаёт его заново с новым секретом.
Распространённые ошибки
- Повтор запроса при ошибке 190. Отклонённый токен падает одинаково при каждом вызове, и только новый вход человека с ролью на Странице даёт действительный токен.
- Переподключение, чтобы снять ограничение. Новый токен не меняет статус Страницы; его меняют рекомендуемые действия в page_status, например апелляция.
- Запрос разрешения, которым продукт почти не пользуется. Не используемое 90 дней, оно может истечь, и вызовы, которым оно нужно, начнут падать; запрашивайте его, когда выходит функция.
- Хранение старого токена после переподключения. Новый вход возвращает другую строку токена, и задача, которая всё ещё держит старый, продолжает падать с ошибкой 190.
Один вход в Facebook возвращает Страницу как то же подключение, с её правилами комментариев и автоматизациями. От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений цена снижается, с бесплатным пробным периодом на первые 3 дня.
Часто задаваемые вопросы
Перестаёт ли токен Страницы работать, когда истекает 60-дневный пользовательский токен?
Нет, если он был прочитан из /me/accounts с этим долгоживущим пользовательским токеном: у такого токена Страницы нет срока истечения, хотя причины на этой странице всё равно могут его остановить.
Сообщит ли мне Meta, что токен Страницы перестал работать?
Не для токена, который стал недействительным: следующий вызов вернёт ошибку. Meta вызывает обратный вызов deauthorize, когда кто-то удаляет приложение, а о рисках для всего приложения предупреждает во входящих оповещениях панели управления.
Может ли токен другого человека сохранить Страницу подключённой?
Да. Токены выдаются отдельно для каждой Страницы, человека и приложения, поэтому токен от другого человека, у которого всё ещё есть роль на Странице, продолжает работать, когда доступ одного человека заканчивается.
Сколько стоит easyCoexistence для Страницы Facebook?
От US$ 9 до US$ 0,75 за подключение в месяц; цена зависит от числа подключений. Каждая Страница считается одним подключением, а первые 3 дня бесплатного пробного периода ничего не стоят.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на