NL
Gids CRM-integratie

Facebook Messenger CRM-integratie: zo bouwt u die in uw product

Voor teams die een CRM of SaaS bouwen: koppel het Facebook-account en de pagina's van elke gebruiker, synchroniseer gesprekken, koppel contacten en antwoord vanuit het record.

Uw CRM · Messenger Gesynct
Leo MartinVerzenden jullie het linnen jasje naar Lyon?Gekoppeld · LeadCoveton Apparel
Sara KimBedankt Anna, ik teken morgen.Gekoppeld · DealPersoonlijk
Omar HaddadU: Uw bestelling heeft het magazijn verlaten.Gekoppeld · KlantCoveton Apparel
Webhooks message.new message.receipt.read
GET api.unipile.com/v2/{ACCOUNT_ID}/chats 200 OK
Kort antwoord

Een Facebook Messenger CRM-integratie synchroniseert de Messenger-gesprekken van elke gebruiker naar contactrecords in het CRM en laat hem vanuit het CRM antwoorden. Deze gids is bedoeld voor teams die die integratie in hun eigen CRM of SaaS-product bouwen, niet voor bedrijven die een CRM kiezen.

Er zijn vier bouwstenen nodig: één koppeling per gebruiker, historie plus realtime sync, het koppelen van contacten en antwoorden met de juiste identiteit.

Met Unipile

Bouw het met Unipile in drie stappen

  1. 1

    Koppel het Facebook-account en de pagina's van elke gebruiker via Hosted Auth. Geen Meta-app, geen App Review.

  2. 2

    Importeer hun bestaande chats met GET /v2/{account_id}/chats, met uw header X-API-KEY.

  3. 3

    Ontvang nieuwe berichten, bewerkingen en reacties via webhook, te beginnen met message.new.

Definitie

Wat is een Facebook Messenger CRM-integratie?

Een Facebook Messenger CRM-integratie verbindt Messenger-gesprekken met een CRM, zodat elk bericht op het juiste contactrecord belandt en gebruikers antwoorden zonder het CRM te verlaten. Voor een bedrijf is het een connector die het aanzet. Voor een productteam is het een functie die het in zijn eigen CRM of SaaS bouwt: over dat geval gaat deze gids.

In beide gevallen: lezen, aan een contact koppelen en vanuit het CRM antwoorden, realtime en per gebruiker. Ons overzicht van hoe de Facebook API's samenhangen behandelt de platforms van Meta.

Uw CRM · Contact Live
Leo MartinLead · Lyon
EigenaarAnna Rossi
KanaalMessenger · pagina Coveton Apparel
Facebook-ID{FACEBOOK_USER_ID}
ActiviteitE-mailMessenger 2Deals
FacebookPagina-inboxCoveton Apparel
Hallo, verzenden jullie het linnen jasje naar Lyon?10:40
Ja, de levering duurt 3 dagen. Welke maat heeft u nodig?Coveton Apparel · 10:41
01

Lezen

Historie en nieuwe berichten, per gebruiker.

02

Koppelen

Elk gesprek aan één contact.

03

Antwoorden

Vanuit het record, als de gebruiker of als de pagina.

04

Live blijven

Webhooks, geen polling.

Aanpakken

Facebook Messenger koppelen aan een CRM: drie manieren

Een no-code connector is snel, maar werkt grotendeels in één richting. Het Messenger Platform van Meta werkt in twee richtingen, maar alleen voor pagina's en na App Review. Een API met een koppeling per gebruiker dekt persoonlijke accounts en pagina's, zonder Meta-app.

