NL
Persoonlijke accounts

Facebook Messenger API voor een persoonlijk account: wat Meta toestaat en hoe u er een koppelt

Zoekt u een Facebook Messenger API voor een persoonlijk account? Het Messenger Platform van Meta bedient alleen Facebook-pagina's. Hier leest u waarom, en hoe uw gebruikers hun eigen account aan uw app koppelen.

Uw CRM Gekoppeld
Tom ReyesFacebookAnna Lee, persoonlijk account
Hoi Anna, kunnen we ons gesprek naar donderdag verzetten?09:12
Webhook: message.new
Prima, donderdag om 10 uur past. Ik stuur de uitnodiging.09:14 · Gezien
POST api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send 200 OK
Kort antwoord

De officiële Facebook Messenger API ondersteunt geen persoonlijke accounts. Met het Messenger Platform van Meta kan een Facebook-pagina of een professioneel Instagram-account mensen antwoorden, nooit een persoonlijk profiel. Om met een persoonlijk Facebook-account te werken, koppelt de eigenaar het aan uw app via een externe API zoals Unipile.

Opensourceprojecten die messenger.com vanuit een browser aansturen, zijn niet officieel, worden meestal niet onderhouden en gaan stuk zodra de interface verandert. Een gekoppeld account loopt via een onderhouden API met webhooks.

Voor het bredere beeld van de API's van Meta, zie hoe de Facebook API's samenhangen.

Met Unipile

Berichten vanuit een persoonlijk Facebook-account in drie stappen

  1. 1

    Koppelen. Uw gebruiker koppelt zijn eigen Facebook-account via Hosted Auth. Geen Meta-app, geen App Review.

  2. 2

    Versturen. Roep de V2 API aan met uw header X-API-KEY:POST/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send

  3. 3

    Ontvangen. Inkomende berichten komen bij uw webhook binnen als events message.new.

Het antwoord

Werkt de Facebook Messenger API met een persoonlijk account?

De officiële niet. Meta bouwde het Messenger Platform voor bedrijven: een Facebook-pagina of een professioneel Instagram-account kan er de mensen mee antwoorden die het een bericht sturen. Een persoonlijk Facebook-account bereikt uw app alleen als de eigenaar het koppelt, via een externe API die namens hem handelt.

Messenger Platform van Meta
Facebook

Facebook-pagina

  • Uw Meta-app handelt voor een pagina met een Page access token.
  • De pagina antwoordt mensen die eerst een bericht sturen.
  • Standaard berichtenvenster van 24 uur na het laatste bericht van de persoon.
  • App Review voordat u pagina's bedient die niet van u zijn.
Gekoppeld account met Unipile
Facebook

Persoonlijk Facebook-account

  • Elke gebruiker koppelt zijn eigen account via hosted authentication.
  • Uw app leest en verstuurt berichten vanaf dat account.
  • Eén REST API en één webhookformaat voor elk kanaal.
  • De gebruiker blijft gebonden aan de voorwaarden van Meta.

Bron: het overzicht van het Messenger Platform van Meta. Laatst gecontroleerd: november 2026.

Officieel model

Waarom het Messenger Platform van Meta stopt bij Facebook-pagina's

Het Messenger Platform is ontworpen rond een pagina, niet rond een persoon. Elke call handelt namens een Facebook-pagina, met een Page access token en de permissie pages_messaging, dus er bestaat geen token dat een persoonlijke inbox vertegenwoordigt.

1

Meta-app

U registreert een app op Meta for Developers met de Messenger-use-case.

2

Facebook Login for Business

Een paginabeheerder verleent permissies zoals pages_messaging.

3

Page access token

Uw app roept de Send API alleen namens die pagina aan.

4

Webhook en venster van 24 uur

De pagina ontvangt berichten en antwoordt binnen het standaard berichtenvenster.

Permissies vraagt u aan via Facebook Login for Business, en business_management is een vereiste voor pages_messaging. App Review is niet nodig als u alleen berichten verstuurt en ontvangt voor uw eigen pagina; voor de pagina's van andere bedrijven wel. De meeste antwoorden moeten binnen 24 uur na het laatste bericht van de persoon worden verstuurd; de message tag HUMAN_AGENT verlengt handmatige antwoorden tot 7 dagen, na App Review. Geen van deze Graph API-stappen kan een persoonlijk profiel als doel hebben, en daarom koppelen tools op basis van de officiële API alleen pagina's. Wat deze opzet kost, leest u in onze gids over de prijzen van de Facebook Messenger API.

