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

Поля вебхука Страницы Facebook: полный список

Справочник Meta по вебхукам Страницы описывает 64 поля подписки: feed для публикаций, комментариев и реакций, mention для упоминаний Страницы, поля Messenger, например messages, message_echoes, messaging_postbacks и message_reads, и поля профиля, например name, picture, hours и website. Каждому полю нужно разрешение pages_manage_metadata, а приложение получает поле только тогда, когда оно подписано и на уровне приложения, и самой Страницей через subscribed_apps.

easyCoexistence подписывает каждую подключённую Страницу на feed, messages и mention и пересылает эти события на ваш HTTPS-эндпоинт по мере их поступления, подписывая заголовком X-EC-Signature, а правила комментариев и автоматизации работают с новыми комментариями и сообщениями.

64

Поля подписки, описанные в справочнике Meta по вебхукам Страницы: от feed и mention до полей Messenger и профиля.

pages_manage_metadata

Разрешение, которое администратор Страницы с привилегиями MODERATE должен выдать до того, как вебхуки Страницы попадут в приложение.

message_echoes

Отдельное поле Messenger для сообщений, которые отправляет Страница; доступно только для диалогов Messenger.

ADVERTISE

Задача Страницы для подписки на leadgen: leads_retrieval, ads_management, pages_read_engagement и pages_manage_metadata.

Both levels

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

Как организованы поля вебхука Страницы?

Meta описывает их на одной справочной странице для объекта Page, и они делятся на три группы: активность на Странице и вокруг неё, диалоги Messenger и изменения собственных данных Страницы. Изменения feed, mention и профиля приходят в entry.changes, где указано поле каждого изменения, либо в changed_fields, если настройка Include Values отключена; события Messenger приходят в entry.messaging или в entry.standby для приложения, которое не владеет диалогом.

Какие поля отражают активность на Странице?

Двенадцать полей описывают контент и активность, а не диалоги. Например, новый комментарий приходит в feed как изменение с item со значением comment и verb со значением add, наряду с реакциями, репостами и собственными публикациями Страницы. Что передаёт каждое поле, по справочнику Meta:

feedNearly all changes to the Page's feed: posts, comments, reactions, shares; likes only below 10,000 likes
mentionNew mentions of the Page in posts and comments; some IDs it returns cannot be queried
ratingsNew ratings, and comments or reactions on a rating
videosChanges to the encoding status of a video on the Page
live_videosChanges to a live video's status, with its ID
leadgenNew leads from the Page's lead ads, with leadgen_id, form_id and ad_id
group_feedComments on the Page's posts in the business's Facebook Group
product_reviewA product item's review status: pending, approved, rejected or outdated
inbox_labelsLabel changes on people in the Page inbox: the user, the action and the label
page_upcoming_changeUpcoming changes to the Page, with their type and effective time
page_change_proposalProposals to change the Page, created, accepted or rejected
invoice_access_invoice_draft_changeChanges to an invoice draft, such as its shipping address

Какие поля передают события Messenger?

У Messenger самый длинный список, и руководство Meta по вебхукам Messenger описывает, что передаёт каждое поле. Эти тринадцать полей охватывают диалоги Страницы. Поле standby, которое передаёт сообщения приложению, не владеющему диалогом, описано в этом руководстве, а не в справочнике Страницы:

messagesA message from a person, through any entry point, with text or attachments
message_echoesA message the Page sent, with the app_id of the app that sent it
message_deliveriesA message from the Page was delivered
message_readsThe person read a message from the Page
message_reactionsThe person reacted to a message from the Page
message_editsThe person edited a message they had sent
messaging_postbacksA tap on a postback button, Get Started or a persistent menu item
messaging_referralsThe person came back to the conversation through an m.me link or an ad
messaging_optinsA Messenger plugin click, an accepted message request or a checkbox opt-in
messaging_handoversThread control passed, taken or requested between apps
messaging_policy_enforcementA policy warning, block or unblock on the Page's messaging
messaging_account_linkingThe person linked or unlinked their account with the business
response_feedbackFeedback buttons, such as thumbs up or down, on a message the Page sent

Какие есть другие поля Messenger?

Ещё десять служат отдельным продуктам: от звонков до коммерции и отчётов о целостности:

  • send_cart: сообщение с информацией о корзине или заказе; message_context: обнаружения, которые модели Meta делают в сообщении, с названием события и оценкой.
  • calls, call_settings_update и call_permission_reply: голосовые звонки Messenger, изменения настроек звонков Страницы и ответ человека на запрос разрешения на звонок.
  • messaging_customer_information: данные, которые человек ввёл на экране с информацией о клиенте; messaging_in_thread_lead_form_submit: форма сбора лидов, отправленная внутри диалога.
  • message_template_status_update: изменился статус проверки служебного шаблона сообщения.
  • business_integrity и messaging_integrity: обновления целостности; нарушения, ограничения и действия передаются в business_integrity.

