Поля вебхука Страницы 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, а правила комментариев и автоматизации работают с новыми комментариями и сообщениями.
Поля подписки, описанные в справочнике Meta по вебхукам Страницы: от feed и mention до полей Messenger и профиля.
Разрешение, которое администратор Страницы с привилегиями MODERATE должен выдать до того, как вебхуки Страницы попадут в приложение.
Отдельное поле Messenger для сообщений, которые отправляет Страница; доступно только для диалогов Messenger.
Задача Страницы для подписки на leadgen: leads_retrieval, ads_management, pages_read_engagement и pages_manage_metadata.
Вебхуки приходят только по полям, подписанным и на уровне Страницы, и на уровне приложения.
Как организованы поля вебхука Страницы?
Meta описывает их на одной справочной странице для объекта Page, и они делятся на три группы: активность на Странице и вокруг неё, диалоги Messenger и изменения собственных данных Страницы. Изменения feed, mention и профиля приходят в entry.changes, где указано поле каждого изменения, либо в changed_fields, если настройка Include Values отключена; события Messenger приходят в entry.messaging или в entry.standby для приложения, которое не владеет диалогом.
Какие поля отражают активность на Странице?
Двенадцать полей описывают контент и активность, а не диалоги. Например, новый комментарий приходит в feed как изменение с item со значением comment и verb со значением add, наряду с реакциями, репостами и собственными публикациями Страницы. Что передаёт каждое поле, по справочнику Meta:
Какие поля передают события Messenger?
У Messenger самый длинный список, и руководство Meta по вебхукам Messenger описывает, что передаёт каждое поле. Эти тринадцать полей охватывают диалоги Страницы. Поле standby, которое передаёт сообщения приложению, не владеющему диалогом, описано в этом руководстве, а не в справочнике Страницы:
Какие есть другие поля 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:
| Permissions | Task of the person behind the token | |
|---|---|---|
| Any field | pages_manage_metadata and pages_show_list | CREATE_CONTENT, MANAGE or MODERATE |
| messages and other Messenger fields | pages_messaging as well | MESSAGING |
| leadgen | leads_retrieval, pages_read_engagement and ads_management as well | ADVERTISE |
На какие поля подписывается 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 лайков.
От 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 и другие поля профиля не пересылаются.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на