Bronnen: het overzicht van het Messenger Platform en de Send API-referentie van Meta. Laatst gecontroleerd: november 2026.

Wat is er met de Facebook Chat API gebeurd?

Meta heeft de oude Facebook Chat API (XMPP, chat.facebook.com) in 2015 stopgezet, samen met het einde van Graph API v1.0 en de permissie xmpp_login. Er bestaat geen officiële API voor een persoonlijke Facebook-inbox: het Messenger Platform dat haar voor zakelijke berichten verving, werkt alleen voor pagina's. De onofficiële bibliotheken die sindsdien op npm verschijnen, loggen in op messenger.com met de eigen sessie van de gebruiker. Meta ondersteunt ze niet, en het oorspronkelijke open source project geeft aan dat het in onderhoudsmodus staat.

  • Geen releaseschema. Ze werken niet meer zodra Facebook zijn interface wijzigt.
  • Inloggegevens in uw app. Uw app bewaart en hergebruikt de sessie of het wachtwoord van de gebruiker.
  • Risico voor het account. Facebook kan een account beperken waarvan het gebruik de voorwaarden schendt, en dat risico ligt bij de eindgebruiker.

Om berichten te sturen vanaf een pagina die u beheert, gebruikt u het Messenger Platform en verstuurt u een Messenger-bericht via de API. Voor het eigen account van de gebruiker gebruikt u een onderhouden API: de gebruiker koppelt zijn account via Hosted Auth, zodat uw app nooit met zijn wachtwoord omgaat, en u krijgt een account_id, webhooks en een supportteam (zie hoe een persoonlijk account wordt gekoppeld). De voorwaarden van Meta blijven op dat account van toepassing.

Koppeling

Hoe een persoonlijk Facebook-account aan uw app wordt gekoppeld

De eigenaar van het account koppelt het zelf. Uw app opent een Hosted Auth-pagina van Unipile (of uw eigen scherm met Custom Auth), de gebruiker logt in bij Facebook en bevestigt de tweestapsverificatie, en uw app ontvangt een account_id om de API mee aan te roepen.

1Uw app

Hosted Auth openen

De gebruiker klikt op "Facebook koppelen" en komt op Hosted Auth terecht.

2De gebruiker

Inloggen en bevestigen

Gebruikersnaam, e-mailadres of telefoonnummer met wachtwoord, browsercookies of de UniLogin-extensie, daarna 2FA via sms, authenticator-app, WhatsApp, goedkeuring in de app of eenmalige code.

3Unipile

Een account_id ontvangen

Het gekoppelde account verschijnt in uw dashboard en elke call gebruikt zijn account_id.

In deze flow is er geen OAuth-scherm van Meta en geen QR-code, en u maakt geen Meta-app aan en doorloopt geen App Review aan uw kant. De methoden per provider staan in de tabel met providerfuncties, en het productoverzicht vindt u op de pagina Facebook Messenger API.

Compliance

Elke gebruiker koppelt zijn eigen account

Unipile is geen product van Meta. Het is geen Meta Partner en wordt niet door Meta onderschreven. Elke gebruiker koppelt zijn eigen account, Unipile handelt namens die geauthenticeerde gebruiker, en de gebruiker blijft gebonden aan de voorwaarden van Meta.

Reikwijdte

Facebook API voor een persoonlijk account: wat een gekoppeld account kan

In de praktijk maakt een integratie van de Facebook Messenger API met een persoonlijk account de eigen Messenger-inbox van de gebruiker beschikbaar via de Unipile API: chats, berichten, bijlagen, reacties en bevestigingen, plus realtime webhooks, hieronder vergeleken met het officiële paginamodel.

