Подписка страницы 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.
Вебхуки приходят только по полям, подписанным и на уровне страницы, и на уровне приложения. Страница может включить больше полей, чем приложение.
Задачи страницы; одна из них нужна человеку, стоящему за токеном, чтобы читать или создавать подписку.
Возвращается вместе с success, когда приложение удаляет подписку на вебхук со страницы через DELETE.
Что требуется от /{app-id}/subscriptions, чтобы читать, создавать или удалять подписку на уровне приложения.
Число неудачных доставок Messenger, после которого Meta отписывает приложение от страницы до новой подписки.
Что делает эндпоинт subscribed_apps?
Он устанавливает приложение на страницу и задаёт, какие поля вебхуков страницы получает приложение. Meta отправляет уведомления только пока приложение установлено на странице и не отключено в её настройках платформы, и только по полям, подписанным на обоих уровнях: страницы, через этот эндпоинт, и приложения, заданным в App Dashboard или через /{app-id}/subscriptions. Страница может быть подписана на больше полей, чем приложение.
Как подписать страницу?
POST на эндпоинт с subscribed_fields, где поля перечислены через запятую, и токеном доступа страницы. Успешный вызов возвращает success true. Если в списке есть messages, токену также нужно разрешение pages_messaging:
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. Если приложений нет, массив пуст:
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 не отправлен снова.
От 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 пересылает.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на