Webhook für den Facebook-Seiten-Feed: Kommentare, Beiträge und Reaktionen
Das Feld feed der Facebook-Seiten-Webhooks meldet nahezu alle Änderungen am Feed einer Seite, sobald sie geschehen. Jede Änderung enthält ein item, etwa Beitrag, Kommentar oder Reaktion, und ein verb, etwa add, edit oder remove, dazu die beteiligten IDs, den Autor in from und den Text in message. Meta sendet sie als JSON, signiert mit X-Hub-Signature-256.
easyCoexistence abonniert jede verbundene Seite für das Feld feed und leitet deren Änderungen sofort an Ihren HTTPS-Endpoint weiter, signiert mit dem Geheimnis dieser Seite.
Benachrichtigungen über Seiten-Likes werden nur für Seiten mit weniger Likes als diesen gesendet.
Das Feld feed sendet für Anzeigenbeiträge selbst nichts, wohl aber Kommentare darunter.
Eine Berechtigung, die ein Seiten-Administrator mit MODERATE-Rechten erteilen muss, damit Seiten-Webhooks eine App erreichen.
Die meisten Aktualisierungen bündelt Meta in einer Webhook-Zustellung, garantiert das aber nicht.
Wie lange Meta fehlgeschlagene Zustellungen an den Endpoint der App mit abnehmender Frequenz erneut versucht.
Was meldet das Feld feed?
Nahezu alle Änderungen am Feed einer Seite, in Metas Worten etwa Beiträge, Kommentare, Reaktionen und Shares; was eine Änderung enthält, hängt von ihrer Art ab. Für Anzeigenbeiträge selbst sendet Meta nichts, wohl aber treffen Kommentare darunter ein. Benachrichtigungen über Seiten-Likes sendet Meta nur, solange eine Seite weniger als 10.000 Likes hat.
Was bedeuten item und verb?
Zwei Felder im value jeder Änderung sagen, was geschehen ist:
- item: was sich geändert hat, aus Metas Liste, die unter anderem post, status, photo, video, link, share, comment, reaction und album umfasst.
- verb: was damit geschehen ist: add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute oder update.
- Ein neuer Kommentar kommt mit item comment und verb add, genau danach suchen Kommentar-zu-DM-Regeln.
- Eine Reaktion trägt item reaction und einen
reaction_type, der sie benennt.
Wie sieht eine Feed-Änderung aus?
Ein POST, dessen JSON object auf page gesetzt ist und je Seite einen entry enthält, mit der ID der Seite, einer Zeit und einem Array von changes. Dies ist Metas eigenes Beispiel, eine Person veröffentlicht auf der Seite:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1520544816,
"changes": [
{
"field": "feed",
"value": {
"from": { "id": "<USER_ID>", "name": "<NAME>" },
"item": "post",
"post_id": "<PAGE_POST_ID>",
"verb": "add",
"created_time": 1520544814,
"is_hidden": false,
"message": "<POST_TEXT>"
}
}
]
}
]
}Welche Felder kann eine Änderung enthalten?
Meta führt diese unter den Feldern des value einer Feed-Änderung auf, je nach Art der Änderung vorhanden:
post_id,comment_idundparent_id: der Beitrag, der Kommentar und das, wozu er gehört.- from: die ID und der Name des Urhebers der Änderung.
- message: der Text, mit link, photo, photos oder video für angehängte Inhalte.
created_time, undedited_timebei Bearbeitungen.reaction_typebei Reaktionen undis_hiddendafür, ob ein Beitrag ausgeblendet ist.- post: Details wie
status_type,is_published,updated_timeundpermalink_url.
Wie wird eine Seite abonniert?
Die App sendet POST /{page-id}/subscribed_apps mit subscribed_fields=feed und dem Token der Seite, von jemandem, der die Aufgaben CREATE_CONTENT, MANAGE oder MODERATE ausführen kann, mit erteilten Berechtigungen pages_manage_metadata und pages_show_list. Meta sendet Benachrichtigungen nur, solange die App auf der Seite installiert ist und die App-Plattform in deren Einstellungen nicht abgeschaltet wurde. easyCoexistence abonniert beim Verbinden jede Seite für feed, messages und mention.
Wie erreichen Feed-Ereignisse Ihren Endpoint?
Meta liefert sie an die App von easyCoexistence, die X-Hub-Signature-256 prüft, Meta sofort antwortet und jeden entry einer verbundenen Seite an den HTTPS-Endpoint weiterleitet, den Sie dafür festgelegt haben. Die Weiterleitung trägt einen Header X-EC-Signature, eine HMAC-SHA256 aus einem Zeitstempel und dem rohen Body, signiert mit dem Geheimnis dieser Seite, und wird genau einmal gesendet, ohne gespeicherte Kopie und ohne Wiederholungen. Den Endpoint setzen Sie mit set_social_webhook_destination oder mit PUT /channels/:id/webhook über die Partner-API.
Welche Feed-Änderungen starten Kommentarregeln und Automatisierungen?
Nur neue Kommentare: eine Änderung mit item comment und verb add auf einem der Beiträge der Seite. Kommentar-zu-DM-Regeln prüfen deren message auf ihre Schlüsselwörter und überspringen Kommentare, die die Seite selbst verfasst hat, und Automatisierungen übernehmen die Kommentare, auf die keine Regel geantwortet hat. Bearbeitungen, Ausblendungen, Reaktionen und Beiträge gehen direkt an Ihren Endpoint, sofern Sie einen festgelegt haben.
Häufige Fehler
- Jede Feed-Änderung als neuen Kommentar behandeln. Prüfen Sie item und verb: Reaktionen, Bearbeitungen, Ausblendungen und Entfernungen kommen über dasselbe Feld.
- Auf die eigenen Kommentare der Seite antworten. Deren Antworten kommen ebenfalls als Feed-Änderungen zurück, also überspringen Sie alle, deren from.id die ID der Seite ist.
- Eine Änderung pro Zustellung annehmen. Meta kann bis zu 1.000 Aktualisierungen bündeln, durchlaufen Sie daher jeden entry und jede change darin.
- entry.time als Zeitpunkt der Änderung lesen. Meta setzt sie auf den Zeitpunkt, an dem die Benachrichtigung gesendet wurde; created_time im value ist der Zeitpunkt, an dem das Objekt erstellt wurde.
Kommentar-zu-DM-Regeln und Automatisierungen reagieren auf neue Kommentare. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung. Die ersten 3 Tage sind eine kostenlose Testphase.
Häufig gestellte Fragen
Enthält der Feed-Webhook Kommentare?
Ja. Ein neuer Kommentar kommt als Feed-Änderung mit item comment und verb add, mit comment_id, post_id, from und message.
Bekomme ich Webhooks für Seiten-Likes?
Nur für Seiten mit weniger als 10.000 Likes, laut Metas Referenz zu Seiten-Webhooks.
Sind Anzeigenbeiträge im Feed-Webhook enthalten?
Die Anzeigenbeiträge selbst nicht, wohl aber Kommentare darauf.
Brauche ich eine eigene Meta-App, um die Feed-Ereignisse einer Seite zu erhalten?
Nein. Meta liefert sie an die App von easyCoexistence, die jedes Ereignis an den Endpoint weiterleitet, den Sie für diese Seite festgelegt haben.
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