AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Facebook-Seite für Webhooks abonnieren: der Edge subscribed_apps

Eine Facebook-Seite wird mit POST /{page-id}/subscribed_apps für die Webhooks einer App abonniert, wobei subscribed_fields wie feed,messages sowie ein Zugriffs-Token der Seite von jemandem mit der Aufgabe CREATE_CONTENT, MANAGE oder MODERATE übergeben werden. Dafür müssen pages_manage_metadata und pages_show_list gewährt sein. Meta sendet die Ereignisse eines Felds nur, wenn die App es ebenfalls abonniert. GET listet das Abo auf, DELETE entfernt es.

easyCoexistence abonniert jede Seite, die Sie verbinden, für feed, messages und mention über subscribed_apps, meldet sie ab, wenn Sie sie entfernen, und leitet die Ereignisse der Seite an Ihren HTTPS-Endpoint weiter, signiert mit einem Secret für diese Seite, über einen MCP-Connector oder die Partner API.

Both levels

Nur Felder, die sowohl auf Seiten- als auch auf App-Ebene abonniert sind, erzeugen Webhooks. Eine Seite kann mehr Felder auflisten als die App.

CREATE_CONTENT, MANAGE or MODERATE

Seitenaufgaben, von denen die Person hinter dem Token eine benötigt, um ein Abo zu lesen oder zu erstellen.

messaging_success

Wird neben success zurückgegeben, wenn eine App ihr Webhook-Abo mit DELETE von einer Seite entfernt.

App access token

Was /{app-id}/subscriptions benötigt, um das Abo auf App-Ebene zu lesen, zu erstellen oder zu löschen.

1 hour

Fehlgeschlagene Messenger-Zustellungen, bevor Meta die App von der Seite abmeldet, bis sie erneut abonniert wird.

Was macht der Edge subscribed_apps?

Er installiert die App auf der Seite und legt fest, welche Webhook-Felder der Seite die App erhält. Meta sendet Benachrichtigungen nur, solange die Seite die App installiert hat und die App-Plattform in den Einstellungen nicht deaktiviert ist. Dabei gilt nur für Felder, die auf beiden Ebenen abonniert sind: auf der Seite über diesen Edge und auf der App, festgelegt im App-Dashboard oder über /{app-id}/subscriptions. Eine Seite kann für mehr Felder abonniert sein als die App.

Wie abonnieren Sie eine Seite?

Mit einem POST an den Edge, wobei subscribed_fields die durch Kommas getrennten Felder enthält und das Zugriffs-Token der Seite mitgesendet wird. Ein erfolgreicher Aufruf gibt success true zurück. Ein Aufruf, der messages auflistet, benötigt zusätzlich pages_messaging im Token:

Subscribing a Page to three fields
POST https://graph.facebook.com/{page-id}/subscribed_apps
  ?subscribed_fields=feed,messages,mention
  &access_token=<PAGE_ACCESS_TOKEN>

{ "success": true }

Welches Token, welche Aufgaben und Berechtigungen sind erforderlich?

Ein Zugriffs-Token der Seite, das den Aufruf an genau eine Seite bindet und von jemandem stammt, der für diese Seite handeln kann. Die Referenz und die Leitfäden von Meta legen diese Anforderungen fest:

  • Jedes Feld: eine Person mit der Aufgabe CREATE_CONTENT, MANAGE oder MODERATE sowie pages_manage_metadata und pages_show_list.
  • messages und die übrigen Messenger-Felder: zusätzlich pages_messaging, auf einem Token von jemandem, der die Aufgabe MESSAGING ausführen kann.
  • leadgen: die Aufgabe ADVERTISE, mit leads_retrieval, pages_read_engagement und ads_management.
  • Das Lesen des Abos mit GET erfordert dieselben Aufgaben und Berechtigungen wie das Erstellen.

Welche Zugriffsstufe brauchen die Felder?

Advanced Access ist für Seiten und Personen außerhalb der eigenen Rollen der App gedacht. Mit Standard Access kommen Messenger-Benachrichtigungen nur von Personen mit einer Rolle in der App, etwa Admins, Entwicklern und Testern. Advanced Access wird je Berechtigung über App Review gewährt, setzt eine Unternehmensverifizierung voraus und öffnet die Benachrichtigungen den Kunden der App. Der Messenger-Leitfaden von Meta nennt außerdem die Veröffentlichung der App als Voraussetzung.

Was ist das Abo auf App-Ebene?

