Facebook Page-webhookvelden: de volledige lijst
De webhookreferentie voor Page van Meta documenteert 64 abonnementsvelden: feed voor posts, opmerkingen en reacties, mention voor vermeldingen van de Page, Messenger-velden zoals messages, message_echoes, messaging_postbacks en message_reads, en profielvelden zoals name, picture, hours en website. Elk veld vereist pages_manage_metadata, en een app ontvangt een veld pas zodra het zowel op appniveau als door de Page via subscribed_apps is geabonneerd.
easyCoexistence abonneert elke Page die je verbindt op feed, messages en mention, en stuurt die gebeurtenissen door naar je HTTPS-endpoint zodra ze binnenkomen, ondertekend met X-EC-Signature.
Abonnementsvelden gedocumenteerd in de webhookreferentie van Meta voor Page, van feed en mention tot Messenger- en profielvelden.
Recht dat een Page-beheerder met MODERATE-rechten moet verlenen voordat Page-webhooks een app bereiken.
Een apart Messenger-veld voor berichten die de Page verstuurt, alleen beschikbaar voor Messenger-gesprekken.
Page-taak nodig om te abonneren op leadgen, met leads_retrieval, ads_management, pages_read_engagement en pages_manage_metadata.
Alleen velden die zowel op Page- als op appniveau zijn geabonneerd, leveren webhooks op.
Hoe zijn de Page-webhookvelden ingedeeld?
Meta documenteert ze op één referentiepagina voor het Page-object, en ze vallen in drie families: activiteit op en rond de Page, Messenger-gesprekken, en wijzigingen aan de eigen gegevens van de Page. Feed-, mention- en profielwijzigingen komen binnen in entry.changes, elk met de naam van het veld, of als changed_fields wanneer de app de instelling Include Values heeft uitgezet. Messenger-gebeurtenissen komen binnen in entry.messaging, of in entry.standby voor een app die het gesprek niet bezit.
Welke velden melden activiteit op de Page?
Twaalf velden dekken inhoud en activiteit, niet gesprekken. Een nieuwe opmerking komt bijvoorbeeld binnen op feed als wijziging, met item ingesteld op comment en verb ingesteld op add, naast reacties, shares en de eigen posts van de Page. Wat elk veld levert, volgens de referentie van Meta:
Welke velden dragen Messenger-gebeurtenissen?
Messenger heeft de langste lijst, en de Messenger-webhookgids van Meta beschrijft wat elk veld verstuurt. Deze dertien dekken de gesprekken van een Page. Standby, dat berichten naar een app stuurt die het gesprek niet bezit, staat in die gids en niet in de Page-referentie:
Welke andere Messenger-velden zijn er?
Tien meer dienen bepaalde producten, van bellen tot commerce en integriteitsrapportage:
send_cart: een bericht met winkelwagen- of bestelinformatie;message_context: detecties die de modellen van Meta op een bericht doen, met een gebeurtenisnaam en een score.- calls,
call_settings_updateencall_permission_reply: Messenger-spraakoproepen, wijzigingen aan de oproepinstellingen van de Page, en het antwoord van een persoon op een verzoek om toestemming om te bellen. messaging_customer_information: wat iemand invulde op een klantgegevensscherm;messaging_in_thread_lead_form_submit: een leadformulier dat binnen het gesprek is verzonden.message_template_status_update: de reviewstatus van een utility-template is veranderd.business_integrityenmessaging_integrity: integriteitsupdates, met overtredingen, beperkingen en actiegebeurtenissen inbusiness_integrity.
Welke velden melden wijzigingen aan het profiel van de Page?
Negenentwintig velden melden wijzigingen aan de eigen gegevens van de Page, één veld per gegeven, elk binnengekomen als een wijziging die het veld noemt:
- Identiteit: name, picture, category (tot drie categorieën) en description, de Story Description.
- Bedrijfsgegevens:
company_overview, mission, founded, products,general_info,general_manager, members, awards en affiliation. - Contact en plaats: email, phone, website, location, hours,
current_location, hometown, parking enpublic_transit. - Vestiging:
price_range,payment_options, attire enculinary_team. - Persoonlijk: birthday,
personal_infoenpersonal_interests.
Welk recht heeft elk veld nodig?
pages_manage_metadata voor elk van hen, verleend door een Page-beheerder met MODERATE-rechten, en voor sommige meer. De Page wordt geabonneerd via subscribed_apps, en de handleidingen van Meta bepalen het token en de rechten per soort veld. Om gebeurtenissen over mensen buiten de eigen rollen van de app te ontvangen, hebben de rechten ook Advanced Access nodig:
| 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 |
Op welke velden abonneert easyCoexistence zich?
Drie: feed, messages en mention. Wanneer een Page verbindt, stuurt easyCoexistence POST /{page-id}/subscribed_apps met die velden en het token van de Page, en stuurt daarna elke entry voor die Page door naar het endpoint dat je instelt, ondertekend met X-EC-Signature. Regels voor opmerkingen en automatiseringen reageren op nieuwe opmerkingen uit feed en op berichten, en vermeldingen worden doorgestuurd zoals ze zijn. Geen ander veld is geabonneerd, dus echo's, postbacks, ontvangstbevestigingen, overdrachten, standby en profielwijzigingen worden niet doorgestuurd.
Veelgemaakte fouten
- De Page op een veld abonneren dat de app zelf niet heeft geabonneerd. Meta levert alleen velden die op Page- én appniveau zijn geabonneerd.
- Messenger-gebeurtenissen verwerken als wijzigingen. Ze komen binnen in entry.messaging, met één messaging-object per entry, niet in entry.changes.
- Verwachten dat de eigen antwoorden van de Page op berichten binnenkomen. Berichten die de Page verstuurt, komen binnen op message_echoes, een apart veld.
- Rekenen op feed voor likes bij een grote Page. Meta stuurt likemeldingen alleen voor Pages met minder dan 10.000 likes.
Regels voor opmerkingen en automatiseringen reageren op nieuwe opmerkingen en berichten. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Bevat het feed-veld ook opmerkingen op advertenties?
Ja. Meta stuurt niets voor de advertentieposts zelf, maar opmerkingen daarop komen binnen op feed.
Wat verandert de Include Values-instelling?
Staat hij aan, dan bevat een wijziging de nieuwe waarden in changes. Staat hij uit, dan stuurt Meta alleen de namen van de gewijzigde velden, in changed_fields.
Hoe zie ik op welke velden een Page is geabonneerd?
GET /{page-id}/subscribed_apps met het token van de Page geeft de apps die de Page heeft geïnstalleerd en, per app, de subscribed_fields.
Stuurt easyCoexistence wijzigingen aan het profiel van de Page door?
Nee. Pages die met easyCoexistence zijn verbonden, zijn alleen geabonneerd op feed, messages en mention, dus name, picture en de andere profielvelden worden niet doorgestuurd.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op