OnderwerpPagina via Messenger PlatformPersoonlijk account via Unipile
AccountEen Facebook-pagina of professioneel Instagram-accountHet eigen persoonlijke Facebook-account van de gebruiker
Wie koppeltEen paginabeheerder, via Facebook Login for BusinessDe eigenaar van het account, via Hosted Auth of Custom Auth
Wat uw app bewaartEen Page access tokenUw Unipile API-sleutel en de account_id van de gebruiker
Meta-app en App ReviewEen Meta-app, plus App Review om pagina's te bedienen die niet van u zijnGeen Meta-app en geen App Review aan uw kant
Wie schrijft eerstDe persoon stuurt de pagina een berichtDe gebruiker kan antwoorden of een nieuw gesprek starten
Realtime eventsMessenger-webhooks op uw Meta-appNieuwe, bewerkte en verwijderde berichten, lees- en afleverbevestigingen, reacties, chatupdates
Account
PaginaEen Facebook-pagina of professioneel Instagram-account
Persoonlijk accountHet eigen persoonlijke Facebook-account van de gebruiker
Wie koppelt
PaginaEen paginabeheerder, via Facebook Login for Business
Persoonlijk accountDe eigenaar van het account, via Hosted Auth of Custom Auth
Wat uw app bewaart
PaginaEen Page access token
Persoonlijk accountUw Unipile API-sleutel en de account_id van de gebruiker
Meta-app en App Review
PaginaEen Meta-app, plus App Review om pagina's te bedienen die niet van u zijn
Persoonlijk accountGeen Meta-app en geen App Review aan uw kant
Wie schrijft eerst
PaginaDe persoon stuurt de pagina een bericht
Persoonlijk accountDe gebruiker kan antwoorden of een nieuw gesprek starten
Realtime events
PaginaMessenger-webhooks op uw Meta-app
Persoonlijk accountNieuwe, bewerkte en verwijderde berichten, lees- en afleverbevestigingen, reacties, chatupdates

Berichten-endpoints

  • Chats en berichten oplijsten, inclusief groepsgesprekken
  • Een gesprek starten, berichten en bijlagen versturen
  • Berichten bewerken, verwijderen en doorsturen
  • Reacties toevoegen en verwijderen, als gelezen markeren, leesbevestigingen
  • Chats dempen en archiveren

Niet ondersteund

  • Een bericht vastzetten
  • Stories

Hetzelfde gekoppelde account geeft ook toegang tot zijn posts, opmerkingen en reacties. Die endpoints worden samengevat in de Facebook API-gids.

Code

Chats lezen en een bericht versturen vanaf een persoonlijk account

Twee calls dekken de basiscyclus: de chats van het gekoppelde account oplijsten en daarna in een ervan een bericht versturen. Requests gaan naar https://api.unipile.com met uw API-sleutel in de 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."},
)
200 OK · bericht verstuurd vanaf het eigen account van de gebruiker

Inkomende berichten komen als message.new-events binnen op uw webhook, dus pollen is niet nodig. De Node.js SDK verpakt dezelfde calls als getChatsList en sendMessage. De volledige setup staat in de Facebook-quickstart. Meer talen, bijlagen en antwoorden als pagina vindt u in een bericht versturen met de Facebook Messenger API.

Zo zien de twee calls eruit in uw app

1De chats oplijstenGET/chats
Uw app Gekoppeld
FacebookAnna Lee, persoonlijk account
Tom ReyesHoi Anna, kunnen we ons gesprek naar donderdag verplaatsen?
Maya ChenTot zaterdag op de markt
Sam PatelBedankt voor de foto's
Geselecteerde chat
chat_id
{CHAT_ID}
name
Tom Reyes
laatste bericht
Hoi Anna, kunnen we…
timestamp
09:12
2Het antwoord versturenPOST/messages/send
Uw app Gekoppeld
Tom ReyesFacebookAnna Lee, persoonlijk account
Hoi Anna, kunnen we ons gesprek naar donderdag verplaatsen?09:12
Donderdag om 10 uur komt mij goed uit.09:14 · Gezien
Request
chat_id
{CHAT_ID}
text
Donderdag om 10 uur…
response
200 OK
Use cases

Legitieme use cases, en de regels van Meta die uw gebruikers blijven volgen

Een gekoppeld persoonlijk account past bij producten waarin een professional met zijn eigen contacten praat vanaf zijn eigen account: CRM's, helpdesks, AI-assistenten die antwoorden opstellen die de gebruiker goedkeurt, en tools voor adviseurs. Het is niet bedoeld voor koude outreach of volledig geautomatiseerde bots.

CRM

Een verkoper vindt zijn Messenger-gesprekken terug op het juiste contactrecord, naast e-mails en calls. Bekijk de CRM-integratie.

Helpdesk en omnichannel inbox

Messenger staat in dezelfde inbox als LinkedIn, WhatsApp, Instagram en Telegram, met één datamodel.

AI-assistent

Een agent stelt een antwoord op uit de gespreksgeschiedenis, en de gebruiker controleert het voordat het wordt verstuurd.

Opvolging door adviseurs

