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

Вебхук упоминания Страницы Facebook: когда кто-то упоминает вашу Страницу

Поле mention в вебхуках Страниц Facebook уведомляет приложение, когда кто-то упоминает Страницу через @ в посте или комментарии. Meta отправляет change с полем field, равным mention, значение которого может содержать post_id, comment_id для комментария, текст в message, прикреплённые ссылки и медиа, а также item и verb. Запрос POST подписан заголовком X-Hub-Signature-256.

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

mention

Поле вебхука Страницы для новых упоминаний Страницы, включая упоминания в комментариях и постах.

pages_manage_metadata

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

@ + name

Как люди упоминают Страницу в посте или комментарии: вводят @ и название Страницы, затем выбирают её.

36 hours

Сколько времени Meta повторяет неудачное уведомление о Странице с уменьшающейся частотой, прежде чем отбросить его.

tagged_time

Поле, которое эдж /{page-id}/tagged добавляет к каждому публичному посту, в котором Страница была отмечена.

Что запускает вебхук упоминания?

Упоминание Страницы в посте или комментарии. На Facebook упоминание делается вводом @ и названия Страницы с выбором её из подсказок. В справочнике Meta поле описано как новые упоминания Страницы, включая упоминания в комментариях и постах. Справочный центр Facebook отмечает, что настройки Страницы могут не позволять людям упоминать её.

Как выглядит уведомление об упоминании?

POST с object, равным page, и одним entry для упомянутой Страницы: её ID, время и массив changes, поле field которого равно mention. Справочник Meta перечисляет поля значения, но не даёт примера, поэтому пример упоминания в посте ниже построен по этому списку:

A mention in a post, from the fields in Meta's reference
{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1793520000,
      "changes": [
        {
          "field": "mention",
          "value": {
            "item": "post",
            "verb": "add",
            "post_id": "<POST_ID>",
            "message": "<TEXT_WITH_THE_MENTION>"
          }
        }
      ]
    }
  ]
}

Что означает каждое поле упоминания?

Это поля значения в справочнике Meta; какие из них приходят в уведомлении, зависит от поста или комментария:

  • post_id: ID поста, в котором упомянута Страница.
  • comment_id: ID комментария, если упоминание в комментарии; parent_id: ID его родителя.
  • message: текст, который содержит упоминание.
  • link, photo, photos и video: ссылки на то, что прикреплено к посту или комментарию.
  • item и verb: тип объекта и действие с ним, из тех же списков, что использует поле feed.
  • created_time: когда был создан пост или комментарий.
  • from и message_tags: автор и профили, отмеченные в тексте, оба помечены как только для Workplace.
  • Также перечислены: action, album_id, event_id, photo_id, video_id, share_id, published, reaction_type, recipient_id и open_graph_story_id.

Какое право нужно полю mention?

pages_manage_metadata, которое Meta требует выдать администратору Страницы с привилегиями MODERATE до того, как вебхуки Страниц попадут в приложение. Страница подписывается через POST /{page-id}/subscribed_apps с mention среди subscribed_fields, с токеном Страницы от человека с задачей CREATE_CONTENT, MANAGE или MODERATE, с pages_manage_metadata и pages_show_list. Приложение тоже подписывается на mention, так как доставляются только поля, подписанные на обоих уровнях, а Страницы, которыми управляют люди без роли в приложении, нуждаются в этих правах в Advanced Access.

Как прочитать пост или комментарий, который упоминает Страницу?

По его ID, токеном Страницы, где Meta это позволяет. Токен Страницы читает посты, опубликованные на Странице или от её имени; публично опубликованные посты других Страниц требуют pages_manage_posts и функцию Page Public Content Access, с токеном администратора Страницы. Meta также привязывает чтение личного поста человека к его праву user_posts.

Looking up the post or the comment
GET https://graph.facebook.com/<POST_ID>
  ?fields=message,permalink_url,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

GET https://graph.facebook.com/<COMMENT_ID>
  ?fields=message,from,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

Где ещё Страница может найти свои упоминания?

В эдже tagged. GET /{page-id}/tagged перечисляет публичные посты, в которых Страница была отмечена, каждый с tagged_time, что также охватывает посты, опубликованные до настройки вебхука. Нужен токен Страницы от человека с задачей CREATE_CONTENT, MANAGE или MODERATE, с pages_read_user_content и pages_show_list; Meta говорит, что может потребоваться функция Page Public Content Access. Для поста человека Meta возвращает from только тому, кто его написал.

Как easyCoexistence доставляет события упоминаний?

Он подписывает каждую Страницу на mention вместе с feed и messages при подключении Страницы. Его приложение проверяет X-Hub-Signature-256 в каждой доставке, сразу отвечает Meta и отправляет каждую запись для Страницы без изменений на HTTPS-эндпоинт, который вы задаёте через set_social_webhook_destination или PUT /channels/:id/webhook в Partner API:

  • X-EC-Signature содержит t=<unix>,v1=<hex>: HMAC-SHA256 от временной метки, точки и исходного тела, с ключом из секрета подписи Страницы.
  • Секрет начинается с whsec_ и показывается один раз; повторная установка URL выпускает новый, а null в URL останавливает пересылку.
  • Каждая запись отправляется один раз, ожидая до 8 секунд, на HTTPS-адрес, который разрешается в публичный IP, без следования редиректам и без сохранения копии.
A forwarded mention, headers included
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793520001,v1=<HEX_HMAC_SHA256>

{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793520000,
    "changes": [
      {
        "field": "mention",
        "value": {
          "item": "post",
          "verb": "add",
          "post_id": "<POST_ID>",
          "message": "<TEXT_WITH_THE_MENTION>"
        }
      }
    ]
  }
}

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

  • Принимать entry.time за момент упоминания. Meta ставит туда время отправки уведомления; created_time в значении датирует пост или комментарий.
  • Считать неудачный поиск сломанным событием. Meta предупреждает, что некоторые значения post_id и comment_id в уведомлениях об упоминаниях нельзя запросить из-за отсутствия прав или конфиденциальности, поэтому сохраняйте текст сообщения из самого события.
  • Загружать пост до ответа на пересылку. Пересылки не повторяются, поэтому сразу возвращайте 2xx, а пост ищите потом.
Настройка с EasyCoexistence

Каждое событие подписано секретом для этой Страницы, копия не сохраняется, так что ваш агент узнаёт о каждом упоминании сразу, как оно происходит. От US$ 9 до US$ 0.75 за подключение в месяц, по мере добавления подключений цена снижается, первые 3 дня бесплатно.

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

Говорит ли вебхук упоминания, кто упомянул Страницу?

Для Страницы нет: в справочнике Meta from помечен как только для Workplace. Поиск поста или комментария по ID может вернуть его автора, если позволяют права Meta.

Можно ли получить упоминания, которые были до подписки Страницы?

Не через вебхук, так как Meta не хранит историю уведомлений для запроса. Эдж tagged перечисляет публичные посты, в которых Страница была отмечена.

Чем поле mention отличается от feed?

feed сообщает об изменениях в собственной ленте Страницы, например о постах, комментариях и реакциях там; mention сообщает, что Страницу упомянули через @ в посте или комментарии. Каждое поле подписывается отдельно.

Действуют ли правила комментариев easyCoexistence на упоминания?

Нет. Правила и автоматизации работают с комментариями из поля feed и с сообщениями Messenger; изменения mention пересылаются на ваш эндпоинт именно так, как их отправила Meta.

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

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

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

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

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

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