VraagNo-code connectorMeta Messenger PlatformKoppeling per gebruiker (Unipile)
AccountsMeestal één Facebook-paginaAlleen Facebook-pagina's (bedrijfspagina's)Persoonlijke accounts en de pagina's die ze beheren
RichtingGrotendeels één richting: bericht naar leadTwee richtingen, binnen het 24-uursvensterSync in twee richtingen: lezen, antwoorden, reageren
RealtimeVaak polling, bij sommige abonnementen elke 15 minutenWebhooks van MetaWebhooks zoals message.new
Wat u beheertEén workflow per installatieMeta-app, App Review, een token per paginaEen Hosted Auth-link, één account_id per gebruiker
HistorieVerschilt per connectorGesprekken van de paginaPersoonlijke chats en de inbox van elke pagina
Andere kanalenEen connector per kanaalEen integratie per Meta-productDezelfde API voor LinkedIn, WhatsApp, Instagram, e-mail
Accounts
No-codeMeestal één Facebook-pagina
MetaAlleen Facebook-pagina's
UnipilePersoonlijke accounts en de pagina's die ze beheren
Richting
No-codeGrotendeels één richting: bericht naar lead
MetaTwee richtingen, binnen het 24-uursvenster
UnipileSync in twee richtingen: lezen, antwoorden, reageren
Realtime
No-codeVaak polling, bij sommige abonnementen elke 15 minuten
MetaWebhooks van Meta
UnipileWebhooks zoals message.new
Wat u beheert
No-codeEén workflow per installatie
MetaMeta-app, App Review, een token per pagina
UnipileEen Hosted Auth-link, één account_id per gebruiker
Historie
No-codeVerschilt per connector
MetaGesprekken van de pagina
UnipilePersoonlijke chats en de inbox van elke pagina
Andere kanalen
No-codeEen connector per kanaal
MetaEen integratie per Meta-product
UnipileDezelfde API voor LinkedIn, WhatsApp, Instagram, e-mail

Zapier of Make passen bij één bedrijf met één pagina, en Meta Business Suite geeft dat bedrijf een inbox voor zijn eigen pagina. Een product met meerdere klanten heeft de integratie in zijn eigen code nodig.

Via de route van Meta heeft elke klantpagina een Page access token en door Meta gereviewde permissies nodig, zoals onze gids over de Facebook Page API laat zien. Antwoorden volgen het 24-uursvenster en de message tags, waarvan Meta er in 2026 meerdere heeft geschrapt. En deze route bereikt nooit de persoonlijke accounts die salesmedewerkers en adviseurs met hun klanten gebruiken.

Bronnen: Messenger Platform send messages van Meta, provider features van Unipile. Laatst gecontroleerd: 17 november 2026.

Koppeling

Koppel het Facebook-account en de pagina's van elke gebruiker

Elke CRM-gebruiker opent een Hosted Auth-link en logt in op Facebook, tweestapsverificatie inbegrepen. Uw CRM ontvangt één account_id die zijn persoonlijke account en elke pagina die hij beheert dekt, allemaal standaard geactiveerd.

1

Een Hosted Auth-link openen

Uw backend vraagt hem aan; de gebruiker opent hem.

Hosted Auth
2

Inloggen en historie ontgrendelen

Inloggegevens, 2FA en daarna optioneel de historie ontgrendelen.

ENCRYPTED_HISTORY
3

De account_id opslaan

Sla hem op bij de CRM-gebruiker. Zijn pagina's komen mee.

{ACCOUNT_ID}

Pagina's worden geactiveerd via het product page bij het koppelen of opnieuw koppelen; een niet-geactiveerde pagina geeft 403 api/insufficient_permissions terug. Het inloggen wordt uitgelegd in onze gids over de Facebook Messenger API voor persoonlijke accounts.

Bron: documentatie over Facebook Pages van Unipile. Laatst gecontroleerd: 17 november 2026.

Sync

Gespreksgeschiedenis en nieuwe berichten realtime synchroniseren

Vul eerst de historie aan via de API: persoonlijke chats, daarna de inbox van elke pagina. Schakel dan over op webhooks, zodat elk nieuw bericht, elke bewerking, leesbevestiging of reactie realtime uw CRM bereikt, zoals vermeld op onze pagina over de Facebook Messenger API.

FacebookBronPersoonlijk account + pagina'sEén per CRM-gebruiker
KoppelingUnipileEén account_id
Inkomende dataBackfill, dan webhooksEenmaal GET /chats, daarna message.new
Uw codeSync-serviceRouteert, koppelt, ontdubbelt
Uw dataCRM-databaseContacten en berichten

Backfill van persoonlijke chats en pagina-inboxen

De chatlijst van het account bevat alleen persoonlijke gesprekken; elke pagina heeft een eigen inbox, PAGE_<page_id>_INBOX. Lijsten geven maximaal 100 items per pagina terug, nieuwste berichten eerst: blader zo ver terug als uw CRM nodig heeft.

Basis-URL https://api.unipile.com · header X-API-KEY
GET/v2/{account_id}/chatsPersoonlijke chats van het gekoppelde account
GET/v2/{account_id}/inboxes/{inbox_id}/chatsChats van één pagina-inbox
GET/v2/{account_id}/chats/{chat_id}/messagesBerichten van een chat, nieuwste eerst

Versleutelde chats en historie