Een consultant of tussenpersoon houdt de klanten bij met wie hij al via Messenger praat.

De voorwaarden van Meta blijven gelden

Een gekoppeld account blijft gebonden aan de servicevoorwaarden van Meta. Bouw voor gesprekken die de gebruiker hoe dan ook zou voeren: ongevraagde berichten en niet-toegestane automatisering kunnen ertoe leiden dat Meta het account beperkt.

Bouwt u één inbox voor meerdere netwerken? Lees hoe een unified messaging API werkt.

Graph API

Facebook API voor persoonlijke accounts: wat de Graph API nog toestaat

Een Facebook API-integratie voor een persoonlijk account via de Graph API van Meta is beperkt. Ze kan de persoon identificeren en enkele profielvelden lezen, maar kan zijn Messenger-inbox niet openen en niet namens hem publiceren.

Identificatie werkt nog. Met Facebook Login geeft de persoon uw app een user access token. De permissie public_profile leest de standaardvelden van het openbare profiel en email leest het primaire e-mailadres. Andere gebruikerspermissies, zoals user_posts voor de posts die een gebruiker op zijn tijdlijn heeft geplaatst, beperkt Meta tot een korte lijst goedgekeurde toepassingen. Geen enkele gebruikerspermissie geeft toegang tot de Messenger-gesprekken van de persoon. Hoe deze tokens worden uitgegeven, leest u in onze gids over het Facebook API access token.

Publiceren op een profiel stopte in 2018. Meta verwijderde de permissie publish_actions op 24 april 2018, en apps die er al voor waren goedgekeurd, konden haar nog gebruiken tot 1 augustus 2018. Sindsdien publiceren apps die op de Graph API zijn gebouwd alleen nog op pagina's, en daarom bieden planningstools geen persoonlijke profielen meer aan.

Een gekoppeld account dekt beide kanten. Wanneer de eigenaar zijn persoonlijke account via Unipile koppelt, leest en verstuurt uw app de Messenger-berichten ervan, en maakt, bewerkt en verwijdert ze de posts, opmerkingen en reacties ervan. De publicatiekant wordt uitgelegd in onze gids over de Facebook post API.

ActieGraph API met een user access tokenPersoonlijk account gekoppeld via Unipile
De Messenger-berichten van de gebruiker lezenNee, geen enkele gebruikerspermissie dekt de inboxJa, chats, berichten en bijlagen
Publiceren op het profiel van de gebruikerNee, publish_actions is in 2018 verwijderdJa, posts maken, bewerken en verwijderen
Berichten beantwoordenNee, het Messenger Platform bedient pagina'sJa, antwoorden of een gesprek starten
De Messenger-berichten van de gebruiker lezen
Graph APINee, geen enkele gebruikerspermissie dekt de inbox
Gekoppeld accountJa, chats, berichten en bijlagen
Publiceren op het profiel van de gebruiker
Graph APINee, publish_actions is in 2018 verwijderd
Gekoppeld accountJa, posts maken, bewerken en verwijderen
Berichten beantwoorden
Graph APINee, het Messenger Platform bedient pagina's
Gekoppeld accountJa, antwoorden of een gesprek starten

Bronnen: de referentie voor permissies en de Graph API-changelog van 24 april 2018 van Meta. Laatst gecontroleerd: 17 november 2026.

Koppel persoonlijke Facebook-accounts aan uw product

Het Messenger Platform van Meta blijft het juiste gereedschap voor een bedrijf dat mensen antwoordt op zijn eigen pagina. Heeft uw product een Facebook Messenger API nodig, persoonlijke accounts inbegrepen, laat uw gebruikers dan hun eigen Facebook-account koppelen en gebruik één API voor Facebook en uw andere kanalen.

Europese Commissie
EU-gereguleerd Digital Markets Act (DMA)

Elke gebruiker koppelt zijn eigen account, zonder opslag van profielen. Unipile is geen Meta Partner. Lees onze pagina over de Digital Markets Act

Endpointreferentie

Alle endpoints van de Facebook API op één plek

Berichten zijn één onderdeel van het geheel. Bekijk elk Facebook-endpoint dat beschikbaar is met Unipile, van chats tot posts, of lees de volledige Facebook API-gids om de officiële API's van Meta te vergelijken met gekoppelde accounts.

FAQ over de API voor persoonlijke Facebook-accounts

Snelle antwoorden over profielen, berichtgeschiedenis, eerste berichten, reacties, pagina's, chatbots, de Graph API en onofficiële bibliotheken.

