
Integrationsleitfäden
LinkedIn-API-Leitfaden
E-Mail-API-Leitfaden
WhatsApp-API-Leitfaden
Vertrieb kontaktieren
Sie suchen eine Facebook Messenger API für private Konten? Metas Messenger Platform bedient nur Facebook-Seiten. Hier erfahren Sie, warum, und wie Ihre Nutzer ihr eigenes Konto mit Ihrer App verbinden.
api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send
200 OK
Die offizielle Facebook Messenger API unterstützt keine privaten Konten. Über Metas Messenger Platform kann eine Facebook-Seite oder ein professionelles Instagram-Konto Personen antworten, niemals ein privates Profil. Um mit einem privaten Facebook-Konto zu arbeiten, verbindet der Kontoinhaber es über eine Drittanbieter-API wie Unipile mit Ihrer App.
Open-Source-Projekte, die messenger.com über einen Browser steuern, sind inoffiziell, meist nicht mehr gepflegt und brechen bei jeder Änderung der Oberfläche. Ein verbundenes Konto läuft über eine gepflegte API mit Webhooks.
Für das Gesamtbild der APIs von Meta lesen Sie, wie die Facebook-APIs zusammenspielen.
Nachrichten aus einem privaten Facebook-Konto in drei Schritten
Verbinden. Ihr Nutzer verbindet sein eigenes Facebook-Konto über Hosted Auth. Keine Meta-App, kein App Review.
Senden. Rufen Sie die V2-API mit Ihrem Header X-API-KEY auf:POST/v2/
Empfangen. Eingehende Nachrichten erreichen Ihren Webhook als Events message.new.
Details finden Sie unten im Verbindungsablauf mit Codebeispielen oder im Facebook-Quickstart.
7 Tage kostenlos testenDie offizielle nicht. Meta hat die Messenger Platform für Unternehmen gebaut: Eine Facebook-Seite oder ein professionelles Instagram-Konto beantwortet damit die Personen, die ihm schreiben. Ein privates Facebook-Konto gelangt nur in Ihre App, wenn sein Inhaber es verbindet, über eine Drittanbieter-API, die in seinem Namen handelt.
Quelle: Metas Überblick zur Messenger Platform. Zuletzt geprüft: November 2026.
Die Messenger Platform ist um eine Seite herum konzipiert, nicht um eine Person. Jeder Aufruf handelt im Namen einer Facebook-Seite, mit einem Page Access Token und der Berechtigung pages_messaging. Ein Token, der einen privaten Posteingang repräsentiert, gibt es daher nicht.
Sie registrieren auf Meta for Developers eine App mit dem Messenger-Anwendungsfall.
Ein Seitenadmin erteilt Berechtigungen wie pages_messaging.
Ihre App ruft die Send API nur im Namen dieser Seite auf.
Die Seite empfängt Nachrichten und antwortet innerhalb des Standard-Messaging-Fensters.
Berechtigungen werden über Facebook Login for Business angefragt, und business_management ist eine Abhängigkeit von pages_messaging. Ein App Review ist nicht nötig, wenn Sie nur Nachrichten für Ihre eigene Seite senden und empfangen; für die Seiten anderer Unternehmen ist er Pflicht. Die meisten Antworten müssen innerhalb von 24 Stunden nach der letzten Nachricht der Person gesendet werden; der Message Tag HUMAN_AGENT verlängert manuelle Antworten nach einem App Review auf 7 Tage. Keiner dieser Graph-API-Schritte kann ein privates Profil ansprechen, deshalb verbinden Tools auf Basis der offiziellen API nur Seiten. Was dieses Setup kostet, erklärt unser Leitfaden zu den Preisen der Facebook Messenger API.
Quellen: Metas Überblick zur Messenger Platform und Send-API-Referenz. Zuletzt geprüft: November 2026.
Meta hat die alte Facebook Chat API (XMPP, chat.facebook.com) 2015 abgeschaltet, mit dem Ende der Graph API v1.0 und der Berechtigung xmpp_login. Für den privaten Facebook-Posteingang gibt es keine offizielle API: Die Messenger Platform, die sie für Business-Messaging ersetzt hat, handelt nur für Seiten. Die inoffiziellen Bibliotheken, die seitdem auf npm veröffentlicht wurden, melden sich mit der eigenen Sitzung des Nutzers bei messenger.com an. Meta unterstützt sie nicht, und das ursprüngliche Open-Source-Projekt gibt an, nur noch gewartet zu werden.
Um von einer Seite aus zu schreiben, die Sie verwalten, nutzen Sie die Messenger Platform und senden eine Messenger-Nachricht per API. Für das eigene Konto des Nutzers nutzen Sie eine gepflegte API: Der Nutzer verbindet sich über Hosted Auth, Ihre App kommt also nie mit seinem Passwort in Berührung, und Sie erhalten eine account_id, Webhooks und ein Support-Team (siehe wie sich ein privates Konto verbindet). Metas Nutzungsbedingungen gelten für dieses Konto weiterhin.
Der Kontoinhaber verbindet es selbst. Ihre App öffnet eine Hosted-Auth-Seite von Unipile (oder Ihren eigenen Bildschirm mit Custom Auth), der Nutzer meldet sich bei Facebook an und bestätigt die Zwei-Faktor-Authentifizierung, und Ihre App erhält eine account_id, mit der sie die API aufruft.
Der Nutzer klickt auf „Facebook verbinden“ und landet bei Hosted Auth.
Benutzername, E-Mail oder Telefonnummer mit Passwort, Browser-Cookies oder die UniLogin-Erweiterung, dann 2FA per SMS, Authenticator-App, WhatsApp, Bestätigung in der App oder Einmalcode.
Das verbundene Konto erscheint in Ihrem Dashboard, und jeder Aufruf nutzt seine account_id.
In diesem Ablauf gibt es keinen OAuth-Bildschirm von Meta und keinen QR-Code, und Sie erstellen auf Ihrer Seite weder eine Meta-App noch durchlaufen Sie ein App Review. Die Methoden je Anbieter finden Sie in der Tabelle der Anbieterfunktionen, den Produktüberblick auf der Seite zur Facebook Messenger API.
Jeder Nutzer verbindet sein eigenes Konto
Unipile ist kein Produkt von Meta, kein Meta Partner und wird von Meta nicht unterstützt. Jeder Nutzer verbindet sein eigenes Konto, Unipile handelt im Namen dieses authentifizierten Nutzers, und der Nutzer bleibt an Metas Nutzungsbedingungen gebunden.
In der Praxis stellt eine Integration der Facebook Messenger API für private Konten den eigenen Messenger-Posteingang des Nutzers über die Unipile API bereit: Chats, Nachrichten, Anhänge, Reaktionen und Lesebestätigungen sowie Webhooks in Echtzeit, unten verglichen mit dem offiziellen Seitenmodell.
| Thema | Seite über Messenger Platform | Privates Konto über Unipile |
|---|---|---|
| Konto | Eine Facebook-Seite oder ein professionelles Instagram-Konto | Das eigene private Facebook-Konto des Nutzers |
| Wer verbindet | Ein Seitenadmin, über Facebook Login for Business | Der Kontoinhaber, über Hosted Auth oder Custom Auth |
| Was Ihre App erhält | Ein Page Access Token | Ihren Unipile API-Schlüssel und die account_id des Nutzers |
| Meta-App und App Review | Eine Meta-App plus App Review für Seiten, die Ihnen nicht gehören | Keine Meta-App und kein App Review auf Ihrer Seite |
| Wer schreibt zuerst | Die Person schreibt der Seite | Der Nutzer kann antworten oder eine neue Unterhaltung beginnen |
| Echtzeit-Ereignisse | Messenger-Webhooks in Ihrer Meta-App | Neue, bearbeitete und gelöschte Nachrichten, Lese- und Zustellbestätigungen, Reaktionen, Chat-Updates |
account_id des NutzersDasselbe verbundene Konto stellt auch seine Beiträge, Kommentare und Reaktionen bereit. Diese Endpoints fasst der Facebook-API-Leitfaden zusammen.
Zwei Aufrufe decken den Grundablauf ab: die Chats des verbundenen Kontos auflisten und dann in einem davon eine Nachricht senden. Anfragen gehen an https://api.unipile.com, mit Ihrem API-Schlüssel im Header X-API-KEY.
# 1. List the chats of the connected personal account
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
--header "X-API-KEY: {YOUR_API_KEY}"
# 2. Send a message in one of those chats
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": "Thursday 10am works for me." }'
const base = "https://api.unipile.com/v2/{ACCOUNT_ID}";
const headers = { "X-API-KEY": process.env.UNIPILE_API_KEY };
// 1. List the chats of the connected personal account
const chats = await (await fetch(`${base}/chats`, { headers })).json();
// 2. Send a message in one of those chats
await fetch(`${base}/chats/{CHAT_ID}/messages/send`, {
method: "POST",
headers: { ...headers, "content-type": "application/json" },
body: JSON.stringify({ text: "Thursday 10am works for me." }),
});
import os, requests
base = "https://api.unipile.com/v2/{ACCOUNT_ID}"
headers = {"X-API-KEY": os.environ["UNIPILE_API_KEY"]}
# 1. List the chats of the connected personal account
chats = requests.get(f"{base}/chats", headers=headers).json()
# 2. Send a message in one of those chats
requests.post(
f"{base}/chats/{{CHAT_ID}}/messages/send",
headers=headers,
json={"text": "Thursday 10am works for me."},
)
Eingehende Nachrichten kommen als message.new-Ereignisse an Ihrem Webhook an, Polling ist also nicht nötig. Das Node.js SDK kapselt dieselben Aufrufe als getChatsList und sendMessage. Die vollständige Einrichtung steht im Facebook-Quickstart. Weitere Sprachen, Anhänge und Antworten von Seiten unter Nachricht senden mit der Facebook Messenger API.
Ein verbundenes privates Konto passt zu Produkten, in denen ein Profi aus seinem eigenen Konto mit seinen eigenen Kontakten spricht: CRMs, Helpdesks, KI-Assistenten, die Antworten zur Freigabe durch den Nutzer entwerfen, und Beratertools. Für Kaltakquise oder vollautomatische Bots ist es nicht gedacht.
Ein Vertriebler findet seine Messenger-Unterhaltungen im richtigen Kontaktdatensatz, neben E-Mails und Anrufen. Zur CRM-Integration.
Messenger liegt in derselben Inbox wie LinkedIn, WhatsApp, Instagram und Telegram, mit einem einzigen Datenmodell.
Ein Agent entwirft eine Antwort aus dem Gesprächsverlauf, und der Nutzer prüft sie vor dem Versand.
Ein Berater oder Makler behält die Kunden im Blick, mit denen er bereits über Messenger spricht.
Ein verbundenes Konto bleibt an Metas Nutzungsbedingungen gebunden. Bauen Sie für Unterhaltungen, die der Nutzer ohnehin führen würde: Unerwünschte Nachrichten und nicht autorisierte Automatisierung können dazu führen, dass Meta das Konto einschränkt.
Sie bauen eine gemeinsame Inbox für mehrere Netzwerke? So funktioniert eine Unified Messaging API.
Eine Integration eines privaten Kontos über die Graph API von Meta ist eng begrenzt. Sie kann die Person identifizieren und einige Profilfelder lesen, aber weder ihren Messenger-Posteingang öffnen noch in ihrem Namen veröffentlichen.
Die Identität funktioniert weiterhin. Mit Facebook Login erteilt die Person Ihrer App ein User Access Token. Die Berechtigung public_profile liest die öffentlichen Standardfelder des Profils und email die primäre E-Mail-Adresse. Andere Nutzerberechtigungen, etwa user_posts für die Beiträge, die ein Nutzer in seiner Chronik veröffentlicht hat, beschränkt Meta auf eine kurze Liste genehmigter Anwendungsfälle. Keine Nutzerberechtigung gewährt Zugriff auf die Messenger-Unterhaltungen der Person. Wie diese Tokens ausgestellt werden, erklärt unser Leitfaden zum Facebook API Access Token.
Das Veröffentlichen in einem Profil endete 2018. Meta hat die Berechtigung publish_actions am 24. April 2018 entfernt, und bereits dafür genehmigte Apps konnten sie noch bis zum 1. August 2018 nutzen. Seitdem veröffentlichen Apps auf Basis der Graph API nur noch auf Seiten, weshalb Planungstools private Profile nicht mehr anbieten.
Ein verbundenes Konto deckt beide Seiten ab. Wenn der Inhaber sein privates Konto über Unipile verbindet, liest und sendet Ihre App dessen Messenger-Nachrichten und erstellt, bearbeitet und löscht dessen Beiträge, Kommentare und Reaktionen. Die Veröffentlichungsseite beschreibt unser Leitfaden zur Facebook-Beitrags-API.
| Aktion | Graph API mit User Access Token | Privates Konto, über Unipile verbunden |
|---|---|---|
| Messenger-Nachrichten des Nutzers lesen | Nein, keine Nutzerberechtigung deckt den Posteingang ab | Ja, Chats, Nachrichten und Anhänge |
| Im Profil des Nutzers veröffentlichen | Nein, publish_actions wurde 2018 entfernt | Ja, Beiträge erstellen, bearbeiten und löschen |
| Auf Nachrichten antworten | Nein, die Messenger Platform bedient Seiten | Ja, antworten oder eine Unterhaltung beginnen |
publish_actions wurde 2018 entferntQuellen: Metas Referenz zu Berechtigungen und Graph API Changelog vom 24. April 2018. Zuletzt geprüft: 17. November 2026.
Verbinden Sie private Facebook-Konten mit Ihrem Produkt
Metas Messenger Platform bleibt das richtige Werkzeug für ein Unternehmen, das Personen auf seiner eigenen Seite antwortet. Braucht Ihr Produkt eine Facebook Messenger API, die auch private Konten abdeckt, lassen Sie Ihre Nutzer ihr eigenes Facebook-Konto verbinden und nutzen Sie eine einzige API für Facebook und Ihre anderen Kanäle.
Jeder Nutzer verbindet sein eigenes Konto, ohne Speicherung von Profilen. Unipile ist kein Meta-Partner. Zu unserer Seite zum Digital Markets Act
Alle Endpoints der Facebook-API an einem Ort
Nachrichten sind nur ein Teil des Ganzen. Durchsuchen Sie alle mit Unipile verfügbaren Facebook-Endpoints, von Chats bis zu Beiträgen, oder lesen Sie den vollständigen Leitfaden zur Facebook-API, um die offiziellen APIs von Meta mit verbundenen Konten zu vergleichen.
Kurze Antworten zu Profilen, Nachrichtenverlauf, ersten Nachrichten, Reaktionen, Seiten, Chatbots, zur Graph API und zu inoffiziellen Bibliotheken.
Metas Messenger Platform nicht: Sie bedient Facebook-Seiten und professionelle Instagram-Konten. Ein privates Profil lässt sich nutzen, wenn sein Inhaber es über die Hosted Authentication von Unipile mit Ihrer App verbindet, und der Inhaber bleibt an Metas Nutzungsbedingungen gebunden.
Ja, sobald das Konto verbunden ist. Die API listet die Chats und Nachrichten des verbundenen privaten Kontos auf, einschließlich Gruppenunterhaltungen und Anhängen, und Webhooks übermitteln neue, bearbeitete und gelöschte Nachrichten an Ihre App.
Ja. Ein verbundenes privates Konto kann neue Unterhaltungen beginnen und antworten. Beschränken Sie das auf Personen, die der Nutzer kennt oder mit denen er arbeitet: Unerwünschte Nachrichten verstoßen gegen Metas Nutzungsbedingungen und können zur Einschränkung des Kontos führen.
Ja. Sie können Reaktionen auf Nachrichten auflisten, hinzufügen und entfernen, und neue Reaktionen erreichen Ihre App über das Webhook-Ereignis message.reaction.new.
Ja, für Seiten, die der verbundene Nutzer verwaltet. Ihre App kann die Nachrichten der Seite lesen und beantworten und als Seite veröffentlichen. Eine Seite kann keine Unterhaltung beginnen und ihre Nachrichten nicht löschen, daher beginnen Unterhaltungen mit einer Seite immer damit, dass die Person zuerst schreibt.
Metas Messenger Platform und die darauf basierenden Chatbot-Baukästen funktionieren nur mit Seiten. Bei einem verbundenen privaten Konto sollte immer ein Mensch beteiligt sein: Eine KI entwirft eine Antwort, und der Nutzer gibt sie frei. Vollautomatisierte oder unerwünschte Nachrichten können zur Einschränkung des Kontos führen.
Teilweise. Die Graph API von Meta akzeptiert ein privates Profil weiterhin für Facebook Login und einige Leseberechtigungen, kann aber den Messenger-Posteingang der Person nicht öffnen und veröffentlicht seit der Entfernung von publish_actions im Jahr 2018 nicht mehr in Profilen. Für eine Anbindung eines privaten Facebook-Kontos, die Nachrichten und Beiträge abdeckt, verbindet der Inhaber das Konto über Unipile, und Ihre App arbeitet mit einer einzigen REST-API.
Ja. Es gibt Open-Source-Bibliotheken, die sich mit der eigenen Sitzung des Nutzers bei messenger.com anmelden, aber sie sind inoffiziell und werden von Meta nicht unterstützt. Sie können ausfallen, sobald Facebook seine Oberfläche ändert, und das Konto, das sie nutzt, kann nach Metas Nutzungsbedingungen eingeschränkt werden. Für eine Produktions-App nutzen Sie die Messenger Platform für Seiten, die Sie verwalten, oder eine gepflegte API, bei der der Nutzer sein eigenes Konto verbindet und an Metas Nutzungsbedingungen gebunden bleibt.
Nicht über ihre Facebook-Messenger-Integrationen: Diese basieren auf der Messenger Platform von Meta, die nur Seiten bedient. Mit einem über Unipile verbundenen privaten Konto wird die Nachricht aus Ihrem eigenen Workflow gesendet, zum Beispiel über einen HTTP-Schritt, der den Endpoint zum Senden von Nachrichten für dieses Konto aufruft.
Nein. Unipile ist ein unabhängiges Unternehmen: Es ist kein Meta Partner und wird von Meta weder unterstützt noch gesponsert oder genehmigt. Die Verbindung eines privaten Messenger-Kontos über Unipile ist keine offizielle Integration der Messenger Platform. Facebook und Messenger sind Marken von Meta Platforms, Inc.
Nein. Der Kontoinhaber meldet sich über die gehostete Authentifizierung von Unipile an, sodass Sie auf Ihrer Seite keine Meta-App registrieren, kein pages_messaging anfragen und kein App Review durchlaufen. Dasselbe gilt für die Seiten, die dieser Nutzer verwaltet.
Unipile ist im Sinne des Digital Markets Act konzipiert. Jede Person verbindet ihr eigenes Facebook-Konto, Nachrichten werden in ihrem Namen gelesen und gesendet, und Unipile speichert keine Nutzerprofile. Details auf unserer Seite zum Digital Markets Act.
Ja. Ein verbundenes privates Konto bleibt ein Facebook-Konto, das den Bedingungen von Meta unterliegt. Beschränken Sie sich auf legitime Nutzungen wie das Beantworten von Kundenanfragen, das Synchronisieren von Unterhaltungen in ein CRM oder die Unterstützung eines Nutzers bei der Verwaltung seines eigenen Posteingangs; massenhafte oder unerwünschte Nachrichten können zur Einschränkung des Kontos führen.
Noch Fragen? Unser Team hilft Ihnen gern.
Mit einem Experten sprechen