Persoonlijke 1-op-1- en groepschats zijn end-to-end versleuteld; gesprekken van pagina's niet. Oudere persoonlijke berichten staan in een versleutelde back-up die de gebruiker ontgrendelt met zijn herstelcode of Messenger-pincode, in een stap die Hosted Auth bij het koppelen toont. Zonder die stap zijn alleen berichten vanaf de koppeling beschikbaar.

Webhooks

Eén webhook-URL bedient alle gekoppelde accounts. Events van pagina's bevatten de chat-ID op paginaniveau, dus routeer ze op het voorvoegsel PAGE_<page_id>_. Beschikbare events voor Facebook:

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

Bronnen: Unipile retrieve chats and messages, encrypted chats, provider features en configure a webhook. Laatst gecontroleerd: 17 november 2026.

Probeer het

Koppel een Facebook-account in uw proefworkspace

Koppel een account, haal de chats op en laat een webhook naar uw service wijzen. 7 dagen gratis proberen, geen creditcard nodig.

Nu bouwen
Datamodel

Messenger-gesprekken aan CRM-contacten koppelen

Koppel elk gesprek aan een contact via de Facebook-ID van de andere persoon, nooit via de weergavenaam. Routeer gesprekken van pagina's en persoonlijke gesprekken op het voorvoegsel PAGE_<page_id>_ van de chat-ID.

IdentificatorOpslaan bijLet op
Facebook-ID van de andere persoonHet contact: uw koppelsleutelKoppel nooit op de weergavenaam
account_idDe CRM-gebruiker die Facebook heeft gekoppeldDekt het persoonlijke account en de pagina's
Persoonlijke chat-IDHet gesprekGeen contactsleutel
Chat-ID van een pagina PAGE_<page_id>_<thread_key>Het gesprek en de bijbehorende paginaDoor het voorvoegsel handelt Unipile als de pagina
Pagina-ID en profiel-ID van de paginaDe pagina-ID, bij inbox en statusAuteurs van een pagina gebruiken de profiel-ID: vergelijk de twee nooit
Facebook-ID van de andere persoon
Opslaan bijHet contact: uw koppelsleutel
Let opKoppel nooit op de weergavenaam
account_id
Opslaan bijDe CRM-gebruiker die Facebook heeft gekoppeld
Let opDekt het persoonlijke account en de pagina's
Persoonlijke chat-ID
Opslaan bijHet gesprek
Chat-ID van een pagina
Opslaan bijHet gesprek en de bijbehorende pagina (PAGE_<page_id>_<thread_key>)
Let opDoor het voorvoegsel handelt Unipile als de pagina
Pagina-ID en profiel-ID van de pagina
Opslaan bijDe pagina-ID, bij inbox en status
Let opAuteurs van een pagina gebruiken de profiel-ID: vergelijk de twee nooit

Eén valkuil: voor hetzelfde gesprek kan de chat-ID die de API teruggeeft afwijken van die in een webhook-event. Sla beide op bij het gesprek en breng ze aan CRM-zijde met elkaar in overeenstemming, verankerd op de Facebook-ID van het contact. "Find Chats by User" geeft de bestaande chats van een contact terug, of een lege lijst.

Een message.new-handler die naar het contactrecord schrijft

readUnipileEvent staat voor uw eigen mapping van de 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 · één contact per Facebook-ID, één rij per bericht-ID
200 OK · één contact per Facebook-ID, één rij per bericht-ID

Formaten van chat-ID's uit de documentatie over Facebook Pages, opzoeken van chats uit retrieve chats and messages.

Antwoorden

Antwoorden vanuit het contactrecord, als de gebruiker of als de pagina

Verstuur het antwoord naar de chat-ID van het gesprek. Een chat-ID van een pagina antwoordt als de pagina; een persoonlijke chat-ID verstuurt vanuit het eigen account van de gebruiker. Het invoerveld toont welke identiteit van toepassing is.

Uw CRM · Leo Martin Paginagesprek
Maat M, graag. Kan het vrijdag binnen zijn?10:42
Ja, als u vandaag voor 14.00 uur bestelt.Coveton Apparel · 10:44
Perfect, ik bestel nu.10:46
Antwoorden alsAnna RossiFacebookPagina Coveton Apparel
Bedankt Leo, uw bestelling is bevestigd. De trackinglink volgt.
Nieuw gesprekVersturen

Een pagina antwoordt alleen mensen die haar een bericht hebben gestuurd.

POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send 200 OK
Vanuit een paginachat
  • Antwoorden gaan uit als de pagina
  • Geen nieuw gesprek: 501 api/not_implemented
  • Eigen berichten verwijderen kan niet: dezelfde fout
