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.
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.
Permission qu'un administrateur de Page disposant des privilèges MODERATE doit accorder avant que les webhooks de Page n'atteignent une application.
Un champ Messenger distinct pour les messages envoyés par la Page, disponible uniquement pour les conversations Messenger.
Tâche de Page requise pour s'abonner à leadgen, avec leads_retrieval, ads_management, pages_read_engagement et pages_manage_metadata.
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 :
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 :
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_updateetcall_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_integrityetmessaging_integrity: mises à jour d'intégrité, avec les événements de violations, restrictions et actions dansbusiness_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 etpublic_transit. - Établissement :
price_range,payment_options, attire etculinary_team. - Personnel : birthday,
personal_infoetpersonal_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 :
| Permissions | Task of the person behind the token | |
|---|---|---|
| Any field | pages_manage_metadata and pages_show_list | CREATE_CONTENT, MANAGE or MODERATE |
| messages and other Messenger fields | pages_messaging as well | MESSAGING |
| leadgen | leads_retrieval, pages_read_engagement and ads_management as well | ADVERTISE |
À 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.
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