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.
Abonnement-Felder laut Metas Referenz zu den Seiten-Webhooks, von feed und mention bis zu Messenger- und Profilfeldern.
Berechtigung, die ein Seiten-Administrator mit MODERATE-Rechten erteilen muss, bevor Seiten-Webhooks eine App erreichen.
Ein eigenes Messenger-Feld für Nachrichten, die die Seite sendet, nur für Messenger-Unterhaltungen verfügbar.
Seitenaufgabe für das Abonnement von leadgen, mit leads_retrieval, ads_management, pages_read_engagement und pages_manage_metadata.
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:
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:
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_updateundcall_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_integrityundmessaging_integrity: Integritätsupdates, mit Verstößen, Einschränkungen und Maßnahmen-Ereignissen inbusiness_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 undpublic_transit. - Lokal:
price_range,payment_options, attire undculinary_team. - Persönliches: birthday,
personal_infoundpersonal_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:
| 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 |
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.
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