DE
Leitfaden zur CRM-Integration

Facebook-Messenger-CRM-Integration: So bauen Sie sie in Ihr Produkt ein

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.

Ihr CRM · Messenger Synchronisiert
Leo MartinLiefern Sie die Leinenjacke nach Lyon?Zugeordnet · LeadCoveton Apparel
Sara KimDanke Anna, ich unterschreibe morgen.Zugeordnet · DealPrivat
Omar HaddadSie: Ihre Bestellung hat das Lager verlassen.Zugeordnet · KundeCoveton Apparel
Webhooks message.new message.receipt.read
GET api.unipile.com/v2/{ACCOUNT_ID}/chats 200 OK
Kurz gesagt

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

Mit Unipile in drei Schritten umsetzen

  1. 1

    Verbinden Sie das Facebook-Konto und die Seiten jedes Nutzers über Hosted Auth. Keine Meta-App, kein App Review.

  2. 2

    Importieren Sie die bestehenden Chats mit GET /v2/{account_id}/chats und senden Sie dabei Ihren Header X-API-KEY.

  3. 3

    Empfangen Sie neue Nachrichten, Änderungen und Reaktionen per Webhook, beginnend mit message.new.

Definition

Was ist eine Facebook-Messenger-CRM-Integration?

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.

Ihr CRM · Kontakt Live
Leo MartinLead · Lyon
VerantwortlichAnna Rossi
KanalMessenger · Seite Coveton Apparel
Facebook-ID{FACEBOOK_USER_ID}
AktivitätE-MailMessenger 2Deals
FacebookPosteingang der SeiteCoveton Apparel
Hallo, liefern Sie die Leinenjacke nach Lyon?10:40
Ja, die Lieferung dauert 3 Tage. Welche Größe brauchen Sie?Coveton Apparel · 10:41
01

Lesen

Verlauf und neue Nachrichten, pro Nutzer.

02

Zuordnen

Jede Unterhaltung genau einem Kontakt.

03

Antworten

Aus dem Datensatz, als Nutzer oder als Seite.

04

Live bleiben

Webhooks statt Polling.

Ansätze

Facebook Messenger mit einem CRM verbinden: drei Wege

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.

FrageNo-Code-ConnectorMeta Messenger PlatformVerbindung pro Nutzer (Unipile)
KontenMeist eine Facebook-SeiteNur Facebook-Seiten (Unternehmensseiten)Private Konten und die Seiten, die sie verwalten
RichtungMeist eine Richtung: Nachricht wird zum LeadBeide Richtungen, innerhalb des 24-Stunden-FenstersBidirektionale Synchronisierung: lesen, antworten, reagieren
EchtzeitOft Polling, bei manchen Tarifen alle 15 MinutenMeta-WebhooksWebhooks wie message.new
Ihr BetriebsaufwandEin Workflow pro EinrichtungMeta-App, App Review, ein Token pro SeiteEin Hosted-Auth-Link, eine account_id pro Nutzer
VerlaufJe nach ConnectorUnterhaltungen der SeitePrivate Chats und der Posteingang jeder Seite
Weitere KanäleJe ein ConnectorEine Integration pro Meta-ProduktDieselbe API für LinkedIn, WhatsApp, Instagram, E-Mail
Konten
No-CodeMeist eine Facebook-Seite
MetaNur Facebook-Seiten
UnipilePrivate Konten und die Seiten, die sie verwalten
Richtung
No-CodeMeist eine Richtung: Nachricht wird zum Lead
MetaBeide Richtungen, innerhalb des 24-Stunden-Fensters
UnipileBidirektionale Synchronisierung: lesen, antworten, reagieren
Echtzeit
No-CodeOft Polling, bei manchen Tarifen alle 15 Minuten
MetaMeta-Webhooks
UnipileWebhooks wie message.new
Ihr Betriebsaufwand
No-CodeEin Workflow pro Einrichtung
MetaMeta-App, App Review, ein Token pro Seite
UnipileEin Hosted-Auth-Link, eine account_id pro Nutzer
Verlauf
No-CodeJe nach Connector
MetaUnterhaltungen der Seite
UnipilePrivate Chats und der Posteingang jeder Seite
Weitere Kanäle
No-CodeJe ein Connector
MetaEine Integration pro Meta-Produkt
UnipileDieselbe API für LinkedIn, WhatsApp, Instagram, E-Mail

Zapier 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.

Verbindung

Das Facebook-Konto und die Seiten jedes Nutzers verbinden

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.

1

Hosted-Auth-Link öffnen

Ihr Backend fordert ihn an, der Nutzer öffnet ihn.

Hosted Auth
2

Anmelden und Verlauf entsperren

Zugangsdaten, 2FA, dann optional den Verlauf entsperren.

ENCRYPTED_HISTORY
3

Die account_id speichern

Beim 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.

Synchronisierung

Gesprächsverlauf und neue Nachrichten in Echtzeit synchronisieren

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.

FacebookQuellePrivates Konto + SeitenEines pro CRM-Nutzer
VerbindungUnipileEine account_id
DateneingangNachladen, dann WebhooksGET /chats einmal, danach message.new
Ihr CodeSync-DienstRoutet, ordnet zu, dedupliziert
Ihre DatenCRM-DatenbankKontakte und Nachrichten

Private Chats und Posteingänge der Seiten nachladen

Die 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.

