
Integrationsleitfäden
LinkedIn-API-Leitfaden
E-Mail-API-Leitfaden
WhatsApp-API-Leitfaden
Vertrieb kontaktieren
Page Access Tokens, Seitenaufgaben, pages_*-Berechtigungen und App Review im Jahr 2026, und wie eine SaaS-App die Seiten verbinden kann, die ihre Nutzer verwalten.
graph.facebook.com/me/accounts?fields=id,name,tasks,access_token access_token: {PAGE_ACCESS_TOKEN_1}
access_token: {PAGE_ACCESS_TOKEN_2}
Ein Page Token pro Seite, Admin und App
Die Facebook Page API (bei Meta „Facebook Pages API“) ist eine Gruppe von Graph-API-Endpoints zur Verwaltung einer Facebook-Seite: Beiträge veröffentlichen und lesen, Kommentare moderieren, Insights lesen und Unterhaltungen der Seite bearbeiten. Jeder Aufruf braucht ein Page Access Token, das von einer Person mit Aufgaben auf der Seite stammt. Für Ihre eigenen Seiten, verwaltet von Personen mit einer Rolle in Ihrer App, ist kein App Review nötig; um die Seiten Ihrer Kunden zu bedienen, braucht es eine App, die das App Review bestanden hat.
Für ein SaaS mit vielen Kunden gibt es ein zweites Modell: Nutzer verbinden ihre Facebook-Konten über Unipile, und ihre Seiten kommen mit der Verbindung.
Die Seiten Ihrer Nutzer, ohne ein Page Access Token verwalten zu müssen
Verbinden. Ihr Nutzer verbindet sein Facebook-Konto über Hosted Auth, seine Seiten kommen automatisch mit. Keine Meta-App, kein App Review.
Seiten auflisten. Rufen Sie GET /v2/{ACCOUNT_ID}/inboxes mit Ihrem X-API-KEY auf: Jede Seite ist eine Inbox PAGE_<page_id>_INBOX.
Als Seite handeln. Antworten Sie mit POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send oder veröffentlichen Sie mit post_as als Seite.
Sie ist der Teil der Graph API rund um den Page-Knoten: Endpoints, die eine Seite, ihre Beiträge, Kommentare und Kennzahlen lesen und ändern. Messaging läuft über die Messenger Platform und Anzeigen über die Marketing API, mit demselben Page Access Token.
Trotz des Namens ist die Graph API kein GraphQL. Sie ist eine versionierte HTTP-API unter graph.facebook.com, organisiert in Knoten, Kanten und Feldern. Das Gesamtbild (Login, Messenger, Versionen, Rate Limits) zeigt unser Überblick, wie die Facebook-APIs zusammenspielen.
GET / POST /{page-id}pages_manage_metadata · MANAGEPOST /{page-id}/feedpages_manage_posts · CREATE_CONTENTGET / POST /{post-id}/commentspages_read_user_content, pages_manage_engagement · MODERATEGET /{page-id}/insightsread_insights, pages_read_engagement · ANALYZEGET /{page-id}/conversationspages_messaging · MESSAGINGPOST /{page-id}/subscribed_appspages_manage_metadata, pages_show_listAufrufe mit einem Page Access Token fallen unter Metas Business-Use-Case-Limits, die pro Seite gezählt werden: 4.800 Aufrufe mal die Anzahl der aktiven Nutzer innerhalb von 24 Stunden, wobei aktive Nutzer die Personen sind, die in diesem Zeitraum mit der Seite interagiert haben. Jede Antwort enthält einen Header X-Business-Use-Case-Usage mit Ihrer aktuellen Nutzung. Die Limits der übrigen Facebook-APIs finden Sie in unserem Leitfaden zur Facebook-API.
Quellen: Metas Überblick zur Pages API, Manage a Page, Page Insights, Webhooks for Pages, Posts, Comments, Page Conversations, subscribed_apps, Rate Limiting und Referenz der Berechtigungen. Zuletzt geprüft: 17. November 2026.
Einen API-Schlüssel für die Facebook Page API gibt es nicht. Ein Seitenadmin meldet sich mit Facebook Login for Business bei Ihrer Meta-App an, wodurch Sie ein User Access Token erhalten. Anschließend liefert GET /me/accounts jede Seite, die er verwaltet, mit seinen Aufgaben und je einem Page Access Token.
Auf Meta for Developers, mit dem Anwendungsfall „Manage everything on your Page“.
App ID + App Secretpages_show_list und alles anfordern, was Ihre Funktionen brauchen.
Kurzlebig; tauschen Sie es serverseitig (fb_exchange_token) gegen ein langlebiges.
Jede Seite liefert ihre ID, Aufgaben und ihr Token.
GET /me/accountsMeta: „Page Access Tokens sind für jede Kombination aus Seite, Admin und App eindeutig.“ Zehn Kundenseiten bedeuten zehn Tokens, die Sie speichern und überwachen müssen.
Den Austauschaufruf und die Anfrage an /me/accounts können Sie direkt im Tab „Meta-Token-Austausch“ des Codeblocks weiter unten kopieren. User, App und System User Tokens behandelt unser Leitfaden zum Facebook API Access Token.
So testen Sie auf einer Seite, die Sie verwalten, ohne Code zu schreiben:
pages_show_list sowie die Berechtigungen hinzu, die Sie testen möchten.Das hängt vom User Token ab, von dem Sie ausgehen. Ein Page Token, das mit einem kurzlebigen User Token abgerufen wurde, gilt etwa eine Stunde. Tauschen Sie das User Token zuerst gegen ein langlebiges, rufen Sie /me/accounts erneut auf, und laut Meta hat das erhaltene Page Token kein Ablaufdatum, kann aber trotzdem ungültig werden.
Quellen: Metas Access Tokens, Long-Lived Access Tokens und Get a Page Access Token; die Schritte im Graph API Explorer stammen aus dessen Leitfaden. Meta ergänzt: „Verlassen Sie sich nicht darauf, dass diese Gültigkeitsdauern gleich bleiben.“ Zuletzt geprüft: 17. November 2026.
Ja. Ein langlebiges Page Access Token, das Sie durch den Aufruf von /me/accounts mit einem langlebigen User Token erhalten, hat kein Ablaufdatum. Laut Meta laufen langlebige Page Access Tokens „nur unter bestimmten Bedingungen ab oder werden ungültig“. Das ist das „permanente“ Page Token, von dem die meisten Anleitungen sprechen. Ewig gilt es trotzdem nicht: Die unten genannten Ereignisse machen es weiterhin ungültig, also speichern Sie es, überwachen Sie Fehler und planen Sie einen Ablauf zum erneuten Verbinden. Für Seiten Ihres eigenen Unternehmens ist ein System User Token die Alternative.
Meta meldet diese Fälle als Fehler 190. Die Subcodes und wie Sie ein Token mit debug_token prüfen, beschreibt unser Leitfaden zum Facebook API Access Token; bei einem Page Token ist die Lösung immer dieselbe: Bitten Sie den Admin, sich neu zu verbinden.
Ein Aufruf gelingt nur, wenn die Person hinter dem Token die passende Aufgabe auf der Seite ausführen darf und Ihre App die passende Berechtigung besitzt, mit Advanced Access für Personen außerhalb Ihrer App.
Aufgaben legen fest, was eine Person auf einer Seite tun darf. /me/accounts listet sie pro Seite auf; ein Admin darf alle ausführen.
Berechtigungen legen fest, was Ihre App tun darf. Eine Meta-App mit dem Anwendungsfall „Manage everything on your Page“ startet mit pages_show_list, business_management und public_profile. Fügen Sie nur hinzu, was eine Funktion nutzt: Jede Berechtigung wird einzeln geprüft.
pages_read_engagementDas Lesen von Seiten, die Sie nicht verwalten, ist ein anderer Fall: Es erfordert die Funktion Page Public Content Access, die Meta auf das Analysieren oder Anzeigen von Beiträgen und Interaktionen auf Seiten beschränkt, mit eigenem App Review und eigener Business Verification.
Quellen: Metas Überblick zur Pages API (Aufgaben), Manage a Page (MANAGE für Einstellungen), Page Insights, Referenz der Berechtigungen (Beschreibungen, zusammengefasst) und Page Public Content Access. Zuletzt geprüft: 17. November 2026.
Ihre App startet mit Standard Access, und Meta stellt klar: „Berechtigungen mit Standard Access können nur von App-Nutzern angefordert werden, die eine Rolle in der anfragenden App haben.“ Ihr Prototyp funktioniert auf Ihrer Seite und scheitert, sobald sich ein Kunde anmeldet. Um seine Seiten zu bedienen, brauchen Sie Advanced Access, der pro Berechtigung über das App Review gewährt wird.
Nur Personen mit einer Rolle in der App können Berechtigungen erteilen.
Ein Antrag pro Berechtigung und ein verifiziertes Unternehmen.
Jeder Seitenadmin kann die genehmigten Berechtigungen erteilen.
Einmal live, ist jede Kundenseite eine eigene kleine Integration: ein Admin-Login, ein gespeichertes Token, die Aufgaben dieses Admins, eine Statusprüfung und ein Ablauf zur erneuten Verbindung. Nichts in der Facebook Page API verwaltet das mandantenübergreifend für Sie. Metas Einreichungsleitfaden verlangt:
Meta verlangt außerdem eine Unternehmensverifizierung: „Für Advanced Access ist eine Business Verification erforderlich.“
Quellen: Metas Zugriffsstufen, Anleitung zur Einreichung beim App Review und Überblick zur Pages API („Alle seitenbezogenen Berechtigungen und Funktionen müssen im App Review genehmigt werden“). Zuletzt geprüft: 17. November 2026.
Unterhaltungen einer Seite gehören nicht zur Pages API selbst. Sie laufen über die Messenger Platform, mit demselben Page Access Token, der Berechtigung pages_messaging und der Aufgabe MESSAGING.
Personen werden über eine seitenbezogene ID (PSID) identifiziert, sie schreiben zuerst, und die Seite kann bis 24 Stunden nach ihrer letzten Nachricht antworten. Wie eine SaaS-App diese Unterhaltungen liest und beantwortet, zeigt unsere Seite zur Facebook Messenger API. Für Unterhaltungen in einem privaten Profil lesen Sie Facebook Messenger API für private Konten; was Meta berechnet, steht unter Preise der Facebook Messenger API.
Mit Unipile verbindet Ihr Nutzer sein Facebook-Konto einmalig über Hosted Auth. Die Seiten, die er administriert, werden standardmäßig auf derselben account_id aktiviert. Keine Meta-App, kein App Review, kein Page Token auf Ihrer Seite.
Ein Problem auf einer Seite betrifft weder das persönliche Postfach noch die anderen Seiten.
api.unipile.com/v2/{ACCOUNT_ID}/inboxes
200 OK
PAGE_<page_id>_INBOX erscheintpost_as (Facebook Post API)501 api/not_implemented)Jede Seite meldet ihren eigenen Status unter metadata.products_connection_status (Schlüssel page_<page_id>). Dieselbe Verbindung umfasst die persönlichen Nachrichten des Admins, und dieselbe API deckt LinkedIn, WhatsApp, Instagram, Telegram, E-Mail und Kalender ab.
Die Seiten auflisten und dann eine Unterhaltung der Seite beantworten. Der Tab „Meta Graph API“ nutzt ein Page Token, der Tab „Meta-Token-Austausch“ zeigt, wie Sie ein Page Token ohne Ablaufdatum erhalten, und der Tab „Unipile“ nutzt das verbundene Konto.
# 1. List the Pages a person manages, with tasks and Page tokens
curl "https://graph.facebook.com/me/accounts?fields=id,name,tasks,access_token&access_token={USER_ACCESS_TOKEN}"
# Response (abridged)
{ "data": [ {
"id": "{PAGE_ID}",
"name": "Northwind Bakery",
"tasks": ["CREATE_CONTENT", "MODERATE", "MESSAGING", "ANALYZE"],
"access_token": "{PAGE_ACCESS_TOKEN}"
} ] }
# 2. Store one token per Page, then call Page endpoints with it
curl "https://graph.facebook.com/{PAGE_ID}/conversations?platform=messenger&access_token={PAGE_ACCESS_TOKEN}"
# 1. Server side: exchange the short lived user token for a long lived one
curl "https://graph.facebook.com/oauth/access_token?grant_type=fb_exchange_token&client_id={APP_ID}&client_secret={APP_SECRET}&fb_exchange_token={SHORT_LIVED_USER_TOKEN}"
# Response
{ "access_token": "{LONG_LIVED_USER_TOKEN}", "token_type": "bearer", "expires_in": 5183944 }
# 2. Call /me/accounts with the long lived user token:
# the Page tokens it returns have no expiration date
curl "https://graph.facebook.com/me/accounts?fields=id,name,tasks,access_token&access_token={LONG_LIVED_USER_TOKEN}"
# 1. List the inboxes of the connected account: one per managed Page,
# with the ID PAGE_{PAGE_ID}_INBOX
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes" \
--header "X-API-KEY: {YOUR_API_KEY}"
# 2. List the chats of one Page inbox
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes/PAGE_{PAGE_ID}_INBOX/chats" \
--header "X-API-KEY: {YOUR_API_KEY}"
# 3. Reply in a Page chat (chat ID PAGE_{PAGE_ID}_{THREAD_KEY})
curl --request POST \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send" \
--header "X-API-KEY: {YOUR_API_KEY}" \
--header "content-type: application/json" \
--data '{ "text": "Yes, we open at 9am on Sunday." }'
Die Meta-Aufrufe wurden am 17. November 2026 mit Long-Lived Access Tokens abgeglichen. Aktivierung, Postfach-IDs und post_as sind in der Dokumentation zu Facebook-Seiten beschrieben.
Jeder Nutzer verbindet sein eigenes Konto
Unipile ist ein unabhängiges Unternehmen, keine offizielle Meta-App und kein Meta-Partner. Unipile verbindet sich im Auftrag jedes authentifizierten Nutzers, und jeder Nutzer bleibt an die Bedingungen von Meta gebunden. Nutzen Sie es für Kundenunterhaltungen auf Seiten, die Ihre Nutzer verwalten.
Metas Pages API passt zu einem Team, das eigene Seiten verwaltet oder Insights und Anzeigen braucht. Ein verbundenes Konto passt zu einem SaaS, dessen Nutzer ihre eigenen Seiten mitbringen.
| Frage | Meta Pages API | Mit Unipile verbundenes Konto |
|---|---|---|
| Wer verbindet die Seite | Ein Seitenadmin, über Facebook Login for Business in Ihrer Meta-App | Ihr Nutzer, über Hosted Auth |
| Meta-App und App Review | Erforderlich, dazu Advanced Access und Unternehmensverifizierung | Auf Ihrer Seite nicht nötig |
| Zu verwaltende Tokens | Ein Page Token pro Seite, Admin und App | Keine: eine account_id und Ihr API-Schlüssel |
| Nachrichten der Seite | Messenger Platform, pages_messaging, 24-Stunden-Fenster | Lesen und antworten; eine Seite kann keine Unterhaltung beginnen |
| Als Seite veröffentlichen | pages_manage_posts | post_as am Posts-Endpoint |
| Persönliches Konto des Admins | Für Messaging nicht verfügbar | Dieselbe Verbindung: persönliche Chats, Beiträge und Profil |
| Status pro Seite | Sie prüfen jedes Token selbst | page_<page_id> in products_connection_status |
account_id und Ihr API-Schlüsselpages_messaging, 24-Stunden-Fensterpages_manage_postspost_as am Posts-Endpointpage_<page_id> in products_connection_statusSchwanken Sie noch zwischen Login, Messenger, Marketing API und Pages? Unser Entscheidungsraster zeigt, welche Facebook-API Sie brauchen, je nach Produkttyp.
Seiten verbinden, ohne Token-Pipeline
Lassen Sie jeden Nutzer sein Facebook-Konto einmalig verknüpfen und arbeiten Sie mit den Postfächern und Beiträgen seiner Seiten über dieselbe API wie mit seinen LinkedIn-, WhatsApp- und E-Mail-Konten. 7 Tage kostenlos testen, ohne Kreditkarte.
Jeder Nutzer verbindet sein eigenes Konto, ohne Speicherung von Profilen. Unipile ist kein Meta-Partner. Mehr erfahren
Alle Endpoints der Facebook-API an einem Ort
Seiten sind nur ein Teil des Ganzen. Sehen Sie alle mit Unipile verfügbaren Facebook-Endpoints (Nachrichten, Beiträge, Kommentare, Profile, Webhooks) oder lesen Sie den vollständigen Leitfaden zur Facebook-API.
Kurze Antworten zum Facebook Page Access Token, seiner Gültigkeit, App Review und Berechtigungen.
Melden Sie einen Seitenadmin mit Facebook Login for Business bei Ihrer Meta-App an und fordern Sie pages_show_list an. Tauschen Sie das User Token auf Ihrem Server mit grant_type=fb_exchange_token gegen ein langlebiges und rufen Sie dann GET /me/accounts auf: Jede Seite kommt mit ihrem eigenen access_token und den Aufgaben zurück, die der Admin ausführen darf.
Das hängt vom zugrunde liegenden User Token ab. Laut Meta ist ein Page Token, das mit einem kurzlebigen User Token abgerufen wurde, 1 Stunde gültig. Stammt es aus einem langlebigen User Token (etwa 60 Tage), hat das Page Token kein Ablaufdatum, wird aber durch eine Abmeldung, eine Passwortänderung oder das Entfernen der App trotzdem ungültig.
Ja. Rufen Sie /me/accounts mit einem langlebigen User Token auf, dann haben die zurückgegebenen Page Tokens kein Ablaufdatum. Dauerhaft gültig sind sie nicht in jedem Fall: Verliert der Admin seine Rolle auf der Seite, ändert er sein Passwort oder entfernt er Ihre App, funktioniert das Token nicht mehr und der Admin muss sich neu verbinden.
Ihre App hat nur Standard Access, daher können ihr nur Personen mit einer Rolle in der App Berechtigungen erteilen. Um Kundenseiten zu bedienen, braucht jede Berechtigung Advanced Access, der über das App Review mit einer Bildschirmaufnahme pro Berechtigung gewährt wird, und Meta verlangt dafür eine Unternehmensverifizierung.
Fast jede Integration beginnt mit pages_show_list. Fügen Sie dann nur hinzu, was Sie nutzen: pages_read_engagement zum Lesen von Inhalten und Metadaten, pages_manage_posts zum Veröffentlichen, pages_manage_engagement für Kommentare, pages_messaging für Unterhaltungen, pages_manage_metadata für Webhooks und Einstellungen sowie read_insights für Kennzahlen.
Nein. Unipile ist ein unabhängiges Unternehmen, kein Meta Partner, und wird von Meta weder unterstützt noch gesponsert oder genehmigt. Die Verbindung von Seiten über Unipile macht Ihr Produkt auch nicht zu einer Meta-App. Facebook und Messenger sind Marken von Meta Platforms, Inc.
Nein. Statt einer Meta-App, die Page Access Tokens sammelt, verbinden Ihre Nutzer ihr Facebook-Konto einmal über die gehostete Authentifizierung von Unipile, und die Seiten, die sie verwalten, kommen mit dieser Verbindung. Auf Ihrer Seite sind weder App Review noch Advanced Access oder Business Verification nötig.
Sie ist im Sinne des Digital Markets Act aufgebaut: Jeder Seitenadmin verbindet sein eigenes Konto, Unipile handelt in seinem Namen für die Seiten, die er bereits verwaltet, und speichert keine Nutzerprofile. Details finden Sie auf unserer Seite zum Digital Markets Act.
Ja. Eine über Unipile verbundene Seite unterliegt weiterhin den Nutzungsbedingungen und Seitenrichtlinien von Meta. Beschränken Sie sich auf legitime Nutzungen wie das Beantworten von Kunden im Postfach der Seite, das Veröffentlichen eigener Inhalte der Seite oder das Synchronisieren von Unterhaltungen mit einem CRM; Spam und unerlaubte Automatisierung können zur Einschränkung des Kontos oder der Seite führen.
Noch Fragen? Unser Team hilft Ihnen gern.
Mit einem Experten sprechen