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

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

Поле feed в вебхуках Страниц Facebook сообщает почти обо всех изменениях ленты Страницы по мере их появления. Каждое изменение несёт item, например post, comment или reaction, и verb, например add, edit или remove, а также ID участвующих объектов, автора в from и текст в message. Meta отправляет это в формате JSON, подписанном заголовком X-Hub-Signature-256.

easyCoexistence подписывает каждую подключённую вами Страницу на поле feed и пересылает её изменения на ваш HTTPS-эндпоинт по мере их поступления, подписывая секретом этой Страницы.

10K likes

Уведомления о лайках Страницы приходят только для Страниц, у которых меньше 10 000 лайков.

Ad posts

Поле feed не присылает сами рекламные публикации, но присылает комментарии к ним.

pages_manage_metadata

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

1,000

Meta объединяет большинство обновлений в одну доставку вебхука, но не гарантирует пакетирования.

36 hours

Как долго 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: пользователь публикует на Странице.

A feed change, as Meta sends it
{
  "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 в значении означает время создания объекта.
Настройка с EasyCoexistence

Правила «комментарий в личное сообщение» и автоматизации работают с новыми комментариями. От US$ 9 до US$ 0,75 за подключение в месяц, с уменьшением по мере добавления подключений. Первые 3 дня бесплатно.

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

Включает ли вебхук ленты комментарии?

Да. Новый комментарий приходит как изменение ленты с item comment и verb add, с полями comment_id, post_id, from и message.

Получаю ли я вебхуки о лайках Страницы?

Только для Страниц, у которых меньше 10 000 лайков, по справочнику Meta по вебхукам Страниц.

Попадают ли рекламные публикации в вебхук ленты?

Сами рекламные публикации нет, но комментарии к ним присылаются.

Нужно ли мне своё приложение Meta, чтобы получать события ленты Страницы?

Нет. Meta доставляет их в приложение easyCoexistence, которое пересылает каждое событие на эндпоинт, заданный вами для этой Страницы.

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

Вебхук Messenger для Facebook Page: сообщения и упоминанияПоля вебхука Facebook Page для сообщений Messenger и упоминаний: формат тела запроса, ID отправителей, вложения и доставка событий на ваш эндпоинт.API модерации комментариев Facebook Page: чтение, ответы, скрытие и удалениеЧтение, ответы, скрытие и удаление комментариев к постам Facebook Page через Graph API: задачи, разрешения и фильтры.API приватных ответов Facebook: написать тому, кто прокомментировал СтраницуОтправьте приватный ответ через API Meta: POST /{page-id}/messages с ID комментария, одно сообщение в Messenger в течение 7 дней, а также ошибки.Разрешения Facebook Page API и требования App ReviewДевять разрешений Facebook Page, что открывает каждое и что App Review требует: расширенный доступ, верификация бизнеса, запись экрана.API постов Facebook-страницы: текст, ссылки, фото и видеоКак публиковать посты на Facebook-страницах через Graph API: текст и ссылки в /feed, фото по URL в /photos, видео в /videos и правила Meta.Вебхук упоминания Страницы Facebook: когда кто-то упоминает вашу СтраницуЧто вебхук Страницы Facebook присылает, когда пост или комментарий упоминает вашу Страницу: поля, право доступа и чтение поста.

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

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

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

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