Basis-URL https://api.unipile.com · Header X-API-KEY
GET/v2/{account_id}/chatsPrivate Chats des verbundenen Kontos
GET/v2/{account_id}/inboxes/{inbox_id}/chatsChats eines Seiten-Posteingangs
GET/v2/{account_id}/chats/{chat_id}/messagesNachrichten eines Chats, neueste zuerst

Verschlüsselte Chats und Verlauf

Private 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.

Webhooks

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:

message.new message.update message.delete message.receipt.read message.receipt.delivery message.reaction.new chat.update chat.delete

Quellen: Unipile Chats und Nachrichten abrufen, verschlüsselte Chats, Provider-Funktionen und Webhook konfigurieren. Zuletzt geprüft: 17. November 2026.

Ausprobieren

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.

Jetzt bauen
Datenmodell

Messenger-Unterhaltungen CRM-Kontakten zuordnen

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.

KennungSpeichern beiAchtung
Facebook-ID der GegenseiteDem Kontakt: Ihr ZuordnungsschlüsselNie über den Anzeigenamen zuordnen
account_idDem CRM-Nutzer, der Facebook verbunden hatDeckt privates Konto und Seiten ab
Private Chat-IDDer UnterhaltungKein Kontaktschlüssel
Chat-ID der Seite PAGE_<page_id>_<thread_key>Der Unterhaltung und ihrer SeiteDurch das Präfix handelt Unipile als Seite
Seiten-ID und Profil-ID der SeiteDie Seiten-ID, bei Posteingang und StatusAutoren als Seite tragen die Profil-ID: beide nie vergleichen
Facebook-ID der Gegenseite
Speichern beiDem Kontakt: Ihr Zuordnungsschlüssel
AchtungNie über den Anzeigenamen zuordnen
account_id
Speichern beiDem CRM-Nutzer, der Facebook verbunden hat
AchtungDeckt privates Konto und Seiten ab
Private Chat-ID
Speichern beiDer Unterhaltung
Chat-ID der Seite
Speichern beiDer Unterhaltung und ihrer Seite (PAGE_<page_id>_<thread_key>)
AchtungDurch das Präfix handelt Unipile als Seite
Seiten-ID und Profil-ID der Seite
Speichern beiDie Seiten-ID, bei Posteingang und Status
AchtungAutoren als Seite tragen die Profil-ID: beide nie vergleichen

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.

Ein message.new-Handler, der in den Kontaktdatensatz schreibt

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
200 OK · ein Kontakt pro Facebook-ID, eine Zeile pro Nachrichten-ID
200 OK · ein Kontakt pro Facebook-ID, eine Zeile pro Nachrichten-ID

Formate der Chat-IDs aus der Dokumentation zu Facebook Pages, Chat-Abfragen aus Chats und Nachrichten abrufen.

Antworten

Aus dem Kontaktdatensatz antworten, als Nutzer oder als Seite

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.

Ihr CRM · Leo Martin Unterhaltung der Seite
Größe M, bitte. Kann sie bis Freitag ankommen?10:42
Ja, wenn Sie heute vor 14 Uhr bestellen.Coveton Apparel · 10:44
Perfekt, ich bestelle jetzt.10:46
Antworten alsAnna RossiFacebookSeite Coveton Apparel
Danke Leo, Ihre Bestellung ist bestätigt. Der Tracking-Link folgt.
Neue UnterhaltungSenden

Eine Seite antwortet nur Personen, die ihr geschrieben haben.

POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send 200 OK
Aus einem Chat der Seite
  • Antworten gehen als Seite hinaus
  • Keine neue Unterhaltung: 501 api/not_implemented
  • Kein Löschen ihrer Nachrichten: derselbe Fehler
Aus einem privaten Chat
  • Antworten gehen vom Konto des Nutzers hinaus
  • Kann eine Unterhaltung beginnen, wenn Facebook es zulässt

Deaktivieren Sie „Neue Unterhaltung“ für eine Seite. Request-Body, Anhänge und Fehler: Lesen Sie, wie Sie eine Messenger-Nachricht per API senden.

Betrieb

Betrieb für jeden Kunden: Status, Berechtigungen und Metas Regeln

Zeigen Sie den Zustand jeder Verbindung an. Jede Seite meldet ihren eigenen Status, sodass eine fehlerhafte Seite weder private Nachrichten noch andere Seiten blockiert.

Admin · Verbundene Konten Teilweise
VerbindungStatus
FacebookAnna RossiNachrichten · privates Kontorunning
Seite Coveton Apparelpage_<page_id>running
Seite Coveton OutletAdmin-Rolle entzogendisconnectedNeu verbinden
STATUS 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.

Festlegen, wer welche Unterhaltungen sieht

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.

Compliance

Jeder Nutzer verbindet sein eigenes Konto

Für CRM, Support, Berater oder einen KI-Agenten, dessen Entwürfe ein Mensch freigibt. Kein Massenversand.

Meta-App oder App Review?Nicht nötig: Nutzer verbinden sich über Hosted Auth.
Offizieller Meta-Partner?Nein. Unipile ist weder eine offizielle Meta-App noch ein Meta-Partner.
Metas Nutzungsbedingungen?Jeder Nutzer bleibt daran gebunden.
Digital Markets Act?Keine Speicherung von Profilen. Siehe unsere Seite zum Digital Markets Act.

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.

Europäische Kommission
EU-reguliert Digital Markets Act (DMA)

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.

FAQ zur Facebook-Messenger-CRM-Integration

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