Der andere Teil: die Felder, auf die die App selbst hört, mit ihrer Callback-URL. Es wird im App-Dashboard oder mit POST /{app-id}/subscriptions und einem App-Zugriffs-Token festgelegt, wobei object=page, callback_url, fields, include_values und verify_token übergeben werden. Das löst Metas Verifizierungsanfrage aus. GET auf demselben Edge zeigt für jedes Objekt callback_url, fields und ob das Abo aktiv ist. Ein neues POST ändert die Felder, ohne die übrigen zu überschreiben, und DELETE entfernt alle Felder oder die genannten.

Wie prüfen Sie, worauf eine Seite abonniert ist?

Mit einem GET auf demselben Edge und dem Token der Seite. Das data-Array listet jede App auf, die die Seite installiert hat, mit Name, ID und subscribed_fields. Es ist leer, wenn auf der Seite keine Apps installiert sind:

Reading a Page's subscriptions
GET https://graph.facebook.com/{page-id}/subscribed_apps
  ?access_token=<PAGE_ACCESS_TOKEN>

{
  "data": [
    {
      "category": "Business",
      "link": "https://example.com/app",
      "name": "<APP_NAME>",
      "id": "<APP_ID>",
      "subscribed_fields": ["feed", "messages", "mention"]
    }
  ]
}

Wie entfernen Sie ein Abo?

Mit DELETE /{page-id}/subscribed_apps, wodurch die App von der Seite getrennt wird. Eine App kann ihr eigenes Abo mit einem App-Zugriffs-Token entfernen; die Antwort enthält success und messaging_success. Meta entfernt es auch selbst: Nach einer Stunde fehlgeschlagener Messenger-Zustellungen wird die App von der Seite abgemeldet und muss sich erneut abonnieren, sobald ihr Endpoint wieder funktioniert.

Was macht easyCoexistence beim Verbinden?

Es abonniert jede Seite, die die Person auswählt, direkt nach dem Speichern des Tokens dieser Seite: POST /{page-id}/subscribed_apps mit subscribed_fields auf feed,messages,mention. Verweigert Meta den Aufruf, bleibt die Seite verbunden, und list_social_accounts zeigt den Grund in last_error. Beim Entfernen der Seite wird DELETE /{page-id}/subscribed_apps gesendet, bevor das Token verworfen wird. Kein Tool erreicht subscribed_apps- oder token-Pfade, sodass das Abo allein von easyCoexistence verwaltet wird.

Häufige Fehler

  • Den Edge mit einem User-Zugriffs-Token aufrufen. Er verlangt das Zugriffs-Token der Seite, die abonniert wird.
  • Die Seite abonnieren, nicht aber die App. Ein Feld erreicht den Callback nur, wenn das Abo der App es ebenfalls enthält.
  • pages_messaging beim Abonnieren von messages weglassen. Meta verlangt es auf einem Token von jemandem, der die Aufgabe MESSAGING ausführen kann.
  • Nach einem Ausfall das erneute Abonnieren vergessen. Eine Stunde fehlgeschlagener Messenger-Zustellungen meldet die App ab, und Ereignisse bleiben aus, bis der POST erneut gesendet wird.
Mit EasyCoexistence

Ab US$ 9 pro Verbindung und Monat, sinkend auf US$ 0.75 mit jeder weiteren Verbindung. Die ersten 3 Tage sind kostenlos.

Häufig gestellte Fragen

Muss ich jede Seite einzeln abonnieren?

Ja. subscribed_apps arbeitet je Seite mit dem eigenen Token dieser Seite, während das Abo auf App-Ebene für das page-Objekt für die Seiten gilt, auf denen die App installiert ist.

Warum gibt subscribed_apps Fehler 200 zurück?

Meta führt 200 bei diesem Edge als Berechtigungsfehler. Prüfen Sie, ob das Token pages_manage_metadata und pages_show_list enthält und von jemandem mit CREATE_CONTENT, MANAGE oder MODERATE stammt.

Lässt sich eine Seite über den Graph API Explorer abonnieren?

Ja. Der Leitfaden von Meta wählt die App aus, holt ein User-Token mit pages_manage_metadata, tauscht es gegen das Token der Seite und sendet den POST an {page-id}/subscribed_apps.

Kann ich einer mit easyCoexistence verbundenen Seite Webhook-Felder hinzufügen?

Nicht über die Tools: Keines erreicht subscribed_apps-Pfade, und die Seite bleibt auf feed, messages und mention abonniert, den Feldern, die easyCoexistence weiterleitet.

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