Het Messenger Platform van Meta niet: dat bedient Facebook-pagina's en professionele Instagram-accounts. Een persoonlijk profiel kan worden gebruikt wanneer de eigenaar het via de hosted authentication van Unipile aan uw app koppelt, en de eigenaar blijft gebonden aan de voorwaarden van Meta.

Ja, zodra het account gekoppeld is. De API lijst de chats en berichten van het gekoppelde persoonlijke account op, inclusief groepsgesprekken en bijlagen, en webhooks sturen nieuwe, bewerkte en verwijderde berichten naar uw app.

Ja. Een gekoppeld persoonlijk account kan zowel een nieuw gesprek starten als antwoorden. Beperk het tot mensen die de gebruiker kent of met wie hij werkt: ongevraagde berichten gaan in tegen de voorwaarden van Meta en kunnen tot beperking van het account leiden.

Ja. U kunt reacties op berichten oplijsten, toevoegen en verwijderen, en nieuwe reacties bereiken uw app via het webhook-event message.reaction.new.

Ja, voor pagina's die de gekoppelde gebruiker beheert. Uw app kan de berichten van de pagina lezen en beantwoorden en publiceren als de pagina. Een pagina kan geen gesprek starten en haar berichten niet verwijderen, dus een paginagesprek begint altijd doordat de persoon eerst schrijft.

Het Messenger Platform van Meta, en de chatbotbouwers die erop steunen, werken alleen met pagina's. Houd bij een gekoppeld persoonlijk account een mens in de lus: een AI stelt een antwoord op en de gebruiker keurt het goed. Volledig geautomatiseerde of ongevraagde berichten kunnen tot beperking van het account leiden.

Gedeeltelijk. De Graph API van Meta accepteert nog een persoonlijk profiel voor Facebook Login en enkele leespermissies, maar kan de Messenger-inbox van de persoon niet openen en publiceert sinds de verwijdering van publish_actions in 2018 niet meer op profielen. Voor een Facebook API-koppeling met een persoonlijk account die berichten en posts dekt, koppelt de eigenaar het account via Unipile en werkt uw app met één REST API.

Ja. Er bestaan open source bibliotheken die met de eigen sessie van de gebruiker inloggen op messenger.com, maar ze zijn onofficieel en worden niet door Meta ondersteund. Ze kunnen ophouden te werken zodra Facebook zijn interface wijzigt, en het account dat ze gebruikt kan op grond van de voorwaarden van Meta worden beperkt. Gebruik voor een productie-app het Messenger Platform voor pagina's die u beheert, of een onderhouden API waarmee de gebruiker zijn eigen account koppelt en gebonden blijft aan de voorwaarden van Meta.

Niet via hun Facebook Messenger-integraties: die steunen op het Messenger Platform van Meta, dat alleen pagina's bedient. Met een persoonlijk account dat via Unipile is gekoppeld, wordt het bericht verstuurd vanuit uw eigen workflow, bijvoorbeeld een HTTP-stap die het endpoint voor het versturen van berichten voor dat account aanroept.

Nee. Unipile is een onafhankelijk bedrijf: het is geen Meta Partner en wordt niet onderschreven, gesponsord of goedgekeurd door Meta. Een persoonlijk Messenger-account koppelen via Unipile is geen officiële integratie met het Messenger Platform. Facebook en Messenger zijn handelsmerken van Meta Platforms, Inc.

Nee. De eigenaar van het account meldt zich aan via de hosted authentication van Unipile, dus u registreert geen Meta-app, vraagt geen pages_messaging aan en doorloopt aan uw kant geen App Review. Hetzelfde geldt voor de pagina's die deze gebruiker beheert.

Unipile is ontworpen in de geest van de Digital Markets Act. Elke persoon koppelt zijn eigen Facebook-account, berichten worden namens hem gelezen en verstuurd, en Unipile slaat geen gebruikersprofielen op. Details op onze pagina over de Digital Markets Act.

Ja. Een gekoppeld persoonlijk account blijft een Facebook-account onder de voorwaarden van Meta. Houd het bij legitiem gebruik zoals klanten antwoorden, gesprekken synchroniseren met een CRM of een gebruiker helpen zijn eigen inbox te beheren; massale of ongevraagde berichten kunnen ertoe leiden dat het account wordt beperkt.

Nog vragen? Ons team helpt u graag.

Praat met een expert