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

Подписка страницы Facebook на вебхуки: эндпоинт subscribed_apps

Страница Facebook подписывается на вебхуки приложения вызовом POST /{page-id}/subscribed_apps, передавая subscribed_fields, например feed,messages, и токен доступа страницы от человека с задачей CREATE_CONTENT, MANAGE или MODERATE, при выданных разрешениях pages_manage_metadata и pages_show_list. Meta отправляет события поля только тогда, когда приложение тоже подписано на это поле. GET показывает подписку, а DELETE её удаляет.

easyCoexistence подписывает каждую подключённую вами страницу на feed, messages и mention через subscribed_apps, отписывает её при удалении и пересылает события страницы на ваш HTTPS-эндпоинт, подписанные секретом этой страницы, через один MCP-коннектор или Partner API.

Both levels

Вебхуки приходят только по полям, подписанным и на уровне страницы, и на уровне приложения. Страница может включить больше полей, чем приложение.

CREATE_CONTENT, MANAGE or MODERATE

Задачи страницы; одна из них нужна человеку, стоящему за токеном, чтобы читать или создавать подписку.

messaging_success

Возвращается вместе с success, когда приложение удаляет подписку на вебхук со страницы через DELETE.

App access token

Что требуется от /{app-id}/subscriptions, чтобы читать, создавать или удалять подписку на уровне приложения.

1 hour

Число неудачных доставок Messenger, после которого Meta отписывает приложение от страницы до новой подписки.

Что делает эндпоинт subscribed_apps?

Он устанавливает приложение на страницу и задаёт, какие поля вебхуков страницы получает приложение. Meta отправляет уведомления только пока приложение установлено на странице и не отключено в её настройках платформы, и только по полям, подписанным на обоих уровнях: страницы, через этот эндпоинт, и приложения, заданным в App Dashboard или через /{app-id}/subscriptions. Страница может быть подписана на больше полей, чем приложение.

Как подписать страницу?

POST на эндпоинт с subscribed_fields, где поля перечислены через запятую, и токеном доступа страницы. Успешный вызов возвращает success true. Если в списке есть messages, токену также нужно разрешение pages_messaging:

Subscribing a Page to three fields
POST https://graph.facebook.com/{page-id}/subscribed_apps
  ?subscribed_fields=feed,messages,mention
  &access_token=<PAGE_ACCESS_TOKEN>

{ "success": true }

Какой токен, задачи и разрешения нужны?

Токен доступа страницы, который привязывает вызов к одной странице, от человека, который может действовать от её имени. Справочники и руководства Meta задают такие требования:

  • Любое поле: человек с задачей CREATE_CONTENT, MANAGE или MODERATE, а также pages_manage_metadata и pages_show_list.
  • messages и другие поля Messenger: дополнительно pages_messaging, на токене от человека, который может выполнять задачу MESSAGING.
  • leadgen: задача ADVERTISE, с leads_retrieval, pages_read_engagement и ads_management.
  • Чтение подписки через GET требует тех же задач и разрешений, что и её создание.

Какой уровень доступа нужен полям?

Advanced Access, для страниц и людей вне ролей самого приложения. При Standard Access уведомления Messenger приходят только от людей с ролью в приложении, например администраторов, разработчиков и тестировщиков. Advanced Access выдаётся отдельно по каждому разрешению через App Review и требует Business Verification; он открывает уведомления клиентам приложения. В руководстве Meta по Messenger публикация приложения указана среди предварительных условий.

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

Вторая половина: поля, которые слушает само приложение, вместе с его callback URL. Её задают в App Dashboard или через POST /{app-id}/subscriptions с токеном доступа приложения, передавая object=page, callback_url, fields, include_values и verify_token; это запускает проверочный запрос Meta. GET на том же эндпоинте показывает callback_url, поля каждого объекта и то, активна ли подписка. Новый POST изменяет поля, не перезаписывая остальные, а DELETE удаляет все подписки или только перечисленные поля.

Как проверить, на что подписана страница?

GET на том же эндпоинте с токеном страницы. Массив data перечисляет каждое приложение, установленное на странице, с его именем, ID и subscribed_fields. Если приложений нет, массив пуст:

Reading a Page's subscriptions
GET https://graph.facebook.com/{page-id}/subscribed_apps
  ?access_token=<PAGE_ACCESS_TOKEN>

{
  "data": [
    {
      "category": "Business",
      "link": "https://example.com/app",
      "name": "<APP_NAME>",
      "id": "<APP_ID>",
      "subscribed_fields": ["feed", "messages", "mention"]
    }
  ]
}

Как удалить подписку?

DELETE /{page-id}/subscribed_apps отвязывает приложение от страницы. Приложение может удалить собственную подписку токеном доступа приложения; в ответе приходят success и messaging_success. Meta также удаляет подписку сама: после часа неудачных доставок Messenger приложение отписывается от страницы и должно подписаться заново, когда его эндпоинт заработает.

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

Он подписывает каждую страницу, которую вы выбираете, сразу после сохранения токена этой страницы: POST /{page-id}/subscribed_apps с subscribed_fields feed,messages,mention. Если Meta отказывает, страница остаётся подключённой, а причину list_social_accounts показывает в last_error. При удалении страницы перед отбрасыванием токена отправляется DELETE /{page-id}/subscribed_apps, а ни один инструмент не обращается к путям subscribed_apps и token, поэтому подпиской управляет только easyCoexistence.

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

  • Вызов эндпоинта с пользовательским токеном доступа. Нужен токен доступа страницы, на которую подписывается приложение.
  • Подписка страницы без подписки приложения. Поле доходит до callback только тогда, когда подписка самого приложения тоже его включает.
  • Пропущенный pages_messaging при подписке на messages. Meta требует его на токене от человека с задачей MESSAGING.
  • Забытая повторная подписка после сбоя. Час неудачных доставок Messenger отписывает приложение, и события перестают приходить, пока POST не отправлен снова.
Настройка с EasyCoexistence

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

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

Нужно ли подписывать каждую страницу отдельно?

Да. subscribed_apps работает для каждой страницы со своим токеном, а подписка на уровне приложения для объекта page действует на страницы, где установлено приложение.

Почему subscribed_apps возвращает ошибку 200?

Meta указывает код 200 как ошибку разрешений для этого эндпоинта. Проверьте, что токен содержит pages_manage_metadata и pages_show_list и выдан человеком с CREATE_CONTENT, MANAGE или MODERATE.

Можно ли подписать страницу через Graph API Explorer?

Да. В руководстве Meta выбирается приложение, получается пользовательский токен с pages_manage_metadata, он обменивается на токен страницы, и POST отправляется на {page-id}/subscribed_apps.

Можно ли добавить поля вебхука к странице, подключённой к easyCoexistence?

Не через его инструменты: ни один из них не обращается к путям subscribed_apps, а страница остаётся подписанной на feed, messages и mention, поля, которые easyCoexistence пересылает.

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

Поля вебхука Страницы Facebook: полный списокMeta документирует 64 поля вебхука Страницы Facebook: feed, mention, поля Messenger вроде messages и поля профиля, а также нужное разрешение.Верификация вебхука Facebook: hub.challenge и X-Hub-Signature-256Верификация вебхука Facebook: вернуть hub.challenge при совпадении hub.verify_token, затем проверять X-Hub-Signature-256 каждого события по App Secret.Разрешения Facebook Page API и требования App ReviewДевять разрешений Facebook Page, что открывает каждое и что App Review требует: расширенный доступ, верификация бизнеса, запись экрана.Токен доступа к странице Facebook: как долго он действует и что его аннулируетКак получить токен доступа к странице Facebook без срока действия, кто может его получить и что заставляет Meta перестать его принимать.Вебхук ленты Facebook Страницы: события комментариев, публикаций и реакцийЧто передаёт вебхук ленты Facebook Страницы при комментариях, публикациях и реакциях: поля item и verb, структура тела запроса Meta и подписка Страницы.Протокол передачи Messenger: общий доступ к диалогам Страницы для ИИ-агента и людейКак диалоги Messenger Страницы переходят между приложениями и Meta Business Suite: Conversation Routing, pass_thread_control и владелец треда.

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

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

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

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