
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.
Tom Reyes
Anna 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
Inhoudsopgave
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
Koppelen. Uw gebruiker koppelt zijn eigen Facebook-account via Hosted Auth. Geen Meta-app, geen App Review.
- 2
Versturen. Roep de V2 API aan met uw header
X-API-KEY:POST/v2/{ACCOUNT_ID}/ chats/ {CHAT_ID}/ messages/ send - 3
Ontvangen. Inkomende berichten komen bij uw webhook binnen als events
message.new.
Details in de koppelingsflow en codevoorbeelden hieronder, of in de Facebook-quickstart.
Start uw gratis proefperiode van 7 dagen
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-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
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.
| Onderwerp | Pagina via Messenger Platform | Persoonlijk account via Unipile |
|---|---|---|
| Account | Een Facebook-pagina of professioneel Instagram-account | Het eigen persoonlijke Facebook-account van de gebruiker |
| Wie koppelt | Een paginabeheerder, via Facebook Login for Business | De eigenaar van het account, via Hosted Auth of Custom Auth |
| Wat uw app bewaart | Een Page access token | Uw Unipile API-sleutel en de account_id van de gebruiker |
| Meta-app en App Review | Een Meta-app, plus App Review om pagina's te bedienen die niet van u zijn | Geen Meta-app en geen App Review aan uw kant |
| Wie schrijft eerst | De persoon stuurt de pagina een bericht | De gebruiker kan antwoorden of een nieuw gesprek starten |
| Realtime events | Messenger-webhooks op uw Meta-app | Nieuwe, 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 gebruikerMeta-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
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
Tom Reyes
Anna 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.
| Actie | Graph API met een user access token | Persoonlijk account gekoppeld via Unipile |
|---|---|---|
| De Messenger-berichten van de gebruiker lezen | Nee, geen enkele gebruikerspermissie dekt de inbox | Ja, chats, berichten en bijlagen |
| Publiceren op het profiel van de gebruiker | Nee, publish_actions is in 2018 verwijderd | Ja, posts maken, bewerken en verwijderen |
| Berichten beantwoorden | Nee, het Messenger Platform bedient pagina's | Ja, 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 verwijderdGekoppeld 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.
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
