Webhooks für Seiten kann dir bei Änderungen an deinen Seiten Benachrichtigungen in Echtzeit senden. Du kannst z. B. Echtzeit-Updates erhalten, wenn Nutzer*innen in deinem Feed posten, einen Beitrag kommentieren oder deine Beiträge mit „Gefällt mir” markieren.
So richtest du einen Webhook für eine Seite ein:
Befolge unseren Leitfaden für die ersten Schritte, um deinen Endpunkt zu erstellen und das Webhooks-Produkt zu konfigurieren. Wähle bei der Konfiguration unbedingt das Objekt Seite aus und abonniere eines oder mehrere der unten stehenden Seitenfelder.
Feld | Beschreibung |
---|---|
| Du wirst benachrichtigt, wenn der Feed einer Seite geändert wurde; Beiträge, Reaktionen, Teilen-Events etc. |
| Du wirst benachrichtigt, wenn deine Seite eine Nachricht über Messenger erhalten hat. Eine Liste aller verfügbaren Webhook-Felder für Nachrichten findest du im Leitfaden zu Webhooks für die Messenger-Plattform. |
Webhooks-Benachrichtigungen werden nur gesendet, wenn deine Webhooks-konfigurierte App für deine Seite installiert ist und die Seite die App-Plattform in den App-Einstellungen nicht deaktiviert hat. Wenn die App für deine Seite installiert werden soll, kannst du den Zugriffsschlüssel der Seite nutzen, sodass deine App eine POST
-Anfrage an die subscribed_apps-Edge der Seite sendet.
CREATE_CONTENT
, MANAGE
oder MODERATE
auf der angeforderten Seite ausführen kann
pages_manage_metadata
und pages_show_list
sind für die feed
-Webhooks erforderlich.pages_messaging
ist ebenfalls für messages
erforderlich.Nur für Nachrichtenfelder
MESSAGING
für die abgefragte Seite ausführen kanncurl -i -X POST "https://graph.facebook.com/{page-id}/subscribed_apps ?subscribed_fields=feed &access_token={page-access-token}"
{ "success": "true" }
Wenn du ermitteln möchtest, welche Apps für deine Seite installiert sind, sende stattdessen eine GET
-Anfrage:
curl -i -X GET "https://graph.facebook.com/{page-id}/subscribed_apps &access_token={page-access-token}
{ "data": [ { "category": "Business", "link": "https://my-clever-domain-name.com/app", "name": "My Sample App", "id": "{page-id}" } ] }
Wenn für deine Seite keine Apps installiert sind, gibt die API einen leeren Datensatz zurück.
Wenn du deine App nicht programmgesteuert installieren möchtest, kannst du die Installation auch ganz einfach mit dem Graph API Explorer durchführen:
pages_manage_metadata
aus. Dadurch wird dein App-Schlüssel gegen einen Nutzer-Zugriffsschlüssel mit der pages_manage_metadata
-Berechtigung getauscht.GET
klickst und POST
auswählst.me?fields=id,name
durch die ID der Seite gefolgt von /subscribed_apps
und übermittle die Anfrage dann. Deine App kann einen Seiten-Feed abonnieren und jedes Mal benachrichtigt werden, wenn Änderungen am Feed vorgenommen werden. Dies ist beispielsweise eine Benachrichtigung, die gesendet wird, wenn ein*e Nutzer*in etwas auf einer Seite veröffentlicht hat.
[ { "entry": [ { "changes": [ { "field": "feed", "value": { "from": { "id": "{user-id}", "name": "Cinderella Hoover" }, "item": "post", "post_id": "{page-post-id}", "verb": "add", "created_time": 1520544814, "is_hidden": false, "message": "It's Thursday and I want to eat cake." } } ], "id": "{page-id}", "time": 1520544816 } ], "object": "page" } ]
Nutze die post_id
aus der Benachrichtigung, um den Seitenbeitrag zu kommentieren.
curl -i -X POST "https://graph.facebook.com/{page-post-id}/comments ?message=I%20want%20chocolate%20cake%20! &access_token=page-access-token"
{ "id": "{comment-id}" }