
Integrationsleitfäden
LinkedIn-API-Leitfaden
E-Mail-API-Leitfaden
WhatsApp-API-Leitfaden
Vertrieb kontaktieren
Für Teams, die ein CRM oder SaaS-Produkt entwickeln: das Facebook-Konto und die Seiten jedes Nutzers verbinden, Unterhaltungen synchronisieren, Kontakte zuordnen und direkt aus dem Datensatz antworten.
api.unipile.com/v2/{ACCOUNT_ID}/chats
200 OK
Eine Facebook-Messenger-CRM-Integration synchronisiert die Messenger-Unterhaltungen jedes Nutzers in die Kontaktdatensätze des CRM und lässt ihn direkt aus dem CRM antworten. Dieser Leitfaden richtet sich an Teams, die diese Integration in ihr eigenes CRM oder SaaS-Produkt einbauen, nicht an Unternehmen, die ein CRM auswählen.
Dafür braucht es vier Bausteine: eine Verbindung pro Nutzer, Verlauf plus Echtzeit-Synchronisierung, Kontaktzuordnung und Antworten mit der richtigen Identität.
Mit Unipile in drei Schritten umsetzen
Verbinden Sie das Facebook-Konto und die Seiten jedes Nutzers über Hosted Auth. Keine Meta-App, kein App Review.
Importieren Sie die bestehenden Chats mit GET /v2/{account_id}/chats und senden Sie dabei Ihren Header X-API-KEY.
Empfangen Sie neue Nachrichten, Änderungen und Reaktionen per Webhook, beginnend mit message.new.
Eine Facebook-Messenger-CRM-Integration verknüpft Messenger-Unterhaltungen mit einem CRM: Jede Nachricht landet im richtigen Kontaktdatensatz, und Nutzer antworten, ohne das CRM zu verlassen. Für ein Unternehmen ist das ein Connector, den es einschaltet. Für ein Produktteam ist es eine Funktion, die es in sein eigenes CRM oder SaaS-Produkt einbaut: Um diesen Fall geht es in diesem Leitfaden.
In beiden Fällen gilt: lesen, einem Kontakt zuordnen, aus dem CRM antworten, in Echtzeit und pro Nutzer. Unser Überblick, wie die Facebook-APIs zusammenspielen, behandelt die Plattformen von Meta.
{FACEBOOK_USER_ID}Verlauf und neue Nachrichten, pro Nutzer.
Jede Unterhaltung genau einem Kontakt.
Aus dem Datensatz, als Nutzer oder als Seite.
Webhooks statt Polling.
Ein No-Code-Connector ist schnell eingerichtet, arbeitet aber meist nur in eine Richtung. Metas Messenger Platform funktioniert in beide Richtungen, aber nur für Seiten und erst nach dem App Review. Eine API mit Verbindung pro Nutzer deckt private Konten und Seiten ab, ganz ohne Meta-App.
| Frage | No-Code-Connector | Meta Messenger Platform | Verbindung pro Nutzer (Unipile) |
|---|---|---|---|
| Konten | Meist eine Facebook-Seite | Nur Facebook-Seiten (Unternehmensseiten) | Private Konten und die Seiten, die sie verwalten |
| Richtung | Meist eine Richtung: Nachricht wird zum Lead | Beide Richtungen, innerhalb des 24-Stunden-Fensters | Bidirektionale Synchronisierung: lesen, antworten, reagieren |
| Echtzeit | Oft Polling, bei manchen Tarifen alle 15 Minuten | Meta-Webhooks | Webhooks wie message.new |
| Ihr Betriebsaufwand | Ein Workflow pro Einrichtung | Meta-App, App Review, ein Token pro Seite | Ein Hosted-Auth-Link, eine account_id pro Nutzer |
| Verlauf | Je nach Connector | Unterhaltungen der Seite | Private Chats und der Posteingang jeder Seite |
| Weitere Kanäle | Je ein Connector | Eine Integration pro Meta-Produkt | Dieselbe API für LinkedIn, WhatsApp, Instagram, E-Mail |
message.newaccount_id pro NutzerZapier oder Make passen zu einem Unternehmen mit einer Seite, und die Meta Business Suite gibt diesem Unternehmen einen Posteingang für seine eigene Seite. Ein Produkt mit vielen Kunden braucht die Integration im eigenen Code.
Auf Metas Weg braucht jede Kundenseite ein Page access token und von Meta geprüfte Berechtigungen, wie unser Leitfaden zur Facebook Page API zeigt. Antworten unterliegen dem 24-Stunden-Fenster und den Message Tags, von denen Meta 2026 mehrere abgeschafft hat. Und die privaten Konten, die Vertriebsmitarbeiter und Berater mit ihren Kunden nutzen, erreicht dieser Weg nie.
Quellen: Metas Messenger Platform send messages, Unipiles Provider-Funktionen. Zuletzt geprüft: 17. November 2026.
Jeder CRM-Nutzer öffnet einen Hosted-Auth-Link und meldet sich bei Facebook an, Zwei-Faktor-Authentifizierung inklusive. Ihr CRM erhält eine account_id, die sein privates Konto und jede von ihm verwaltete Seite abdeckt, alle standardmäßig aktiviert.
Ihr Backend fordert ihn an, der Nutzer öffnet ihn.
Hosted AuthZugangsdaten, 2FA, dann optional den Verlauf entsperren.
ENCRYPTED_HISTORYBeim CRM-Nutzer speichern. Seine Seiten sind darin enthalten.
{ACCOUNT_ID}Seiten werden über das Produkt page beim Verbinden oder bei einer erneuten Verbindung aktiviert; eine nicht aktivierte Seite liefert 403 api/insufficient_permissions. Die Anmeldung beschreibt unser Leitfaden zur Facebook Messenger API für private Konten im Detail.
Quelle: Unipile Dokumentation zu Facebook Pages. Zuletzt geprüft: 17. November 2026.
Laden Sie zuerst den Verlauf über die API nach: private Chats, dann den Posteingang jeder Seite. Wechseln Sie danach zu Webhooks, damit jede neue Nachricht, Bearbeitung, Lesebestätigung oder Reaktion Ihr CRM in Echtzeit erreicht, wie auf unserer Seite zur Facebook Messenger API aufgeführt.
account_idGET /chats einmal, danach message.newDie Chatliste des Kontos enthält nur private Unterhaltungen; jede Seite hat ihren eigenen Posteingang, PAGE_<page_id>_INBOX. Listen liefern bis zu 100 Einträge pro Seite, die neuesten Nachrichten zuerst: Blättern Sie so weit zurück, wie Ihr CRM es braucht.
https://api.unipile.com · Header X-API-KEYPrivate 1:1- und Gruppenchats sind Ende-zu-Ende-verschlüsselt, Unterhaltungen von Seiten nicht. Ältere private Nachrichten liegen in einem verschlüsselten Backup, das der Nutzer mit seinem Wiederherstellungscode oder seiner Messenger-PIN entsperrt, in einem Schritt, den Hosted Auth beim Verbinden anzeigt. Ohne diesen Schritt sind nur Nachrichten ab der Verbindung verfügbar.
Eine Webhook-URL bedient alle verbundenen Konten. Ereignisse von Seiten tragen die seitenbezogene Chat-ID, routen Sie sie also über das Präfix PAGE_<page_id>_. Für Facebook verfügbare Ereignisse:
Quellen: Unipile Chats und Nachrichten abrufen, verschlüsselte Chats, Provider-Funktionen und Webhook konfigurieren. Zuletzt geprüft: 17. November 2026.
Verbinden Sie ein Facebook-Konto in Ihrem Test-Workspace
Konto verknüpfen, seine Chats auflisten und einen Webhook auf Ihren Dienst richten. 7 Tage kostenlos testen, ohne Kreditkarte.
Ordnen Sie jede Unterhaltung über die Facebook-ID der Gegenseite einem Kontakt zu, nie über den Anzeigenamen. Unterhaltungen von Seiten und private Unterhaltungen routen Sie über das Präfix PAGE_<page_id>_ der Chat-ID.
| Kennung | Speichern bei | Achtung |
|---|---|---|
| Facebook-ID der Gegenseite | Dem Kontakt: Ihr Zuordnungsschlüssel | Nie über den Anzeigenamen zuordnen |
account_id | Dem CRM-Nutzer, der Facebook verbunden hat | Deckt privates Konto und Seiten ab |
| Private Chat-ID | Der Unterhaltung | Kein Kontaktschlüssel |
Chat-ID der Seite PAGE_<page_id>_<thread_key> | Der Unterhaltung und ihrer Seite | Durch das Präfix handelt Unipile als Seite |
| Seiten-ID und Profil-ID der Seite | Die Seiten-ID, bei Posteingang und Status | Autoren als Seite tragen die Profil-ID: beide nie vergleichen |
PAGE_<page_id>_<thread_key>)Eine Falle: Für dieselbe Unterhaltung kann sich die von der API gelieferte Chat-ID von der in einem Webhook-Ereignis unterscheiden. Speichern Sie beide bei der Unterhaltung und gleichen Sie sie im CRM ab, verankert an der Facebook-ID des Kontakts. „Find Chats by User“ liefert die bestehenden Chats eines Kontakts oder eine leere Liste.
readUnipileEvent steht für Ihr Mapping der Payload.
// One URL for every connected account
app.post("/webhooks/unipile", express.json(), async (req, res) => {
res.sendStatus(200); // acknowledge first, process after
// Your mapping of the payload documented in the webhook reference
const evt = readUnipileEvent(req.body);
if (evt.type !== "message.new") return;
// 1. Route: a PAGE_<page_id>_ prefix means a Page conversation
const page = evt.chatId.match(/^PAGE_([^_]+)_/);
const inbox = page ? { kind: "page", pageId: page[1] } : { kind: "personal" };
// 2. Owner: the CRM user who connected this account_id
const owner = await crm.users.findByAccountId(evt.accountId);
// 3. Contact: the other person's Facebook ID, never the name
const contact =
(await crm.contacts.findByFacebookId(owner.tenantId, evt.counterpartId)) ??
(await crm.contacts.createForReview({ facebookId: evt.counterpartId, owner }));
// 4. Keep the webhook chat ID next to the one from the backfill
await crm.conversations.addChatId(contact.id, inbox, evt.chatId, "webhook");
// 5. Write the message once, keyed by its message ID
await crm.messages.upsert({
contactId: contact.id, inbox, messageId: evt.messageId,
direction: evt.fromOwner ? "out" : "in", text: evt.text,
});
});
import re
from flask import request
PAGE_PREFIX = re.compile(r"^PAGE_([^_]+)_")
# One URL for every connected account
@app.post("/webhooks/unipile")
def unipile_webhook():
# Your mapping of the payload documented in the webhook reference
evt = read_unipile_event(request.get_json())
if evt.type != "message.new":
return "", 200
# 1. Route: a PAGE_<page_id>_ prefix means a Page conversation
page = PAGE_PREFIX.match(evt.chat_id)
inbox = {"kind": "page", "page_id": page.group(1)} if page else {"kind": "personal"}
# 2. Owner: the CRM user who connected this account_id
owner = crm.users.find_by_account_id(evt.account_id)
# 3. Contact: the other person's Facebook ID, never the name
contact = crm.contacts.find_by_facebook_id(owner.tenant_id, evt.counterpart_id) \
or crm.contacts.create_for_review(facebook_id=evt.counterpart_id, owner=owner)
# 4. Keep the webhook chat ID next to the one from the backfill
crm.conversations.add_chat_id(contact.id, inbox, evt.chat_id, source="webhook")
# 5. Write the message once, keyed by its message ID
crm.messages.upsert(
contact_id=contact.id, inbox=inbox, message_id=evt.message_id,
direction="out" if evt.from_owner else "in", text=evt.text,
)
return "", 200
Formate der Chat-IDs aus der Dokumentation zu Facebook Pages, Chat-Abfragen aus Chats und Nachrichten abrufen.
Senden Sie die Antwort an die Chat-ID der Unterhaltung. Eine Chat-ID einer Seite antwortet als Seite, eine private Chat-ID sendet vom eigenen Konto des Nutzers. Das Eingabefeld zeigt, welche Identität gilt.
Eine Seite antwortet nur Personen, die ihr geschrieben haben.
/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send
200 OK
501 api/not_implementedDeaktivieren Sie „Neue Unterhaltung“ für eine Seite. Request-Body, Anhänge und Fehler: Lesen Sie, wie Sie eine Messenger-Nachricht per API senden.
Zeigen Sie den Zustand jeder Verbindung an. Jede Seite meldet ihren eigenen Status, sodass eine fehlerhafte Seite weder private Nachrichten noch andere Seiten blockiert.
metadata.products_connection_status
pro Seite
Jede Seite hat einen eigenen Schlüssel in metadata.products_connection_status namens page_<page_id>. Fällt eine Seite aus, wechselt das Konto auf partial oder degraded. Eine Seite, deren Admin-Rolle verloren ging, bleibt bis zur erneuten Verbindung disconnected: Zeigen Sie das an und bieten Sie das erneute Verbinden an.
Zeigen Sie private Unterhaltungen ihrem Eigentümer und ausgewählten Managern, Unterhaltungen von Seiten dem Team der Seite, in einer Unified Inbox mit Zuweisung und Tags. Das ist dasselbe Modell wie eine Messaging-API für CRM-Software für LinkedIn, WhatsApp und E-Mail, und der Grund, warum Sie mit einer Unified Messaging API Messenger ohne neuen Connector hinzufügen.
Jeder Nutzer verbindet sein eigenes Konto
Für CRM, Support, Berater oder einen KI-Agenten, dessen Entwürfe ein Mensch freigibt. Kein Massenversand.
Bauen Sie Ihre Messenger-Integration
Eine Facebook-Messenger-CRM-Integration besteht aus einer Verbindung pro Nutzer, einem Nachladen des Verlaufs und dann Webhooks, Kontakten, die über Facebook-IDs zugeordnet werden, und Antworten mit der richtigen Identität. Derselbe Code bedient LinkedIn, WhatsApp und E-Mail. 7 Tage kostenlos testen, ohne Kreditkarte.
Jeder Nutzer verbindet sein eigenes Konto, ohne Speicherung von Profilen. Unipile ist kein Meta-Partner. Unipile und der DMA
Alle Endpoints der Facebook-API an einem Ort
Messenger ist nur ein Teil des Ganzen. Sehen Sie alle mit Unipile verfügbaren Facebook-Endpoints, von Beiträgen und Kommentaren bis zu Profilen, oder starten Sie mit unserem vollständigen Leitfaden zur Facebook-API.
CRM-Messaging, automatisierte Antworten und mehrere Seiten.
Damit Unterhaltungen nicht mehr auf dem Handy einer einzelnen Person liegen. Jede Nachricht landet im Kontaktdatensatz, das Team sieht den vollständigen Verlauf, und Follow-ups, Zuweisung und Reporting funktionieren für Messenger wie für E-Mail.
Nachrichten über Messenger, WhatsApp, LinkedIn oder E-Mail direkt im CRM senden und empfangen, wobei jede Unterhaltung einem Kontakt zugeordnet ist. Eine Facebook-Messenger-CRM-Integration deckt einen Kanal ab; eine Unified Messaging API bringt die anderen über dasselbe Datenmodell hinzu.
Behalten Sie einen Menschen in der Schleife: Ein KI-Agent entwirft eine Antwort aus dem Verlauf des Kontakts, und ein Nutzer gibt sie vor dem Senden frei. Nutzer bleiben an Metas Nutzungsbedingungen gebunden: keine unerwünschten Nachrichten und kein Massenversand.
Ja. Jede Seite, die der Nutzer verwaltet, ist standardmäßig auf derselben account_id aktiviert, jede mit eigenem Posteingang (PAGE_<page_id>_INBOX) und eigenem Status. Zeigen Sie jede Seite in Ihrem CRM als eigenen Posteingang an.
Noch Fragen? Unser Team hilft Ihnen gern.
Mit einem Experten sprechen