Webhooks von Meta

Subscriptions-Edge

Du kannst die /app/subscriptions-Edge der Graph API nutzen, um das Webhooks-Produkt deiner App zu konfigurieren und zu verwalten. In unserer Dokumentation zu /app/subscriptions erfährst du, welche Vorgänge du mit dieser Edge ausführen kannst und welche Berechtigungen dafür erforderlich sind. Dieses Dokument behandelt nur einige gängige Vorgänge.

Erstellen von Abonnements

Um ein Objekt und seine Felder zu abonnieren, sende eine POST-Anfrage an die /app/subscriptions-Edge und schließe die folgenden Parameter ein:

  • object: Der Objekttyp, für den du Feldabonnements einrichten möchtest (z. B. user).
  • callback_url: Die URL deines Endpunkts.
  • verify_token: Ein string, den wir jedes Mal einschließen, wenn wir dir eine Verifizierungsanfrage senden.
  • fields: Die Felder, die du abonnieren möchtest (z. B. photos).

Wenn die ID deiner App beispielsweise 188559381496048 lautet und du benachrichtigt werden möchtest, wenn der*die Nutzer*in deiner App ein neues Foto veröffentlicht, kannst du Folgendes tun:

Beispielanfrage

curl -F "object=user" \ -F "callback_url=https://your-clever-domain-name.com/webhooks" \ -F "fields=photos" \ -F "verify_token=your-verify-token" \ -F "access_token=your-app-access-token" \ "https://graph.facebook.com/188559381496048/subscriptions"

Beispielantwort

Bei Erfolg:

{
  "success": "true"
}

Abrufen von Abonnementinformationen

Um die für deine App eingerichteten Objekt- und Feldabonnements anzuzeigen, sende eine GET-Anfrage an die /app/subscriptions-Edge. Wenn deine ID deiner App beispielsweise 188559381496048 lautet, könntest du Folgendes tun:

Beispielanfrage

GET graph.facebook.com/188559381496048/subscriptions

Beispielantwort

{ "data": [ { "object": "user", "callback_url": "https://your-clever-domain-name.com/webhooks", "active": true, "fields": [ { "name": "photos", "version": "v2.10" }, { "name": "feed", "version": "v2.10" } ] } ] }