InloggenGratis proefperiode starten
easyCoexistence Officiële API's

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.

64

Abonnementsvelden gedocumenteerd in de webhookreferentie van Meta voor Page, van feed en mention tot Messenger- en profielvelden.

pages_manage_metadata

Recht dat een Page-beheerder met MODERATE-rechten moet verlenen voordat Page-webhooks een app bereiken.

message_echoes

Een apart Messenger-veld voor berichten die de Page verstuurt, alleen beschikbaar voor Messenger-gesprekken.

ADVERTISE

Page-taak nodig om te abonneren op leadgen, met leads_retrieval, ads_management, pages_read_engagement en pages_manage_metadata.

Both levels

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:

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

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:

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

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_update en call_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_integrity en messaging_integrity: integriteitsupdates, met overtredingen, beperkingen en actiegebeurtenissen in business_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 en public_transit.
  • Vestiging: price_range, payment_options, attire en culinary_team.
  • Persoonlijk: birthday, personal_info en personal_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:

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

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.
Dit doen met EasyCoexistence

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