Какие поля отражают изменения профиля Страницы?

Двадцать девять полей описывают изменения собственных данных Страницы, по одному полю на каждую деталь; каждое приходит как изменение с именем этого поля:

  • Идентичность: name, picture, category (до трёх категорий) и description, то есть Story Description.
  • Сведения о бизнесе: company_overview, mission, founded, products, general_info, general_manager, members, awards и affiliation.
  • Контакты и место: email, phone, website, location, hours, current_location, hometown, parking и public_transit.
  • Заведение: price_range, payment_options, attire и culinary_team.
  • Личное: birthday, personal_info и personal_interests.

Какое разрешение нужно каждому полю?

pages_manage_metadata для любого из них, его выдаёт администратор Страницы с привилегиями MODERATE, а для некоторых нужны и другие. Страница подписывается через subscribed_apps, а руководства Meta задают токен и разрешения для каждого типа полей; чтобы получать события о людях вне ролей самого приложения, разрешениям также нужен Advanced Access:

PermissionsTask of the person behind the token
Any fieldpages_manage_metadata and pages_show_listCREATE_CONTENT, MANAGE or MODERATE
messages and other Messenger fieldspages_messaging as wellMESSAGING
leadgenleads_retrieval, pages_read_engagement and ads_management as wellADVERTISE

На какие поля подписывается easyCoexistence?

На три: feed, messages и mention. Когда Страница подключается, easyCoexistence отправляет POST /{page-id}/subscribed_apps с этими полями и токеном Страницы, а затем пересылает каждую запись для этой Страницы на эндпоинт, который вы указали, подписывая её заголовком X-EC-Signature. Правила комментариев и автоматизации действуют на новые комментарии из feed и на сообщения, а упоминания пересылаются как есть. Никакие другие поля не подписываются, поэтому эхо-сообщения, postback, подтверждения доставки, передачи диалога, standby и изменения профиля не пересылаются.

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

  • Подписка Страницы на поле, на которое приложение не подписано. Meta доставляет только поля, подписанные и на уровне Страницы, и на уровне приложения.
  • Разбор событий Messenger как изменений. Они приходят в entry.messaging, по одному объекту messaging на запись, а не в entry.changes.
  • Ожидание ответов самой Страницы в сообщениях. Сообщения, которые отправляет Страница, приходят в message_echoes, отдельном поле.
  • Расчёт на feed для лайков у большой Страницы. Meta присылает уведомления о лайках только для Страниц с менее чем 10 000 лайков.
Настройка с EasyCoexistence

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

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

Включает ли поле feed комментарии к рекламе?

Да. Meta не присылает ничего по самим рекламным публикациям, но комментарии к ним приходят в feed.

Что меняет настройка Include Values?

При включённой настройке изменение содержит новые значения в changes. При выключенной Meta присылает только названия изменённых полей в changed_fields.

Как посмотреть, на какие поля подписана Страница?

GET /{page-id}/subscribed_apps с токеном Страницы возвращает приложения, установленные на Странице, и для каждого из них его subscribed_fields.

Пересылает ли easyCoexistence изменения профиля Страницы?

Нет. Страницы, подключённые к easyCoexistence, подписаны только на feed, messages и mention, поэтому name, picture и другие поля профиля не пересылаются.

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

Верификация вебхука Facebook: hub.challenge и X-Hub-Signature-256Верификация вебхука Facebook: вернуть hub.challenge при совпадении hub.verify_token, затем проверять X-Hub-Signature-256 каждого события по App Secret.Подписка страницы Facebook на вебхуки: эндпоинт subscribed_appsКак POST /{page-id}/subscribed_apps подписывает страницу Facebook на поля вебхука: токены, задачи, подписка приложения, проверка и удаление.Вебхук ленты Facebook Страницы: события комментариев, публикаций и реакцийЧто передаёт вебхук ленты Facebook Страницы при комментариях, публикациях и реакциях: поля item и verb, структура тела запроса Meta и подписка Страницы.Вебхук Messenger для Facebook Page: сообщения и упоминанияПоля вебхука Facebook Page для сообщений Messenger и упоминаний: формат тела запроса, ID отправителей, вложения и доставка событий на ваш эндпоинт.API профиля Messenger: приветствие, Get Started, стартовые вопросы и постоянное менюНастройте профиль Messenger Страницы Facebook по адресу /{page-id}/messenger_profile: Get Started, приветствие, стартовые вопросы, постоянное меню и команды.Чтение истории диалогов Messenger через APIЧитайте историю Messenger Facebook Page через Conversations API: /{page-id}/conversations, поля сообщений, лимит 20 сообщений и разрешения.

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

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

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

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