Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Champs webhook de Page Facebook : la liste complète

La référence des webhooks de Page de Meta documente 64 champs d'abonnement : feed pour les publications, commentaires et réactions, mention pour les mentions de la Page, champs Messenger comme messages, message_echoes, messaging_postbacks et message_reads, et champs de profil comme name, picture, hours et website. Chacun exige pages_manage_metadata, et une application reçoit un champ dès qu'il est abonné à la fois au niveau de l'application et par la Page via subscribed_apps.

easyCoexistence abonne chaque Page que vous connectez à feed, messages et mention, et transmet ces événements à votre endpoint HTTPS dès leur arrivée, signés avec X-EC-Signature, tandis que les règles de commentaires et les automatisations agissent sur les nouveaux commentaires et messages.

64

Champs d'abonnement documentés dans la référence des webhooks de Page de Meta, de feed et mention aux champs Messenger et de profil.

pages_manage_metadata

Permission qu'un administrateur de Page disposant des privilèges MODERATE doit accorder avant que les webhooks de Page n'atteignent une application.

message_echoes

Un champ Messenger distinct pour les messages envoyés par la Page, disponible uniquement pour les conversations Messenger.

ADVERTISE

Tâche de Page requise pour s'abonner à leadgen, avec leads_retrieval, ads_management, pages_read_engagement et pages_manage_metadata.

Both levels

Seuls les champs abonnés à la fois au niveau de la Page et de l'application produisent des webhooks.

Comment sont organisés les champs webhook de Page ?

Meta les documente sur une seule page de référence pour l'objet Page, et ils se répartissent en trois familles : l'activité sur la Page et autour d'elle, les conversations Messenger, et les modifications des informations propres à la Page. Les changements de feed, de mention et de profil arrivent dans entry.changes, chacun nommant son champ, ou dans changed_fields lorsque l'application a désactivé Include Values ; les événements Messenger arrivent dans entry.messaging, ou dans entry.standby pour une application qui ne possède pas le fil de discussion.

Quels champs signalent l'activité sur la Page ?

Douze champs couvrent le contenu et l'activité plutôt que les conversations. Un nouveau commentaire, par exemple, arrive sur feed sous forme de changement avec item à comment et verb à add, aux côtés des réactions, des partages et des publications de la Page elle-même. Ce que chacun transmet, d'après la référence de Meta :

feedNearly all changes to the Page's feed: posts, comments, reactions, shares; likes only below 10,000 likes
mentionNew mentions of the Page in posts and comments; some IDs it returns cannot be queried
ratingsNew ratings, and comments or reactions on a rating
videosChanges to the encoding status of a video on the Page
live_videosChanges to a live video's status, with its ID
leadgenNew leads from the Page's lead ads, with leadgen_id, form_id and ad_id
group_feedComments on the Page's posts in the business's Facebook Group
product_reviewA product item's review status: pending, approved, rejected or outdated
inbox_labelsLabel changes on people in the Page inbox: the user, the action and the label
page_upcoming_changeUpcoming changes to the Page, with their type and effective time
page_change_proposalProposals to change the Page, created, accepted or rejected
invoice_access_invoice_draft_changeChanges to an invoice draft, such as its shipping address

Quels champs transportent les événements Messenger ?

Messenger compte la liste la plus longue, et le guide des webhooks Messenger de Meta décrit ce que chaque champ envoie. Ces treize champs couvrent les conversations d'une Page ; standby, qui transmet les messages à une application ne possédant pas le fil de discussion, est documenté dans ce guide plutôt que dans la référence de la Page :

messagesA message from a person, through any entry point, with text or attachments
message_echoesA message the Page sent, with the app_id of the app that sent it
message_deliveriesA message from the Page was delivered
message_readsThe person read a message from the Page
message_reactionsThe person reacted to a message from the Page
message_editsThe person edited a message they had sent
messaging_postbacksA tap on a postback button, Get Started or a persistent menu item
messaging_referralsThe person came back to the conversation through an m.me link or an ad
messaging_optinsA Messenger plugin click, an accepted message request or a checkbox opt-in
messaging_handoversThread control passed, taken or requested between apps
messaging_policy_enforcementA policy warning, block or unblock on the Page's messaging
messaging_account_linkingThe person linked or unlinked their account with the business
response_feedbackFeedback buttons, such as thumbs up or down, on a message the Page sent

Quels sont les autres champs Messenger ?