Vanuit een persoonlijke chat
  • Antwoorden gaan uit vanuit het account van de gebruiker
  • Kan een gesprek starten als Facebook dat toestaat

Schakel "Nieuw gesprek" uit voor een pagina. Request body, bijlagen en fouten: lees hoe u een Messenger-bericht via de API verstuurt.

Beheer

Draai het voor elke klant: status, rechten en de regels van Meta

Toon de status van elke koppeling. Elke pagina meldt haar eigen status, dus één defecte pagina houdt persoonlijke berichten of andere pagina's niet tegen.

Beheer · Gekoppelde accounts Gedeeltelijk
KoppelingStatus
FacebookAnna RossiBerichten · persoonlijk accountrunning
Pagina Coveton Apparelpage_<page_id>running
Pagina Coveton OutletBeheerdersrol ingetrokkendisconnectedOpnieuw koppelen
STATUS metadata.products_connection_status per pagina

Elke pagina heeft een eigen sleutel in metadata.products_connection_status, met de naam page_<page_id>. Als een pagina uitvalt, wordt het account partial of degraded. Een pagina waarvan de beheerdersrol is verloren, blijft disconnected tot ze opnieuw wordt gekoppeld: toon dat en bied opnieuw koppelen aan.

Bepaal wie welke gesprekken ziet

Toon persoonlijke gesprekken aan hun eigenaar en gekozen managers, en gesprekken van pagina's aan het team van de pagina, in een unified inbox met toewijzing en tags. Hetzelfde model als een messaging-API voor CRM-software die LinkedIn, WhatsApp en e-mail dekt, en de reden waarom u met een unified messaging API Messenger toevoegt zonder nieuwe connector.

Compliance

Elke gebruiker koppelt zijn eigen account

Voor CRM, support, adviseurs of een AI-agent waarvan een persoon de concepten goedkeurt. Geen bulkverzending.

Meta-app of App Review?Niet nodig: gebruikers koppelen via Hosted Auth.
Officiële Meta-partner?Nee. Unipile is geen officiële Meta-app en geen Meta Partner.
Voorwaarden van Meta?Elke gebruiker blijft eraan gebonden.
Digital Markets Act?Geen opslag van profielen. Zie onze pagina over de Digital Markets Act.

Begin met het bouwen van uw Messenger-integratie

Een Facebook Messenger CRM-integratie bestaat uit één koppeling per gebruiker, een backfill gevolgd door webhooks, contacten gekoppeld op Facebook-ID's en antwoorden met de juiste identiteit. Dezelfde code werkt voor LinkedIn, WhatsApp en e-mail. 7 dagen gratis proberen, geen creditcard nodig.

Europese Commissie
EU-gereguleerd Digital Markets Act (DMA)

Elke gebruiker koppelt zijn eigen account, zonder opslag van profielen. Unipile is geen Meta Partner. Unipile en de DMA

Alle endpoints van de Facebook API op één plek

Messenger is één onderdeel van het geheel. Bekijk elk Facebook-endpoint dat beschikbaar is met Unipile, van posts en opmerkingen tot profielen, of begin bij onze volledige Facebook API-gids.

FAQ over Facebook Messenger CRM-integratie

CRM-messaging, geautomatiseerde antwoorden en meerdere pagina's.

Zodat gesprekken niet langer alleen op de telefoon van één persoon staan. Elk bericht belandt op het contactrecord, het team ziet de volledige historie, en opvolging, toewijzing en rapportage werken op Messenger net als bij e-mail.

Berichten versturen en ontvangen op Messenger, WhatsApp, LinkedIn of e-mail vanuit een CRM, waarbij elk gesprek aan een contact is gekoppeld. Een Facebook Messenger CRM-integratie dekt één kanaal; een unified messaging API brengt de andere kanalen binnen via hetzelfde datamodel.

Houd een mens in de lus: een AI-agent schrijft een conceptantwoord op basis van de historie van het contact en een gebruiker keurt het goed voor verzending. Gebruikers blijven gebonden aan de voorwaarden van Meta: geen ongevraagde berichten of bulkberichten.

Ja. Elke pagina die de gebruiker beheert, is standaard geactiveerd op dezelfde account_id, elk met een eigen inbox (PAGE_<page_id>_INBOX) en een eigen status. Toon elke pagina als een aparte inbox in uw CRM.

Nog vragen? Ons team helpt u graag.

Praat met een expert