Вебхук ленты Facebook Страницы: события комментариев, публикаций и реакций
Поле feed в вебхуках Страниц Facebook сообщает почти обо всех изменениях ленты Страницы по мере их появления. Каждое изменение несёт item, например post, comment или reaction, и verb, например add, edit или remove, а также ID участвующих объектов, автора в from и текст в message. Meta отправляет это в формате JSON, подписанном заголовком X-Hub-Signature-256.
easyCoexistence подписывает каждую подключённую вами Страницу на поле feed и пересылает её изменения на ваш HTTPS-эндпоинт по мере их поступления, подписывая секретом этой Страницы.
Уведомления о лайках Страницы приходят только для Страниц, у которых меньше 10 000 лайков.
Поле feed не присылает сами рекламные публикации, но присылает комментарии к ним.
Разрешение, которое должен выдать администратор Страницы с правами MODERATE, чтобы вебхуки Страниц доходили до приложения.
Meta объединяет большинство обновлений в одну доставку вебхука, но не гарантирует пакетирования.
Как долго Meta повторяет неудачную доставку на эндпоинт приложения, с убывающей частотой повторов.
Что передаёт поле feed?
Почти все изменения в ленте Страницы, как сказано в документации Meta: публикации, комментарии, реакции и репосты. Что именно несёт изменение, зависит от его типа. Meta не присылает сами рекламные публикации, но комментарии к ним приходят, а уведомления о лайках Страницы присылаются только тогда, когда у Страницы меньше 10 000 лайков.
Что означают item и verb?
Два поля в значении каждого изменения говорят о том, что произошло:
- item: что изменилось, из списка Meta, куда входят post, status, photo, video, link, share, comment, reaction и album.
- verb: что произошло с объектом: add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute или update.
- Новый комментарий приходит с item comment и verb add, по этому признаку работают правила «комментарий в личное сообщение».
- Реакция несёт item reaction и
reaction_typeс её названием.
Как выглядит изменение ленты?
POST, в JSON которого object равен page, а для каждой Страницы есть entry с ID Страницы, временем и массивом changes. Это собственный пример Meta: пользователь публикует на Странице.
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1520544816,
"changes": [
{
"field": "feed",
"value": {
"from": { "id": "<USER_ID>", "name": "<NAME>" },
"item": "post",
"post_id": "<PAGE_POST_ID>",
"verb": "add",
"created_time": 1520544814,
"is_hidden": false,
"message": "<POST_TEXT>"
}
}
]
}
]
}Какие поля может нести изменение?
Справочник Meta перечисляет среди полей значения изменения ленты следующие, их наличие зависит от типа изменения:
post_id,comment_idиparent_id: публикация, комментарий и то, к чему он относится.- from: ID и имя того, кто внёс изменение.
- message: текст, а также link, photo, photos или video для прикреплённого контента.
created_time, а для правокedited_time.reaction_typeдля реакций иis_hidden, скрыта ли публикация.- post: подробности, например
status_type,is_published,updated_timeиpermalink_url.
Как Страница подписывается?
Приложение отправляет POST /{page-id}/subscribed_apps с subscribed_fields=feed и токеном Страницы, от имени того, кто может выполнять задачу CREATE_CONTENT, MANAGE или MODERATE, с выданными разрешениями pages_manage_metadata и pages_show_list. Meta присылает уведомления, только пока на Странице установлено приложение и в её настройках не отключена платформа приложений. easyCoexistence подписывает каждую Страницу на feed, messages и mention при подключении.
Как события ленты доходят до вашего эндпоинта?
Meta доставляет их в приложение easyCoexistence, которое проверяет X-Hub-Signature-256, сразу отвечает Meta и пересылает каждую запись для подключённой Страницы на HTTPS-эндпоинт, который вы задали для неё. Пересылка несёт заголовок X-EC-Signature: HMAC-SHA256 от временной метки и исходного тела, ключом для которого служит секрет этой Страницы. Отправляется она один раз, без сохранения копии и без повторов. Эндпоинт задаётся через set_social_webhook_destination или через PUT /channels/:id/webhook в Partner API.
Какие изменения ленты запускают правила комментариев и автоматизации?
Только новые комментарии: изменение с item comment и verb add к одной из публикаций Страницы. Правила «комментарий в личное сообщение» проверяют его текст на ключевые слова и пропускают комментарии, которые оставила сама Страница. Автоматизации берут комментарии, на которые не ответило ни одно правило. Правки, скрытия, реакции и публикации сразу уходят на ваш эндпоинт, если вы его задали.
Распространённые ошибки
- Считать любое изменение ленты новым комментарием. Проверяйте item и verb: реакции, правки, скрытия и удаления приходят в том же поле.
- Отвечать на собственные комментарии Страницы. Её ответы тоже приходят как изменения ленты, поэтому пропускайте те, у которых from.id равен ID Страницы.
- Считать, что в одной доставке одно изменение. Meta может объединить до 1 000 обновлений, поэтому перебирайте каждую запись и каждое изменение в ней.
- Считать entry.time моментом изменения. Meta ставит туда время отправки уведомления, а created_time в значении означает время создания объекта.
Правила «комментарий в личное сообщение» и автоматизации работают с новыми комментариями. От US$ 9 до US$ 0,75 за подключение в месяц, с уменьшением по мере добавления подключений. Первые 3 дня бесплатно.
Часто задаваемые вопросы
Включает ли вебхук ленты комментарии?
Да. Новый комментарий приходит как изменение ленты с item comment и verb add, с полями comment_id, post_id, from и message.
Получаю ли я вебхуки о лайках Страницы?
Только для Страниц, у которых меньше 10 000 лайков, по справочнику Meta по вебхукам Страниц.
Попадают ли рекламные публикации в вебхук ленты?
Сами рекламные публикации нет, но комментарии к ним присылаются.
Нужно ли мне своё приложение Meta, чтобы получать события ленты Страницы?
Нет. Meta доставляет их в приложение easyCoexistence, которое пересылает каждое событие на эндпоинт, заданный вами для этой Страницы.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на