AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Facebook-Seiten-Webhook-Felder: die vollständige Liste

Metas Referenz zu den Seiten-Webhooks führt 64 Abonnement-Felder auf: feed für Beiträge, Kommentare und Reaktionen, mention für Erwähnungen der Seite, Messenger-Felder wie messages, message_echoes, messaging_postbacks und message_reads sowie Profilfelder wie name, picture, hours und website. Jedes benötigt pages_manage_metadata, und eine App erhält ein Feld erst, wenn sie es sowohl auf App-Ebene als auch durch die Seite über subscribed_apps abonniert hat.

easyCoexistence abonniert jede verbundene Seite auf feed, messages und mention und leitet diese Ereignisse an Ihren HTTPS-Endpoint weiter, sobald sie eintreffen, signiert mit X-EC-Signature.

64

Abonnement-Felder laut Metas Referenz zu den Seiten-Webhooks, von feed und mention bis zu Messenger- und Profilfeldern.

pages_manage_metadata

Berechtigung, die ein Seiten-Administrator mit MODERATE-Rechten erteilen muss, bevor Seiten-Webhooks eine App erreichen.

message_echoes

Ein eigenes Messenger-Feld für Nachrichten, die die Seite sendet, nur für Messenger-Unterhaltungen verfügbar.

ADVERTISE

Seitenaufgabe für das Abonnement von leadgen, mit leads_retrieval, ads_management, pages_read_engagement und pages_manage_metadata.

Both levels

Nur Felder, die sowohl auf Seiten- als auch auf App-Ebene abonniert sind, erzeugen Webhooks.

Wie sind die Felder der Seiten-Webhooks gegliedert?

Meta dokumentiert sie auf einer einzigen Referenzseite für das Seiten-Objekt. Sie fallen in drei Gruppen: Aktivität auf und rund um die Seite, Messenger-Unterhaltungen und Änderungen an den eigenen Angaben der Seite. Feed-, Erwähnungs- und Profiländerungen kommen in entry.changes, wobei jedes Feld benannt ist, oder als changed_fields, wenn die App Include Values ausgeschaltet hat. Messenger-Ereignisse kommen in entry.messaging oder in entry.standby für eine App, die den Thread nicht besitzt.

Welche Felder melden Aktivität auf der Seite?

Zwölf Felder erfassen Inhalte und Aktivität statt Unterhaltungen. Ein neuer Kommentar kommt zum Beispiel über feed als Änderung mit item auf comment und verb auf add an, zusammen mit Reaktionen, Shares und den eigenen Beiträgen der Seite. Was jedes liefert, laut Metas Referenz:

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

Welche Felder transportieren Messenger-Ereignisse?

Messenger hat die längste Liste, und Metas Leitfaden zu Messenger-Webhooks beschreibt, was jedes Feld sendet. Diese dreizehn decken die Unterhaltungen einer Seite ab. standby, das Nachrichten an eine App transportiert, die den Thread nicht besitzt, ist in diesem Leitfaden dokumentiert und nicht in der Seiten-Referenz:

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

Welche weiteren Messenger-Felder gibt es?

Zehn weitere dienen bestimmten Produkten, vom Calling bis zu Commerce und Integritätsmeldungen:

  • send_cart: eine Nachricht mit Warenkorb- oder Bestellinformationen; message_context: Erkennungen, die Metas Modelle an einer Nachricht vornehmen, mit einem Ereignisnamen und einem Score.
  • calls, call_settings_update und call_permission_reply: Messenger-Sprachanrufe, Änderungen an den Anrufeinstellungen der Seite und die Antwort einer Person auf eine Anfrage zur Anrufberechtigung.
  • messaging_customer_information: was eine Person auf einem Kundendaten-Bildschirm eingegeben hat; messaging_in_thread_lead_form_submit: ein Lead-Formular, das innerhalb der Unterhaltung abgesendet wurde.
  • message_template_status_update: der Prüfstatus eines Utility-Templates hat sich geändert.
  • business_integrity und messaging_integrity: Integritätsupdates, mit Verstößen, Einschränkungen und Maßnahmen-Ereignissen in business_integrity.

Welche Felder melden Änderungen am Profil der Seite?

Neunundzwanzig Felder melden Änderungen an den eigenen Angaben der Seite, ein Feld pro Angabe. Jedes kommt als Änderung, die es benennt:

  • Identität: name, picture, category, das bis zu drei Kategorien umfasst, und description, die Story Description.
  • Unternehmensangaben: company_overview, mission, founded, products, general_info, general_manager, members, awards und affiliation.
  • Kontakt und Ort: email, phone, website, location, hours, current_location, hometown, parking und public_transit.
  • Lokal: price_range, payment_options, attire und culinary_team.
  • Persönliches: birthday, personal_info und personal_interests.

Welche Berechtigung braucht jedes Feld?

pages_manage_metadata für alle, erteilt von einem Seiten-Administrator mit MODERATE-Rechten, bei einigen zusätzlich weitere. Die Seite wird über subscribed_apps abonniert, und Metas Leitfäden legen Token und Berechtigungen je Feldart fest. Um Ereignisse über Personen außerhalb der eigenen Rollen der App zu erhalten, benötigen die Berechtigungen außerdem 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

Welche Felder abonniert easyCoexistence?

Drei: feed, messages und mention. Wenn eine Seite verbunden wird, sendet easyCoexistence POST /{page-id}/subscribed_apps mit diesen Feldern und dem Token der Seite und leitet danach jeden Eintrag für diese Seite an den von Ihnen festgelegten Endpoint weiter, signiert mit X-EC-Signature. Kommentarregeln und Automationen reagieren auf neue Kommentare aus feed und auf Nachrichten, Erwähnungen werden unverändert weitergeleitet. Kein weiteres Feld ist abonniert, daher werden message_echoes, Postbacks, Lesebestätigungen, Übergaben, standby und Profiländerungen nicht weitergeleitet.

Häufige Fehler

  • Die Seite auf ein Feld abonnieren, das die App nicht abonniert hat. Meta liefert nur Felder, die sowohl auf Seiten- als auch auf App-Ebene abonniert sind.
  • Messenger-Ereignisse als Änderungen parsen. Sie kommen in entry.messaging, mit einem messaging-Objekt pro Eintrag, nicht in entry.changes.
  • Die eigenen Antworten der Seite in Nachrichten erwarten. Von der Seite gesendete Nachrichten kommen über message_echoes, ein eigenes Feld.
  • Bei einer großen Seite auf feed für Likes setzen. Meta sendet Like-Benachrichtigungen nur für Seiten mit weniger als 10.000 Likes.
Mit EasyCoexistence

Kommentarregeln und Automationen reagieren auf neue Kommentare und Nachrichten. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.

Häufig gestellte Fragen

Schließt das Feld feed Kommentare zu Anzeigen ein?

Ja. Meta sendet für die Anzeigenbeiträge selbst nichts, aber Kommentare dazu kommen über feed an.

Was ändert die Einstellung Include Values?

Ist sie eingeschaltet, enthält eine Änderung die neuen Werte in changes. Ist sie ausgeschaltet, sendet Meta nur die Namen der geänderten Felder in changed_fields.

Wie sehe ich, welche Felder eine Seite abonniert hat?

GET /{page-id}/subscribed_apps mit dem Token der Seite listet die installierten Apps der Seite auf und für jede deren subscribed_fields.

Leitet easyCoexistence Profiländerungen der Seite weiter?

Nein. Mit easyCoexistence verbundene Seiten sind nur auf feed, messages und mention abonniert, daher werden name, picture und die übrigen Profilfelder nicht weitergeleitet.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am