
Tutorial
Een bericht versturen met de Facebook Messenger API: tutorial voor Node.js, Python en PHP
De regels van de Send API van Meta in 2026, en daarna één REST-call om te versturen vanuit de eigen accounts van uw gebruikers.
Persoonlijke chat
Tom BeckerVan Anna Lee
Kunnen we de demo verzetten?
Donderdag 10 uur past mij.
Gezien
Paginachat
Maya RossAan Northwind Bakery
Bezorgen jullie op zondag?
Ja, van 9 tot 12 uur.
Afgeleverd
GET
chats
POSTmessages/send
POSTchats/send
200 OK
Inhoudsopgave
Twee routes
Bouwen
Kort antwoord
Er zijn twee manieren om via een API een Facebook Messenger-bericht te versturen. De Send API van Meta verstuurt vanaf een Facebook-pagina, met een Page access token, en alleen naar mensen die de pagina in de afgelopen 24 uur een bericht hebben gestuurd. Een unified API zoals Unipile verstuurt vanuit het gekoppelde account van uw gebruiker (een persoonlijk account of een pagina die hij beheert) met één REST-call: POST /v2/{account_id}/chats/{chat_id}/messages/send.
POST/{PAGE-ID}/messagesMeta: antwoorden als pagina
POST/v2/{account_id}/chats/{chat_id}/messages/sendUnipile: antwoorden in een bestaande chat
POST/v2/{account_id}/chats/sendUnipile: als eerste schrijven
Met Unipile
Een Messenger-bericht versturen in drie stappen
- 1
Koppelen. Uw gebruiker koppelt zijn Facebook-account of pagina via Hosted Auth. Geen Meta-app, geen App Review.
- 2
Versturen. Roep
POST /v2/{account_id}/chats/{chat_id}/messages/sendaan met uwX-API-KEYen eentext. - 3
Luisteren. De webhook
message.newbevestigt de verzending en levert de antwoorden.
Code in vier talen: versturen vanuit een gekoppeld account. Referentie: documentatie Unipile V2 Send messages.
Nu bouwen
Kies een route
Twee manieren om via een API een Messenger-bericht te versturen
De Send API van Meta handelt namens een pagina die uw app beheert. Unipile handelt namens het account dat uw eindgebruiker heeft gekoppeld.
| Criterium | Meta Send API | Unipile API |
|---|---|---|
| Afzender | Een Facebook-pagina | Het persoonlijke account van de gebruiker, of een pagina die hij beheert |
| Configuratie | Meta-app, Page token met pages_messaging, App Review om pagina's van andere bedrijven te bedienen | API-sleutel en een account_id via Hosted Auth, geen Meta-app |
| Wie schrijft eerst | Altijd de persoon | Een persoonlijk account kan dat; een pagina antwoordt alleen |
| Venster | 24 uur, tot 7 dagen na een Click-to-Messenger-advertentie | Geen Send API-venster; Facebook kan een ontvanger weigeren |
Afzender
Meta Send APIEen Facebook-pagina
Unipile APIHet persoonlijke account van de gebruiker, of een pagina die hij beheert
Configuratie
Meta Send APIMeta-app, Page token met
pages_messaging, App Review om pagina's van andere bedrijven te bedienenUnipile APIAPI-sleutel en een
account_id via Hosted Auth, geen Meta-appWie schrijft eerst
Meta Send APIAltijd de persoon
Unipile APIEen persoonlijk account kan dat; een pagina antwoordt alleen
Venster
Meta Send API24 uur, tot 7 dagen na een Click-to-Messenger-advertentie
Unipile APIGeen Send API-venster; Facebook kan een ontvanger weigeren
Een bot voor uw eigen pagina past bij de route van Meta; een CRM, helpdesk of AI-agent in de gesprekken van uw klanten heeft een gekoppeld account nodig. Voor het volledige overzicht, zie hoe de Facebook API's samenhangen.
Meta Send API
Een bericht versturen met de Facebook Graph API (Send API)
De officiële route van Meta is de Send API van het Messenger Platform: POST https://graph.facebook.com/v27.0/{PAGE-ID}/messages met een Page access token met pages_messaging, een recipient.id, een messaging_type en een message-object. Hij antwoordt alleen mensen die uw pagina hebben geschreven.
1
Maak een Meta-app en koppel een pagina
Voeg Messenger toe en koppel de pagina.
2
Haal een Page access token op
Met pages_messaging; App Review om andere bedrijven te bedienen. Zie onze gids over het Facebook API-toegangstoken.
3
Verstuur de request
Spreek de persoon aan via zijn PSID (Page-scoped ID), gelezen uit de messages-webhook.
access_tokenPage access token
recipient.idDe PSID van de persoon
messaging_typeRESPONSE, UPDATE of MESSAGE_TAG
message.text"Hello, world!"
responserecipient_id, message_id
POST
graph.facebook.com/v27.0/{PAGE-ID}/messages
200 OK
RESPONSE: een antwoord, binnen het venster.UPDATE: een bericht dat u zelf start, binnen het venster.MESSAGE_TAG: buiten het venster, met een tag en niet-promotionele inhoud.
Waar de PSID vandaan komt
1Inkomend
Iemand schrijft uw pagina
Messenger2POST
Meta roept uw webhook aan
messages-event3PSID
Lees de ID van de afzender
messaging[0].sender.id4POST
Antwoord met de Send API
recipient.id = PSIDIn het messages-event is sender.id de PSID van de persoon en recipient.id de ID van uw pagina. Kopieer de request uit de tabbladen Meta cURL, Node.js, Python en PHP van het codeblok hieronder.
Bronnen: Meta, Send a Message en de documentatie van het messages webhook event. Laatst gecontroleerd: 17 november 2026.
Regels
Het 24-uursvenster van Messenger en message tags in 2026
De Send API schrijft alleen naar mensen die de pagina hebben geschreven, tot 24 uur na hun laatste bericht, of tot 7 dagen na een Click-to-Messenger-advertentie. Daarna dekt HUMAN_AGENT een menselijk antwoord binnen 7 dagen, en drie update-tags mislukken sinds 27 april 2026 met fout 100.
Start
De persoon schrijft
Dat opent het standaardvenster.
0 tot 24 u
Venster open
Versturen met RESPONSE of UPDATE.
Tot 7 dagen
Menselijke agent
HUMAN_AGENT -tag, voor een antwoord dat een persoon schrijft.
Daarna
Venster gesloten
Wacht op een nieuw bericht.
Uitgefaseerd op 27 april 2026
Requests met de tags CONFIRMED_EVENT_UPDATE, ACCOUNT_UPDATE of POST_PURCHASE_UPDATE mislukken nu met foutcode 100.
Bronnen: Meta, Send API reference en Send a Message. Laatst gecontroleerd: november 2026.
Tutorial
Een Facebook Messenger-bericht versturen vanuit een gekoppeld account (Node.js, Python, PHP, cURL)
Uw gebruiker koppelt zijn Facebook-account één keer en u krijgt een account_id. Toon zijn chats en verstuur daarna in een chat_id. Requests gaan naar https://api.unipile.com met uw sleutel in de header X-API-KEY, via de Facebook Messenger API van Unipile. De Meta-tabbladen versturen hetzelfde antwoord met de Send API van Meta, vanaf een pagina die u beheert.
1
Koppel het account
De gebruiker logt in op een Hosted Auth-pagina. Details in onze gids over de Messenger API voor persoonlijke accounts.
2
Toon de chats
GET /v2/{account_id}/chats geeft maximaal 100 chats per pagina terug.
3
Verstuur het bericht
Eén POST met een veld text.
# 1. List chats
curl --request GET \
--url 'https://api.unipile.com/v2/acc_123456789/chats?limit=20' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'accept: application/json'
# 2. Send a message
curl --request POST \
--url https://api.unipile.com/v2/acc_123456789/chats/CHAT_ID/messages/send \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{ "text": "Thanks, your order ships today." }'
// npm i @unipile/sdk
import { UnipileMessaging } from '@unipile/sdk';
const request_options = {
baseUrl: 'https://api.unipile.com',
headers: { 'X-API-KEY': 'YOUR_API_KEY' },
throwOnError: true,
};
const messagingApi = new UnipileMessaging();
// 1. List chats
const chats = await messagingApi.getChatsList({
...request_options,
path: { account_id: 'acc_123456789' },
query: { limit: 20 },
});
// 2. Send a message
await messagingApi.sendMessage({
...request_options,
path: { account_id: 'acc_123456789', chat_id: 'CHAT_ID' },
body: { text: 'Thanks, your order ships today.' },
});
import unipile
configuration = unipile.Configuration()
configuration.api_key["apiKey"] = "YOUR_API_KEY"
api_client = unipile.ApiClient(configuration)
messaging_api = unipile.MessagingApi(api_client)
# 1. List chats
chats = messaging_api.get_chats_list("acc_123456789", limit=20)
# 2. Send a message
messaging_api.send_message(
"CHAT_ID",
"acc_123456789",
{"text": "Thanks, your order ships today."},
)
<?php
$base = 'https://api.unipile.com/v2/acc_123456789';
$headers = ['X-API-KEY: YOUR_API_KEY', 'accept: application/json'];
// 1. List chats
$ch = curl_init("$base/chats?limit=20");
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => $headers,
CURLOPT_RETURNTRANSFER => true,
]);
$chats = json_decode(curl_exec($ch), true);
curl_close($ch);
// 2. Send a message
$ch = curl_init("$base/chats/CHAT_ID/messages/send");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => array_merge($headers, ['content-type: application/json']),
CURLOPT_POSTFIELDS => json_encode(['text' => 'Thanks, your order ships today.']),
CURLOPT_RETURNTRANSFER => true,
]);
$sent = json_decode(curl_exec($ch), true);
curl_close($ch);
# Meta Send API: reply to a person who messaged your Page
curl -X POST \
"https://graph.facebook.com/v27.0/PAGE_ID/messages?access_token=PAGE_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"recipient": { "id": "PSID" },
"messaging_type": "RESPONSE",
"message": { "text": "Thanks, your order ships today." }
}'
// Node.js 18+: built-in fetch, no SDK
const url = 'https://graph.facebook.com/v27.0/PAGE_ID/messages'
+ '?access_token=' + process.env.PAGE_ACCESS_TOKEN;
const res = await fetch(url, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
recipient: { id: 'PSID' },
messaging_type: 'RESPONSE',
message: { text: 'Thanks, your order ships today.' },
}),
});
const data = await res.json(); // { recipient_id, message_id }
# pip install requests
import requests
resp = requests.post(
"https://graph.facebook.com/v27.0/PAGE_ID/messages",
params={"access_token": "PAGE_ACCESS_TOKEN"},
json={
"recipient": {"id": "PSID"},
"messaging_type": "RESPONSE",
"message": {"text": "Thanks, your order ships today."},
},
)
print(resp.json()) # {"recipient_id": "...", "message_id": "..."}
<?php
$url = 'https://graph.facebook.com/v27.0/PAGE_ID/messages?access_token=PAGE_ACCESS_TOKEN';
$payload = [
'recipient' => ['id' => 'PSID'],
'messaging_type' => 'RESPONSE',
'message' => ['text' => 'Thanks, your order ships today.'],
];
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
]);
$sent = json_decode(curl_exec($ch), true); // recipient_id, message_id
curl_close($ch);
200 OK · { "object": "MessageSent", "message_id": "..." }
200 OK · { "recipient_id": "PAGE-SCOPED-ID", "message_id": "AG5Hz2U..." }
De eerste vier tabbladen roepen Unipile aan voor een gekoppeld account; dezelfde request werkt voor LinkedIn, WhatsApp, Instagram en Telegram. De Meta-tabbladen roepen de Send API van Meta aan voor uw eigen pagina, met een Page access token en de PSID van de persoon (zo krijgt u de PSID). Referenties: Unipile Facebook, Send messages en Meta Send a Message (v27.0, gecontroleerd op 17 november 2026).
Eerste bericht
Een nieuw Messenger-gesprek starten via de API
Bestaat er nog geen chat, roep dan POST /v2/{account_id}/chats/send aan met het ID van de persoon in users_ids en uw text. De Send API van Meta kan dit niet.
Base URL
https://api.unipile.comPOST/v2/{account_id}/chats/sendStart a Chat
users_idsID van een persoon of een pagina
text"Hoi Tom, korte vraag"
attachmentsOptionele bestanden
SDK: startChat (Node.js), start_chat (Python)
200 OK
De response geeft de nieuwe chat_id en de message_id terug.
Staat Facebook het account niet toe deze persoon een bericht te sturen, dan mislukt de request met provider/access_restricted.
Beperkingen van de pagina-inbox
Een pagina kan geen gesprek starten (501 api/not_implemented) en haar berichten niet verwijderen.
Pagina's
Antwoorden als Facebook-pagina via de API
Een pagina die de gebruiker beheert, antwoordt via hetzelfde account_id: toon de inboxen, open de pagina-inbox en verstuur daarna met een chat-ID van de pagina. Hoe pagina's en hun tokens aan de kant van Meta werken, leest u in onze gids over de Facebook Page API.
Tom BeckerDonderdag 10 uur past mij.Persoonlijk
chat_id:
{chat_id}Maya RossBezorgen jullie op zondag?Pagina
chat_id:
PAGE_<page_id>_<thread_key>GET/v2/{account_id}/inboxesToont de pagina-inboxen
GET/v2/{account_id}/inboxes/{inbox_id}/chatsToont de chats van de pagina
POST/v2/{account_id}/chats/PAGE_1357020157484056_100001234567890/messages/sendAntwoordt als de pagina
De algemene chatlijst geeft alleen persoonlijke chats terug. Met het voorvoegsel PAGE_ handelt Unipile als de pagina. Details in de documentatie over Facebook Pages.
Bijlagen
Afbeeldingen en bestanden versturen in een Messenger-chat
Voeg een array attachments toe aan hetzelfde verzendendpoint. Gebruik multipart voor grote bestanden.
POST/v2/{account_id}/chats/{chat_id}/messages/sendSend a Message
textOptioneel bijschrift, mag "" zijn
contentHet bestand gecodeerd in base64
content_type"image/png"
filename"image.png"
Groot bestand: multipart/form-data
200 OK
Versleutelde chats. In end-to-end versleutelde persoonlijke chats wordt elk bestand als apart bericht verstuurd.
Equivalent bij Meta. De Send API accepteert een attachment-object met een type en een url, tot 30 afbeeldingen per verzending.
Realtime
Aflevering bevestigen en antwoorden ontvangen met webhooks
Een 200 betekent dat Facebook het bericht heeft geaccepteerd, niet dat het is afgeleverd. De aflevering wordt bevestigd door het webhook-event message.new, dat ook de antwoorden binnenbrengt.
1POST
Uw app verstuurt
messages/send2Geaccepteerd
Unipile antwoordt
200 MessageSent3Bevestigd
Webhook: verstuurd
message.new4Bevestigingen
Afgeleverd, daarna gelezen
message.receipt.delivery message.receipt.readtype"message.new"
account_idHet gekoppelde account
payloadEen Message-object: id, chat_id, sender_id, text, timestamp, is_sender
Het wordt geactiveerd voor verstuurde en ontvangen berichten; zie is_sender.
Routeer pagina-events op het voorvoegsel PAGE_<page_id>_ van hun chat_id, die kan afwijken van die in de API. Configuratie in Configure a webhook.
Aan de kant van Meta heeft een pagina-bot op de Send API zijn eigen Messenger-webhook nodig. Daar leest u ook de PSID voordat u antwoordt.
Bron: Meta, Messenger webhooks. Laatst gecontroleerd: 17 november 2026.
VerificatieGET met hub.mode=subscribe en uw hub.verify_token: geef hub.challenge terug
HandtekeningX-Hub-Signature-256: SHA256 van de payload met uw App Secret
Veldenmessages, message_deliveries
Antwoord200 OK binnen 5 seconden
Fouten
Fouten bij het versturen van Messenger-berichten
De meeste verzendfouten komen voort uit een regel: een nieuwe poging mislukt opnieuw. Een token zonder pages_messaging blokkeert elke Send API-call.
| Fout | Betekenis | Oplossing |
|---|---|---|
| Meta 100 | Ongeldige parameter, of een tag die op 27 april 2026 is uitgefaseerd | Controleer de PSID, laat de tag weg |
| Meta 10 / 2018278 | Bericht verstuurd buiten het toegestane venster | Wacht op een nieuw bericht, of verstuur een HUMAN_AGENT-antwoord |
| Meta 200 / 2018028 | Kan geen berichten sturen naar mensen die geen beheerder, developer of tester van de app zijn: pages_messaging nog niet goedgekeurd | Rond App Review af, test intussen met app-rollen |
| Meta 551 | Deze persoon ontvangt op dit moment geen berichten van u | Probeer het niet opnieuw |
| Meta 613 | Rate limit overschreden | Verstuur minder vaak |
Unipile provider/access_restricted | Facebook weigert deze ontvanger voor het account | Probeer het niet opnieuw |
Unipile 403 api/insufficient_permissions | Pagina niet geactiveerd op het account | Activeer haar bij het opnieuw koppelen |
Unipile 501 api/not_implemented | Een pagina startte een chat of verwijderde een bericht | Antwoord in een bestaande chat |
Meta 100
BetekenisOngeldige parameter, of een tag die op 27 april 2026 is uitgefaseerd
OplossingControleer de PSID, laat de tag weg
Meta 10 / 2018278
BetekenisBericht verstuurd buiten het toegestane venster
OplossingWacht op een nieuw bericht, of verstuur een
HUMAN_AGENT-antwoordMeta 200 / 2018028
BetekenisKan geen berichten sturen naar mensen die geen beheerder, developer of tester van de app zijn:
pages_messaging nog niet goedgekeurdOplossingRond App Review af, test intussen met app-rollen
Meta 551
BetekenisDeze persoon ontvangt op dit moment geen berichten van u
OplossingProbeer het niet opnieuw
Meta 613
BetekenisRate limit overschreden
OplossingVerstuur minder vaak
Unipile provider/access_restricted
BetekenisFacebook weigert deze ontvanger voor het account
OplossingProbeer het niet opnieuw
Unipile 403 api/insufficient_permissions
BetekenisPagina niet geactiveerd op het account
OplossingActiveer haar bij het opnieuw koppelen
Unipile 501 api/not_implemented
BetekenisEen pagina startte een chat of verwijderde een bericht
OplossingAntwoord in een bestaande chat
Bronnen: Meta, Messenger error codes en Unipile, error responses. Laatst gecontroleerd: 17 november 2026.
Compliance
Elke gebruiker verstuurt vanuit zijn eigen account
Unipile is een onafhankelijk bedrijf, geen officiële Meta-app en geen Meta Partner. Het handelt namens geauthenticeerde gebruikers, die gebonden blijven aan de voorwaarden van Meta. Gebruik het voor klantenservice, CRM en directe gesprekken.
Verstuur uw eerste bericht
De Send API van Meta past bij een bot op uw eigen pagina. Wilt u met de Facebook Messenger API berichten versturen vanuit de eigen accounts van uw gebruikers, koppel die dan via Unipile.
EU-gereguleerd
Digital Markets Act (DMA)
Elke gebruiker koppelt zijn eigen account, zonder opslag van profielen. Unipile is geen Meta Partner. Onze aanpak van de Digital Markets Act
Alle endpoints van de Facebook API op één plek
Berichten zijn daar één onderdeel van. Bekijk elk Facebook-endpoint dat beschikbaar is met Unipile, van posts en opmerkingen tot profielen en webhooks, of lees de volledige Facebook API-gids.
FAQ: berichten versturen met de Facebook Messenger API
Snelle antwoorden over het versturen van Messenger-berichten via een API.
Nee. De Send API bereikt alleen mensen die uw pagina een bericht hebben gestuurd, binnen het berichtenvenster, en een pagina schrijft nooit als eerste. Een nieuw gesprek moet starten vanuit een gekoppeld persoonlijk account, bijvoorbeeld met POST /v2/{account_id}/chats/send van Unipile.
Meta vermeldt geen officiële Python-SDK voor de Send API: doe een POST naar /{PAGE-ID}/messages met requests, zoals in het Meta Python-tabblad hierboven. Unipile biedt een Python-SDK, geïmporteerd als unipile, met get_chats_list en send_message.
Stuur een HTTP POST met cURL of Guzzle: naar /{PAGE-ID}/messages op de Graph API met een Page access token (Meta PHP-tabblad), of naar /v2/{account_id}/chats/{chat_id}/messages/send bij Unipile met uw X-API-KEY (PHP-tabblad).
Installeer @unipile/sdk en roep sendMessage aan met de account_id, chat_id en text, zoals in het Node.js-tabblad hierboven. Voor de Send API van Meta doet u een POST naar /{PAGE-ID}/messages met fetch, zoals in het Meta Node.js-tabblad.
Met de Send API: een gesloten venster (fout 10, subcode 2018278), een tag die op 27 april 2026 is uitgefaseerd (fout 100), een token zonder goedgekeurde pages_messaging (fout 200, subcode 2018028) of iemand die uw berichten blokkeert (fout 551). Met Unipile: provider/access_restricted wanneer Facebook de ontvanger weigert, of een pagina die een gesprek probeert te starten.
Voor een pagina-bot op het platform van Meta beantwoordt uw endpoint de GET-verificatie door hub.challenge terug te geven, controleert het de handtekening X-Hub-Signature-256 met uw App Secret en abonneert het zich op messages; de sender.id van elk event is de PSID waarop u antwoordt. Met Unipile registreert u één URL en ontvangt u message.new-events voor elk gekoppeld account.
Nee. Unipile is een onafhankelijk bedrijf: het is geen Meta Partner en wordt niet onderschreven, gesponsord of goedgekeurd door Meta. De Meta-tabbladen op deze pagina roepen de eigen openbare Send API van Meta aan; de andere tabbladen roepen de API van Unipile aan. Facebook en Messenger zijn handelsmerken van Meta Platforms, Inc.
Nee. De Meta-app, het Page-token en App Review horen alleen bij de route via de Send API. Met Unipile koppelen uw gebruikers hun eigen Facebook-account, of de pagina's die ze beheren, via hosted authentication, en u verstuurt met een account_id en uw API-sleutel.
Unipile is ontworpen in de geest van de Digital Markets Act: elke gebruiker koppelt zijn eigen account en berichten gaan namens hem uit, in zijn eigen gesprekken, zonder dat Unipile gebruikersprofielen opslaat. Details op onze pagina over de Digital Markets Act.
Ja. Elk gekoppeld account blijft gebonden aan de servicevoorwaarden van Meta. Verstuur berichten voor legitieme behoeften zoals supportantwoorden, CRM-opvolging en gesprekken die mensen verwachten; massaal ongevraagde berichten en spam kunnen tot beperking van het account leiden.
Nog vragen? Ons team helpt u graag.
Praat met een expert
