
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.
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
Inhoudsopgave
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
Koppel het Facebook-account en de pagina's van elke gebruiker via Hosted Auth. Geen Meta-app, geen App Review.
- 2
Importeer hun bestaande chats met
GET /v2/{account_id}/chats, met uw headerX-API-KEY. - 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.
Leo MartinLead · Lyon
EigenaarAnna Rossi
KanaalMessenger · pagina Coveton Apparel
Facebook-ID
{FACEBOOK_USER_ID}ActiviteitE-mailMessenger 2Deals
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.
| Vraag | No-code connector | Meta Messenger Platform | Koppeling per gebruiker (Unipile) |
|---|---|---|---|
| Accounts | Meestal één Facebook-pagina | Alleen Facebook-pagina's (bedrijfspagina's) | Persoonlijke accounts en de pagina's die ze beheren |
| Richting | Grotendeels één richting: bericht naar lead | Twee richtingen, binnen het 24-uursvenster | Sync in twee richtingen: lezen, antwoorden, reageren |
| Realtime | Vaak polling, bij sommige abonnementen elke 15 minuten | Webhooks van Meta | Webhooks zoals message.new |
| Wat u beheert | Eén workflow per installatie | Meta-app, App Review, een token per pagina | Een Hosted Auth-link, één account_id per gebruiker |
| Historie | Verschilt per connector | Gesprekken van de pagina | Persoonlijke chats en de inbox van elke pagina |
| Andere kanalen | Een connector per kanaal | Een integratie per Meta-product | Dezelfde 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.newWat u beheert
No-codeEén workflow per installatie
MetaMeta-app, App Review, een token per pagina
UnipileEen Hosted Auth-link, één
account_id per gebruikerHistorie
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 Auth2
Inloggen en historie ontgrendelen
Inloggegevens, 2FA en daarna optioneel de historie ontgrendelen.
ENCRYPTED_HISTORY3
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.
KoppelingUnipileEén
account_idInkomende dataBackfill, dan webhooksEenmaal
GET /chats, daarna message.newUw 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-KEYGET/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
Nu bouwen
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.
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.
| Identificator | Opslaan bij | Let op |
|---|---|---|
| Facebook-ID van de andere persoon | Het contact: uw koppelsleutel | Koppel nooit op de weergavenaam |
account_id | De CRM-gebruiker die Facebook heeft gekoppeld | Dekt het persoonlijke account en de pagina's |
| Persoonlijke chat-ID | Het gesprek | Geen contactsleutel |
Chat-ID van een pagina PAGE_<page_id>_<thread_key> | Het gesprek en de bijbehorende pagina | Door het voorvoegsel handelt Unipile als de pagina |
| Pagina-ID en profiel-ID van de pagina | De pagina-ID, bij inbox en status | Auteurs 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.
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 Rossi
Pagina 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.
KoppelingStatus
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.
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
