
Integrationsleitfäden
LinkedIn-API-Leitfaden
E-Mail-API-Leitfaden
WhatsApp-API-Leitfaden
Vertrieb kontaktieren
Wie Sie jedes Token erhalten, es auf etwa 60 Tage verlängern, mit debug_token prüfen und Fehler 190 behandeln, und wie eine SaaS-App die Token-Pipeline ganz umgeht.
graph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN} applicationIhre Appis_validtrueexpires_atin 60 Tagenlanglebiges User Tokendata_access_expires_atin 90 Tagenverlängert, solange der Nutzer aktiv istscopesKein Refresh Token: erneut prüfen, dann neu anmelden
Ein Facebook API Access Token ist die Zeichenkette, die jeder Aufruf der Graph API benötigt. Ein User Token erhalten Sie über Facebook Login (oder für Tests über den Graph API Explorer). Auf Ihrem Server tauschen Sie es gegen ein langlebiges Token mit etwa 60 Tagen Laufzeit und rufen dann /me/accounts für die Page Tokens auf. Es gibt keinen API-Schlüssel und kein Refresh Token: Überwachen Sie Tokens mit debug_token und behandeln Sie Fehler 190.
Für ein SaaS mit vielen Kunden gibt es ein zweites Modell: Ihre Nutzer verbinden ihre Facebook-Konten über Unipile, und Ihre App verwaltet nie ein Meta-Token.
Kein Meta-Token zu beschaffen, zu verlängern oder zu debuggen
Konto verbinden
Ihr Nutzer verbindet sein Facebook-Konto oder seine Seite einmalig über Hosted Auth. Keine Meta-App, kein App Review.
Mit Ihrem API-Schlüssel aufrufen
Senden Sie X-API-KEY mit der account_id des Nutzers: GET /v2/{ACCOUNT_ID}/chats.
Einen einzigen Status überwachen
Prüfen Sie products_connection_status; bei Bedarf verbindet sich der Nutzer erneut über Hosted Auth.
Meta definiert ein Access Token als „eine undurchsichtige Zeichenkette, die einen Nutzer, eine App oder eine Facebook-Seite identifiziert“. Jede Anfrage an die Graph API enthält eines, und sein Typ bestimmt, in wessen Namen Sie handeln.
| Token | Handelt für | So erhalten Sie es | Laufzeit und Einsatz |
|---|---|---|---|
| User | Eine angemeldete Person | Facebook Login oder Graph API Explorer | 1 bis 2 Stunden oder etwa 60 Tage |
| Page | Eine Facebook-Seite | /me/accounts mit dem User Token eines Admins | Folgt seinem User Token |
| App | Ihre Meta-App | Aufruf mit client_credentials oder {APP_ID}|{APP_SECRET} | Nur für Server-zu-Server-Aufrufe |
| System User | Ihr Unternehmen | Business Settings | Kein Ablauf oder 60 Tage |
| Client | Ihre App, im Client-Code | App Dashboard | Nicht geheim |
/me/accounts mit dem User Token eines Adminsclient_credentials oder {APP_ID}|{APP_SECRET}Instagram hat einen eigenen Ablauf: siehe unser Instagram API Token.
Quelle: Metas Leitfaden Access Tokens. Zuletzt geprüft: 17. November 2026.
Es gibt keinen Facebook-API-Schlüssel: Jeder Aufruf verwendet ein Access Token. Für Tests erzeugen Sie im Graph API Explorer eines für Ihr eigenes Konto. In der Produktion melden sich Nutzer mit Facebook Login bei Ihrer Meta-App an (for Business, wenn Sie ihre Seiten benötigen), und Ihr Server tauscht den zurückgegebenen Code gegen ein User Access Token.
developers.facebook.com/tools/explorer/dialog/oauth mit client_id, redirect_uri, state weitercode/oauth/access_token mit dem code und dem App Secret aufDie Antwort enthält access_token, token_type und expires_in. Andere Personen können erst Berechtigungen erteilen, wenn Ihre App über das App Review Advanced Access erhalten hat. Der vollständige Zugangsweg steht in unserem Überblick zur Facebook-API, alles zu Seiten in unserem Leitfaden zur Facebook Page API.
Quelle: Metas Leitfaden Manually Build a Login Flow (Graph API v27.0). Zuletzt geprüft: 17. November 2026.
Senden Sie das kurzlebige User Token an GET /oauth/access_token, mit grant_type=fb_exchange_token, Ihrer App ID und Ihrem App Secret. Die Antwort enthält ein langlebiges Token und dessen expires_in, etwa 60 Tage. Meta ist hier eindeutig: „Führen Sie diesen Aufruf von Ihrem Server aus, nicht von einem Client.“
Die Tabs 1 bis 3 nutzen die Graph API von Meta; Tab 4 ist Unipile, ohne Meta-Token.
# Server side only: this call carries your App Secret
curl -G "https://graph.facebook.com/oauth/access_token" \
-d "grant_type=fb_exchange_token" \
-d "client_id={APP_ID}" \
-d "client_secret={APP_SECRET}" \
-d "fb_exchange_token={USER_ACCESS_TOKEN}"
# Response (abridged)
{ "access_token": "{LONG_LIVED_USER_TOKEN}", "expires_in": 5183944 }
# App access token, for server-to-server calls such as debug_token
curl -G "https://graph.facebook.com/oauth/access_token" \
-d "client_id={APP_ID}" \
-d "client_secret={APP_SECRET}" \
-d "grant_type=client_credentials"
# Or pass it directly, without the call
access_token={APP_ID}|{APP_SECRET}
# Check any token with your app token
curl -G "https://graph.facebook.com/debug_token" \
-d "input_token={LONG_LIVED_USER_TOKEN}" \
-d "access_token={APP_ID}|{APP_SECRET}"
# Response (abridged)
{ "data": {
"app_id": "{APP_ID}",
"is_valid": true,
"expires_at": 1800057600,
"data_access_expires_at": 1802649600,
"scopes": ["public_profile", "pages_show_list"]
} }
# No Meta token: your API key and the user's account_id
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes" \
--header "X-API-KEY: {API_KEY}"
# List the chats of the connected account
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
--header "X-API-KEY: {API_KEY}"
Anfragen aus Metas Leitfäden Long-Lived Access Tokens und Access Tokens. Unipile: Dokumentation zu Facebook-Seiten.
Mit dem langlebigen User Token eines Seiten-Admins liefert GET /me/accounts jede Seite mit ihrem eigenen Token, das „kein Ablaufdatum hat und nur unter bestimmten Bedingungen abläuft oder ungültig wird“. Details in unserem Leitfaden zur Facebook Page API; zum Posten damit lesen Sie, wie Sie mit dem Page Token auf einer Seite veröffentlichen.
Laut Meta ist ein kurzlebiges User Token etwa ein bis zwei Stunden gültig, ein langlebiges etwa 60 Tage. Page Tokens aus einem langlebigen Token und manche System User Tokens haben kein Ablaufdatum. Unabhängig davon endet Ihr Zugriff auf die Daten eines Nutzers nach 90 Tagen Inaktivität.
Meta schreibt: „Der Ablaufzeitraum für den Datenzugriff beträgt 90 Tage, gerechnet ab der letzten Aktivität des Nutzers.“ Der Nutzer bleibt angemeldet, aber Ihre App kann seine Daten erst wieder lesen, wenn er sie erneut autorisiert.
Kein Token ist dauerhaft: Auch ein „nie ablaufendes“ Token wird ungültig, wenn der Nutzer Ihre App entfernt, sein Passwort ändert oder seine Rolle verliert. Meta warnt: „Verlassen Sie sich nicht darauf, dass diese Gültigkeitsdauern gleich bleiben.“
Quellen: Metas Access Tokens, Long-Lived Access Tokens, Authorization vs. data access und System User Tokens. Zuletzt geprüft: 17. November 2026.
Ein System User Access Token gehört zu einem System User Ihres Business Managers, nicht zu einer Person. Laut Meta erlaubt es „Ihrer App, programmatische, automatisierte Aktionen an Werbeobjekten oder Seiten auszuführen“. Sie erzeugen es in den Business Settings.
Keine Erneuerung, für Fälle, in denen ein geleaktes Token ein vertretbares Risiko ist.
Setzen Sie set_token_expires_in_60_days=true und erneuern Sie es vor Tag 60 mit fb_exchange_token.
Quellen: Metas Install apps and generate tokens und Access Tokens. Zuletzt geprüft: 17. November 2026.
Rufen Sie GET /debug_token?input_token={TOKEN} mit einem App Access Token auf (oder mit dem User Token eines Entwicklers der App). Sie erhalten Gültigkeit, Ablauf, Ablauf des Datenzugriffs und die erteilten Berechtigungen. Ohne Code fügen Sie das Token in den Access Token Debugger ein (developers.facebook.com/tools/debug/accesstoken).
0 bedeutet kein Ablaufdatum.granular_scopes ergänzt die Ziel-IDs.Um in der Produktion zu prüfen, ob ein Facebook Access Token gültig ist, führen Sie die Anfrage aus Tab 3 des Codeblocks oben regelmäßig auf Ihrem Server aus und speichern beide Daten zu jedem Token. Eine fehlende Berechtigung in scopes erklärt die meisten Fehler nach dem Muster „bei mir geht es, bei ihnen nicht“.
Quelle: Metas Referenz zu debug_token (Graph API v27.0). Zuletzt geprüft: 17. November 2026.
Fehler 190 bedeutet, dass das Facebook Access Token abgelaufen oder ungültig ist. Er kommt als OAuthException zurück, und sein error_subcode zeigt Ihnen, worum Sie den Nutzer bitten müssen. Ein erneuter Versuch mit demselben Token behebt ihn nie.
{ "error": { "type": "OAuthException", "code": 190, "error_subcode": 460, "fbtrace_id": "EJplcsCHuLu" } }
error_subcode lesen, fbtrace_id für den Meta-Support aufbewahren
| Subcode | Bedeutung | Was zu tun ist |
|---|---|---|
| 458 | App nicht installiert | Nutzer erneut anmelden |
| 459 | Nutzer im Checkpoint | Nutzer meldet sich auf facebook.com an |
| 460 | Passwort geändert | Nutzer erneut anmelden |
| 463 | Token abgelaufen | Anmelden, dann erneut tauschen |
| 464 | Nicht bestätigter Nutzer | Nutzer meldet sich auf facebook.com an |
| 467 | Ungültiges Token | Nutzer neu verbinden |
| 492 | Keine passende Rolle auf der Seite | Neues Token von einem aktuellen Admin |
In einem SaaS mit vielen Kunden ist 492 der Klassiker: Der Admin, der eine Seite verbunden hat, verlässt das Unternehmen. Weitere Codes finden Sie in unserer Tabelle der Facebook-API-Fehler.
Quelle: Metas Leitfaden Graph API error handling. Zuletzt geprüft: 17. November 2026.
Behandeln Sie jedes Facebook Access Token wie ein Passwort für das dahinterliegende Konto: App Secret und App Tokens bleiben auf Ihrem Server, User und Page Tokens werden im Ruhezustand verschlüsselt, Serveraufrufe mit appsecret_proof signiert und Tokens gelöscht, sobald ein Kunde die Verbindung trennt.
appsecret_proof signieren. Meta definiert ihn als „einen sha256-Hash Ihres Access Tokens mit Ihrem App Secret als Schlüssel“; aktivieren Sie Require App Secret im App Dashboard.expires_at.Quellen: Metas Leitfäden Access Tokens und Securing Requests. Zuletzt geprüft: 17. November 2026.
Mit Unipile verbindet jeder Nutzer sein Facebook-Konto einmalig über Hosted Auth. Die Seiten, die er verwaltet, kommen auf derselben account_id an, und Sie rufen die API mit Ihrem eigenen Schlüssel auf (X-API-KEY). Kein Meta-Token, keine Meta-App und kein App Review auf Ihrer Seite.
| Frage | Meta Access Tokens | Mit Unipile verbundenes Konto |
|---|---|---|
| Was Sie speichern | Ein Token pro Nutzer, dazu eines pro Seite, Admin und App | Eine account_id pro Nutzer und ein API-Schlüssel |
| Was Sie überwachen | expires_at und data_access_expires_at für jedes Token | Ein Status pro Seite in metadata.products_connection_status |
| Was Sie erneuern | Tausch gegen ein langlebiges Token oder Anmeldung vor Tag 60 | Kein Meta-Token zu tauschen |
| Bei Fehler 190 | Subcode auswerten, dann den Nutzer um erneute Anmeldung bitten | Der Nutzer verbindet sich bei Bedarf über Hosted Auth neu |
account_id pro Nutzer und ein API-Schlüsselexpires_at und data_access_expires_at für jedes Tokenmetadata.products_connection_statusEin verbundenes Konto deckt Nachrichten, Postfächer von Seiten, Beiträge, Kommentare und Reaktionen ab. Eine Seite kann auf ihre Unterhaltungen antworten und Beiträge veröffentlichen, aber keine Unterhaltung beginnen. Siehe Tab 4 oben und unsere Seite zur Facebook Messenger API.
Jeder Nutzer verbindet sein eigenes Konto
Unipile ist ein unabhängiges Unternehmen, keine offizielle Meta-App und kein Meta-Partner. Unipile handelt im Auftrag jedes authentifizierten Nutzers, und jeder Nutzer bleibt an die Bedingungen von Meta gebunden.
Mit Facebook entwickeln, ohne Token-Pipeline
Jeder Nutzer verknüpft sein Facebook-Konto einmalig; Sie nutzen eine einzige API für Facebook, LinkedIn, WhatsApp und E-Mail. 7 Tage kostenlos testen.
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
Sobald das Konto verbunden ist, sehen Sie alle mit Unipile verfügbaren Facebook-Endpoints oder lesen Sie den vollständigen Leitfaden zur Facebook-API zu Berechtigungen, Limits und Fehlern.
Kurze Antworten zu Laufzeit, Erneuerung, Gültigkeitsprüfung und Speicherung von Tokens sowie zu Fehler 190.
Nicht wirklich. Ein langlebiges User Token ist etwa 60 Tage gültig. Daraus abgeleitete Page Tokens und manche System User Tokens haben kein Ablaufdatum, werden aber trotzdem ungültig, wenn der Nutzer Ihre App entfernt, sein Passwort ändert oder seine Rolle verliert. Planen Sie einen Ablauf zum erneuten Verbinden ein.
Nicht im OAuth-Sinne: Meta dokumentiert für Facebook Login keinen refresh_token-Grant. Sie tauschen ein gültiges kurzlebiges Token mit fb_exchange_token; ist ein Token abgelaufen, meldet sich der Nutzer erneut an. In nativen mobilen Apps erneuert Meta langlebige Tokens einmal pro Tag, wenn die Person Ihre App nutzt.
Weil 60 Tage eine Obergrenze sind, kein Versprechen. Ein Token wird vorzeitig ungültig, wenn der Nutzer sein Passwort ändert, Ihre App entfernt, in einen Sicherheits-Checkpoint gerät oder seine Rolle auf der Seite verliert, und Meta warnt, dass sich Gültigkeitsdauern „ohne Vorwarnung ändern oder vorzeitig ablaufen können“. Lesen Sie den error_subcode von Fehler 190, um zu erkennen, welcher Fall vorliegt.
Rufen Sie GET /debug_token?input_token={TOKEN} mit Ihrem App Access Token auf und lesen Sie is_valid, expires_at, data_access_expires_at und scopes aus. Für eine einmalige Prüfung fügen Sie das Token in den Access Token Debugger von Meta ein.
Ja, wenn Sie sie wie Passwörter behandeln: Verschlüsseln Sie sie im Ruhezustand, halten Sie sie aus Logs und Client-Code heraus und verwenden Sie App Secret und App Tokens nur in Server-zu-Server-Aufrufen. Signieren Sie Serveraufrufe mit appsecret_proof.
Fehler 190 mit Subcode 492 bedeutet eine ungültige Sitzung: Der Nutzer hinter einem Page Access Token hat keine passende Rolle mehr auf der Seite. Holen Sie ein neues Page Token von einem aktuellen Admin.
Nein. Unipile ist ein unabhängiges Unternehmen: kein Meta-Partner, keine offizielle Meta-App, und es wird von Meta weder unterstützt noch gesponsert oder genehmigt. Facebook ist eine Marke von Meta Platforms, Inc.
Nein. Sie rufen Unipile mit Ihrem API-Schlüssel und der account_id jedes verbundenen Nutzers auf. Die Nutzer verknüpfen ihr Facebook-Konto und die Seiten, die sie verwalten, über die gehostete Authentifizierung von Unipile: keine Meta-App, kein App Secret und kein App Review auf Ihrer Seite.
Sie ist im Einklang mit dem Digital Markets Act konzipiert: Jeder Nutzer verbindet sein eigenes Konto, und Unipile handelt in seinem Namen, ohne Nutzerprofile zu speichern. Mehr dazu auf unserer Seite zum Digital Markets Act.
Ja. Jedes verbundene Konto bleibt an die Nutzungsbedingungen von Meta gebunden. Nutzen Sie die API für legitime Szenarien wie Kundensupport, CRM und direkte Unterhaltungen; Spam und unerlaubte Automatisierung können zur Einschränkung von Konten führen.
Noch Fragen? Unser Team hilft Ihnen gern.
Mit einem Experten sprechen