Вебхук упоминания Страницы Facebook: когда кто-то упоминает вашу Страницу
Поле mention в вебхуках Страниц Facebook уведомляет приложение, когда кто-то упоминает Страницу через @ в посте или комментарии. Meta отправляет change с полем field, равным mention, значение которого может содержать post_id, comment_id для комментария, текст в message, прикреплённые ссылки и медиа, а также item и verb. Запрос POST подписан заголовком X-Hub-Signature-256.
easyCoexistence подписывает каждую подключённую вами Страницу на поле mention вместе с feed и messages и пересылает её события упоминаний на ваш HTTPS-эндпоинт по мере поступления.
Поле вебхука Страницы для новых упоминаний Страницы, включая упоминания в комментариях и постах.
Право, которое администратор Страницы с привилегиями MODERATE должен выдать, прежде чем вебхуки Страниц попадут на URL обратного вызова приложения.
Как люди упоминают Страницу в посте или комментарии: вводят @ и название Страницы, затем выбирают её.
Сколько времени Meta повторяет неудачное уведомление о Странице с уменьшающейся частотой, прежде чем отбросить его.
Поле, которое эдж /{page-id}/tagged добавляет к каждому публичному посту, в котором Страница была отмечена.
Что запускает вебхук упоминания?
Упоминание Страницы в посте или комментарии. На Facebook упоминание делается вводом @ и названия Страницы с выбором её из подсказок. В справочнике Meta поле описано как новые упоминания Страницы, включая упоминания в комментариях и постах. Справочный центр Facebook отмечает, что настройки Страницы могут не позволять людям упоминать её.
Как выглядит уведомление об упоминании?
POST с object, равным page, и одним entry для упомянутой Страницы: её ID, время и массив changes, поле field которого равно mention. Справочник Meta перечисляет поля значения, но не даёт примера, поэтому пример упоминания в посте ниже построен по этому списку:
{
"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.
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, без следования редиректам и без сохранения копии.
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, а пост ищите потом.
Каждое событие подписано секретом для этой Страницы, копия не сохраняется, так что ваш агент узнаёт о каждом упоминании сразу, как оно происходит. От US$ 9 до US$ 0.75 за подключение в месяц, по мере добавления подключений цена снижается, первые 3 дня бесплатно.
Часто задаваемые вопросы
Говорит ли вебхук упоминания, кто упомянул Страницу?
Для Страницы нет: в справочнике Meta from помечен как только для Workplace. Поиск поста или комментария по ID может вернуть его автора, если позволяют права Meta.
Можно ли получить упоминания, которые были до подписки Страницы?
Не через вебхук, так как Meta не хранит историю уведомлений для запроса. Эдж tagged перечисляет публичные посты, в которых Страница была отмечена.
Чем поле mention отличается от feed?
feed сообщает об изменениях в собственной ленте Страницы, например о постах, комментариях и реакциях там; mention сообщает, что Страницу упомянули через @ в посте или комментарии. Каждое поле подписывается отдельно.
Действуют ли правила комментариев easyCoexistence на упоминания?
Нет. Правила и автоматизации работают с комментариями из поля feed и с сообщениями Messenger; изменения mention пересылаются на ваш эндпоинт именно так, как их отправила Meta.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на