Токен доступа к странице Facebook: как долго он действует и что его аннулирует
Долгоживущий токен страницы Facebook не имеет даты окончания срока действия. Приложение получает его, обменяв вход пользователя на долгоживущий пользовательский токен (он действует около 60 дней), а затем запрашивая /me/accounts. Человек должен иметь полный контроль над страницей или доступ к задачам на ней. Meta всё равно аннулирует токен при определённых условиях, например если этот человек теряет роль на странице.
easyCoexistence получает долгоживущий токен для каждой подключаемой страницы, хранит его в зашифрованном виде, проверяет страницу каждые 6 часов и отправляет вам письмо, когда Meta перестаёт его принимать.
Долгоживущие токены доступа к страницам Facebook, созданные из долгоживущего пользовательского токена, не имеют даты окончания срока действия.
Как долго обычно действует долгоживущий пользовательский токен доступа; краткоживущие токены действуют примерно от одного до двух часов.
Подкод ошибки для токена страницы, у владельца которого больше нет нужной роли на странице.
Если приложение не использует разрешение в течение этого срока, человек должен выдать его снова.
Одна из задач страницы, которые может назначить API Meta, наряду с CREATE_CONTENT, MODERATE, MESSAGING и ANALYZE.
Истекает ли токен доступа к странице Facebook?
Это зависит от пользовательского токена, из которого он получен. Стандартные пользовательские токены и токены страниц от Meta краткоживущие и истекают в течение нескольких часов, а долгоживущий пользовательский токен обычно действует около 60 дней. Токен страницы, созданный из долгоживущего пользовательского токена, не имеет даты окончания: по словам Meta, он истекает или аннулируется только при определённых условиях. Meta также предупреждает не полагаться на срок жизни токенов, который может измениться без предупреждения.
Как получить долгоживущий токен страницы?
За три запроса после того, как человек входит через Facebook Login for Business. Приложение обменивает полученный код на краткоживущий пользовательский токен, затем меняет его на долгоживущий через GET /oauth/access_token с grant_type=fb_exchange_token и секретом приложения. По словам Meta, этот запрос нужно делать с сервера. GET /me/accounts с долгоживущим пользовательским токеном возвращает каждую страницу, к которой человек дал доступ, с её ID, задачами этого человека и токеном страницы.
Кто может подключить страницу и получить её токен?
Тот, кто владеет страницей или может выполнять на ней задачи. В настройках страниц Facebook и Meta Business Suite это значит полный контроль или более узкий доступ к задачам, например к контенту или сообщениям. В обзоре Pages API Meta добавляет, что человек с правами администратора может выполнять все задачи. Токены страниц уникальны для каждой страницы, человека и приложения, поэтому два человека, подключающие одну страницу, получают разные токены. Названия в интерфейсе Facebook соответствуют задачам API так:
Какая задача нужна для каждого действия?
Meta проверяет при каждом запросе, есть ли у человека, стоящего за токеном, задача, разрешающая действие, поэтому подключайте страницу из аккаунта, доступ которого покрывает нужную работу:
- Текстовые посты, ссылки и фото:
CREATE_CONTENT. - Видеопосты: задачи уровня администратора согласно обзору Video API от Meta.
- ID комментариев и ответы от имени страницы: MODERATE.
- Ответы в Messenger и личные ответы: MESSAGING.
- Аналитика: ANALYZE.
- Вебхуки ленты:
CREATE_CONTENT, MANAGE или MODERATE; поле messages: MESSAGING.
Что аннулирует токен страницы?
Meta сообщает о токене, который больше не принимает, кодом ошибки 190, или 102 для сессии, а также подкодом аутентификации, объясняющим причину. Человек может также аннулировать пользовательские токены приложения, удалив его в разделе «Бизнес-интеграции» в настройках Facebook. Разрешение, которое приложение не использовало 90 дней, нужно выдать заново. Подкоды, которые перечисляет Meta:
- 458: человек не входил в приложение.
- 459 или 464: человеку нужно войти на facebook.com, чтобы исправить проблему с аккаунтом.
- 460: пароль человека был изменён.
- 463 или 467: срок действия токена истёк, он отозван или иным образом недействителен.
- 492: у человека, стоящего за токеном страницы, больше нет подходящей роли на странице.
Что easyCoexistence делает, чтобы страница оставалась подключённой?
При входе он получает токен каждой страницы из долгоживущего пользовательского токена, поэтому по расписанию его не нужно продлевать, и хранит его в зашифрованном виде. Каждые 6 часов он проверяет каждую подключённую страницу лёгким запросом Graph. Когда Meta отказывает в токене с ошибкой 190 или 102, при такой проверке или при любом вызове инструмента, страница помечается как требующая переподключения, её владелец получает письмо, а платформа-партнёр получает channel.disconnected. Повторный вход из аккаунта, который управляет страницей, восстанавливает подключение.
Можно ли использовать токен страницы самостоятельно?
Не сам токен. get_social_credentials возвращает ID страницы и базовый адрес Graph API на graph.facebook.com, но никогда токен страницы (условия Meta); токен не истекает, пока страница остаётся подключённой, хотя Meta всё равно может его аннулировать. Инструменты MCP выполняют запросы от имени страницы без раскрытия токена; токен и подписки на вебхуки остаются за easyCoexistence.
Распространённые ошибки
- Запрос долгоживущего токена из браузера. Обмен содержит секрет приложения, поэтому Meta советует делать этот запрос только с сервера, никогда на стороне клиента.
- Попытка продлить истёкший токен. Meta не превращает истёкший токен в долгоживущий; человеку нужно пройти вход заново.
- Подключение через сотрудника, который вот-вот уйдёт из бизнеса. Токен страницы опирается на его доступ и перестаёт работать, когда он теряет роль, поэтому подключайте страницу из аккаунта, который останется.
- Хранение токенов в поле фиксированной длины. Meta со временем меняет длину токенов и советует тип переменной длины без заданного максимума.
Ваш ИИ-ассистент работает через него с помощью инструментов MCP, которые добавляют токен за вас, а get_social_credentials передаёт вашему собственному коду ID страницы и базовый адрес API. От US$ 9 до US$ 0,75 за подключение в месяц, с уменьшением по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Теряют ли разрешения Facebook силу, если приложение перестаёт их использовать?
Да. Если приложение не использует разрешение 90 дней, человеку нужно выдать его заново.
Можно ли сделать долгоживущим истёкший токен Facebook?
Нет. Meta не превращает истёкший токен в долгоживущий, поэтому человеку нужно пройти вход заново, прежде чем можно будет получить новый долгоживущий токен страницы.
Что означает ошибка 190 для страницы Facebook?
Что Meta больше не принимает токен. Подкод объясняет причину, например 460 после смены пароля или 492, когда человек потерял роль на странице.
Обновляет ли easyCoexistence токены страниц Facebook?
Нет, так как по расписанию обновлять нечего: хранимые токены страниц не имеют даты окончания. Вместо этого он проверяет каждую страницу каждые 6 часов и отправляет вам письмо, если её нужно подключить заново.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на