Dix autres servent des produits particuliers, des appels au commerce et au signalement d'intégrité :

  • send_cart : un message contenant des informations de panier ou de commande ; message_context : détections effectuées par les modèles de Meta sur un message, avec un nom d'événement et un score.
  • calls, call_settings_update et call_permission_reply : appels vocaux Messenger, modifications des paramètres d'appel de la Page, et réponse d'une personne à une demande d'autorisation d'appel.
  • messaging_customer_information : ce qu'une personne a saisi sur un écran d'informations client ; messaging_in_thread_lead_form_submit : un formulaire de prospect soumis dans la conversation.
  • message_template_status_update : le statut de révision d'un template de message utilitaire a changé.
  • business_integrity et messaging_integrity : mises à jour d'intégrité, avec les événements de violations, restrictions et actions dans business_integrity.

Quels champs signalent les modifications du profil de la Page ?

Vingt-neuf champs signalent les modifications des informations propres à la Page, un champ par information, chacun arrivant sous forme de changement qui le nomme :

  • Identité : name, picture, category, qui peut contenir jusqu'à trois catégories, et description, la Story Description.
  • Informations professionnelles : company_overview, mission, founded, products, general_info, general_manager, members, awards et affiliation.
  • Contact et lieu : email, phone, website, location, hours, current_location, hometown, parking et public_transit.
  • Établissement : price_range, payment_options, attire et culinary_team.
  • Personnel : birthday, personal_info et personal_interests.

Quelle permission chaque champ nécessite-t-il ?

pages_manage_metadata pour chacun d'eux, accordée par un administrateur de Page disposant des privilèges MODERATE, et davantage pour certains. La Page s'abonne via subscribed_apps, et les guides de Meta fixent le token et les permissions selon le type de champ ; pour recevoir des événements concernant des personnes extérieures aux rôles propres de l'application, les permissions doivent aussi disposer d'un Advanced Access :

PermissionsTask of the person behind the token
Any fieldpages_manage_metadata and pages_show_listCREATE_CONTENT, MANAGE or MODERATE
messages and other Messenger fieldspages_messaging as wellMESSAGING
leadgenleads_retrieval, pages_read_engagement and ads_management as wellADVERTISE

À quels champs easyCoexistence s'abonne-t-il ?

Trois : feed, messages et mention. Lorsqu'une Page se connecte, easyCoexistence envoie POST /{page-id}/subscribed_apps avec ces champs et le token de la Page, puis transmet chaque entry de cette Page à l'endpoint que vous avez défini, signée avec X-EC-Signature. Les règles de commentaires et les automatisations agissent sur les nouveaux commentaires issus de feed et sur les messages, et les mentions sont transmises telles quelles. Aucun autre champ n'est souscrit : les échos (message_echoes), les postbacks, les accusés de réception, les transferts de conversation, standby et les modifications de profil ne sont donc pas transmis.

Erreurs courantes

  • Abonner la Page à un champ que l'application n'a pas souscrit. Meta ne livre que les champs abonnés à la fois au niveau de la Page et de l'application.
  • Analyser les événements Messenger comme des changements. Ils arrivent dans entry.messaging, avec un objet messaging par entrée, et non dans entry.changes.
  • Attendre les réponses de la Page sur les messages. Les messages envoyés par la Page arrivent sur message_echoes, un champ distinct.
  • Compter sur feed pour les « J'aime » d'une grande Page. Meta n'envoie les notifications de « J'aime » que pour les Pages ayant moins de 10 000 J'aime.
Faire cela avec EasyCoexistence

De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Le champ feed inclut-il les commentaires sous les publicités ?

Oui. Meta n'envoie rien pour les publications publicitaires elles-mêmes, mais les commentaires qu'elles reçoivent arrivent sur feed.

Que change le paramètre Include Values ?

Activé, un changement contient les nouvelles valeurs dans changes. Désactivé, Meta n'envoie que les noms des champs modifiés, dans changed_fields.

Comment voir à quels champs une Page est abonnée ?

GET /{page-id}/subscribed_apps avec le token de la Page liste les applications installées par la Page et, pour chacune, ses subscribed_fields.

easyCoexistence transmet-il les modifications du profil de la Page ?

Non. Les Pages connectées à easyCoexistence ne sont abonnées qu'à feed, messages et mention, donc name, picture et les autres champs de profil ne sont pas transmis.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le