
Integrationsleitfäden
LinkedIn-API-Leitfaden
E-Mail-API-Leitfaden
WhatsApp-API-Leitfaden
Vertrieb kontaktieren
Die Regeln der Send API von Meta im Jahr 2026, dann ein einziger REST-Aufruf, um aus den eigenen Konten Ihrer Nutzer zu senden.
chats
POSTmessages/send
POSTchats/send
200 OK
Es gibt zwei Wege, eine Facebook-Messenger-Nachricht per API zu senden. Die Send API von Meta sendet von einer Facebook-Seite aus, mit einem Page Access Token, und nur an Personen, die der Seite in den letzten 24 Stunden geschrieben haben. Eine Unified API wie Unipile sendet aus dem verbundenen Konto Ihres Nutzers (einem privaten Konto oder einer von ihm verwalteten Seite) mit einem einzigen REST-Aufruf: POST /v2/{account_id}/chats/{chat_id}/messages/send.
Eine Messenger-Nachricht in drei Schritten senden
Verbinden. Ihr Nutzer verbindet sein Facebook-Konto oder seine Seite über Hosted Auth. Keine Meta-App, kein App Review.
Senden. Rufen Sie POST /v2/{account_id}/chats/{chat_id}/messages/send mit Ihrem X-API-KEY und einem Feld text auf.
Empfangen. Der Webhook message.new bestätigt den Versand und liefert die Antworten.
Code in vier Sprachen: aus einem verbundenen Konto senden. Referenz: Unipile V2 Doku zum Senden von Nachrichten.
Jetzt bauenDie Send API von Meta handelt für eine Seite, die Ihre App verwaltet. Unipile handelt für das Konto, das Ihr Endnutzer verbunden hat.
| Kriterium | Meta Send API | Unipile API |
|---|---|---|
| Absender | Eine Facebook-Seite | Das private Konto des Nutzers oder eine von ihm verwaltete Seite |
| Einrichtung | Meta-App, Page Token mit pages_messaging, App Review, um Seiten anderer Unternehmen zu bedienen | API-Schlüssel und eine account_id aus Hosted Auth, keine Meta-App |
| Wer schreibt zuerst | Immer die Person | Ein privates Konto kann es; eine Seite antwortet nur |
| Fenster | 24 Stunden, bis zu 7 Tage nach einer Click-to-Messenger-Anzeige | Kein Fenster der Send API; Facebook kann einen Empfänger ablehnen |
pages_messaging, App Review, um Seiten anderer Unternehmen zu bedienenaccount_id aus Hosted Auth, keine Meta-AppEin Bot für Ihre eigene Seite passt zum Weg über Meta; ein CRM, Helpdesk oder KI-Agent in den Unterhaltungen Ihrer Kunden braucht ein verbundenes Konto. Für den vollständigen Überblick lesen Sie, wie die Facebook-APIs zusammenspielen.
Der offizielle Weg von Meta ist die Send API der Messenger Platform: POST https://graph.facebook.com/v27.0/{PAGE-ID}/messages mit einem Page Access Token mit pages_messaging, einer recipient.id, einem messaging_type und einem message-Objekt. Sie antwortet nur Personen, die Ihrer Seite geschrieben haben.
Messenger hinzufügen, die Seite verbinden.
Mit pages_messaging; App Review, um andere Unternehmen zu bedienen. Siehe unseren Leitfaden zum Facebook API Zugriffstoken.
Die Person über ihre PSID (seitenbezogene ID) adressieren, die aus dem Webhook messages stammt.
graph.facebook.com/v27.0/{PAGE-ID}/messages
200 OK
RESPONSE: eine Antwort, innerhalb des Fensters.UPDATE: eine Nachricht, die Sie selbst initiieren, innerhalb des Fensters.MESSAGE_TAG: außerhalb des Fensters, mit einem Tag und ohne werbliche Inhalte.Woher die PSID kommt
Im Event messages ist sender.id die PSID der Person und recipient.id die ID Ihrer Seite. Die Anfrage finden Sie in den Tabs Meta cURL, Node.js, Python und PHP des Codeblocks weiter unten.
Quellen: Metas Dokumentation Send a Message und Webhook-Event messages. Zuletzt geprüft: 17. November 2026.
Die Send API schreibt nur Personen, die der Seite geschrieben haben, und zwar 24 Stunden lang nach ihrer letzten Nachricht oder bis zu 7 Tage nach einer Click-to-Messenger-Anzeige. Danach deckt HUMAN_AGENT eine menschliche Antwort innerhalb von 7 Tagen ab, und drei Update-Tags schlagen seit dem 27. April 2026 mit Fehler 100 fehl.
Das öffnet das Standardfenster.
Senden mit RESPONSE oder UPDATE.
Tag HUMAN_AGENT, für eine von einer Person geschriebene Antwort.
Auf eine neue Nachricht warten.
Anfragen mit den Tags CONFIRMED_EVENT_UPDATE, ACCOUNT_UPDATE oder POST_PURCHASE_UPDATE schlagen jetzt mit Fehlercode 100 fehl.
Quellen: Metas Referenz zur Send API und Send a Message. Zuletzt geprüft: November 2026.
Ihr Nutzer verbindet sein Facebook-Konto einmalig, und Sie erhalten eine account_id. Listen Sie seine Chats auf und senden Sie dann in einer chat_id. Anfragen gehen an https://api.unipile.com, mit Ihrem Schlüssel im Header X-API-KEY, über die Facebook Messenger API von Unipile. Die Meta-Tabs senden dieselbe Antwort mit Metas Send API, von einer Seite, die Sie verwalten.
Der Nutzer meldet sich auf einer Hosted-Auth-Seite an. Details in unserem Leitfaden zur Messenger API für private Konten.
GET /v2/{account_id}/chats liefert bis zu 100 Chats pro Seite.
Ein POST mit einem Feld 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);
Die ersten vier Tabs rufen Unipile für ein verbundenes Konto auf; dieselbe Anfrage funktioniert für LinkedIn, WhatsApp, Instagram und Telegram. Die Meta-Tabs rufen Metas Send API für Ihre eigene Seite auf, mit einem Page Access Token und der PSID der Person (so erhalten Sie die PSID). Referenzen: Unipile Facebook, Send messages und Meta Send a Message (v27.0, geprüft am 17. November 2026).
Wenn es noch keinen Chat gibt, rufen Sie POST /v2/{account_id}/chats/send mit der ID der Person in users_ids und Ihrem text auf. Die Send API von Meta kann das nicht.
https://api.unipile.comSDK: startChat (Node.js), start_chat (Python)
200 OK
Die Antwort enthält die neue chat_id und die message_id.
Erlaubt Facebook dem Konto nicht, dieser Person zu schreiben, schlägt die Anfrage mit provider/access_restricted fehl.
Eine Seite kann keine Unterhaltung beginnen (501 api/not_implemented) und ihre Nachrichten nicht löschen.
Eine Seite, die der Nutzer verwaltet, antwortet über dieselbe account_id: Postfächer auflisten, das Seitenpostfach öffnen und dann mit einer Chat-ID der Seite senden. Wie Seiten und ihre Tokens bei Meta funktionieren, erklärt unser Leitfaden zur Facebook Page API.
{chat_id}PAGE_<page_id>_<thread_key>Die allgemeine Chatliste liefert nur persönliche Chats. Das Präfix PAGE_ lässt Unipile als Seite handeln. Details in der Dokumentation zu Facebook-Seiten.
Fügen Sie demselben Sende-Endpoint ein Array attachments hinzu. Für große Dateien nutzen Sie multipart.
Große Datei: multipart/form-data
200 OK
Verschlüsselte Chats. In Ende-zu-Ende-verschlüsselten persönlichen Chats wird jede Datei als eigene Nachricht gesendet.
Entsprechung bei Meta. Die Send API nimmt ein attachment-Objekt mit einem type und einer url entgegen, mit bis zu 30 Bildern pro Sendung.
Ein 200 bedeutet, dass Facebook die Nachricht angenommen hat, nicht dass sie zugestellt wurde. Die Zustellung bestätigt das Webhook-Ereignis message.new, das auch die Antworten liefert.
Es wird für gesendete und empfangene Nachrichten ausgelöst; siehe is_sender.
Ordnen Sie Ereignisse von Seiten über das Präfix PAGE_<page_id>_ ihrer chat_id zu, die von der in der API abweichen kann. Einrichtung unter Configure a webhook.
Auf Metas Seite braucht ein Seiten-Bot, der auf der Send API aufbaut, einen eigenen Messenger-Webhook. Dort lesen Sie auch die PSID, bevor Sie antworten.
Quelle: Metas Messenger webhooks. Zuletzt geprüft: 17. November 2026.
Die meisten Sendefehler gehen auf eine Regel zurück: Ein erneuter Versuch scheitert wieder. Ein Token ohne pages_messaging blockiert jeden Aufruf der Send API.
| Fehler | Bedeutung | Lösung |
|---|---|---|
| Meta 100 | Ungültiger Parameter oder ein am 27. April 2026 eingestellter Tag | PSID prüfen, Tag entfernen |
| Meta 10 / 2018278 | Nachricht außerhalb des erlaubten Fensters gesendet | Auf eine neue Nachricht warten oder eine HUMAN_AGENT-Antwort senden |
| Meta 200 / 2018028 | Personen, die keine Admins, Entwickler oder Tester der App sind, können nicht angeschrieben werden: pages_messaging noch nicht freigegeben | App Review abschließen, bis dahin mit App-Rollen testen |
| Meta 551 | Diese Person empfängt gerade keine Nachrichten von Ihnen | Nicht erneut versuchen |
| Meta 613 | Rate Limit überschritten | Seltener senden |
Unipile provider/access_restricted | Facebook lehnt diesen Empfänger für das Konto ab | Nicht erneut versuchen |
Unipile 403 api/insufficient_permissions | Seite auf dem Konto nicht aktiviert | Bei der erneuten Verbindung aktivieren |
Unipile 501 api/not_implemented | Eine Seite hat einen Chat begonnen oder eine Nachricht gelöscht | In einem bestehenden Chat antworten |
HUMAN_AGENT-Antwort sendenpages_messaging noch nicht freigegebenQuellen: Metas Fehlercodes des Messengers und die Fehlerantworten von Unipile. Zuletzt geprüft: 17. November 2026.
Jeder Nutzer sendet aus seinem eigenen Konto
Unipile ist ein unabhängiges Unternehmen, keine offizielle Meta-App und kein Meta-Partner. Unipile handelt im Auftrag authentifizierter Nutzer, die an die Bedingungen von Meta gebunden bleiben. Nutzen Sie es für Kundensupport, CRM und direkte Unterhaltungen.
Senden Sie Ihre erste Nachricht
Die Send API von Meta eignet sich für einen Bot auf Ihrer eigenen Seite. Um mit der Facebook Messenger API Nachrichten aus den eigenen Konten Ihrer Nutzer zu senden, verbinden Sie diese über Unipile.
Jeder Nutzer verbindet sein eigenes Konto, ohne Speicherung von Profilen. Unipile ist kein Meta-Partner. Unser Ansatz zum Digital Markets Act
Alle Endpoints der Facebook-API an einem Ort
Nachrichten sind nur ein Teil davon. Sehen Sie alle mit Unipile verfügbaren Facebook-Endpoints, von Beiträgen und Kommentaren bis zu Profilen und Webhooks, oder lesen Sie den vollständigen Leitfaden zur Facebook-API.
Kurze Antworten zum Senden von Messenger-Nachrichten per API.
Nein. Die Send API erreicht nur Personen, die Ihrer Seite geschrieben haben, innerhalb des Messaging-Fensters, und eine Seite schreibt nie zuerst. Eine neue Unterhaltung muss von einem verbundenen privaten Konto ausgehen, zum Beispiel mit POST /v2/{account_id}/chats/send von Unipile.
Meta führt kein offizielles Python-SDK für die Send API: Senden Sie einen POST an /{PAGE-ID}/messages mit requests, wie im Meta-Python-Tab oben. Unipile bietet ein Python-SDK, importiert als unipile, mit get_chats_list und send_message.
Senden Sie einen HTTP-POST mit cURL oder Guzzle: an /{PAGE-ID}/messages in der Graph API mit einem Page Access Token (Meta-PHP-Tab) oder an /v2/{account_id}/chats/{chat_id}/messages/send bei Unipile mit Ihrem X-API-KEY (PHP-Tab).
Installieren Sie @unipile/sdk und rufen Sie sendMessage mit account_id, chat_id und text auf, wie im Node.js-Tab oben. Für die Send API von Meta senden Sie einen POST an /{PAGE-ID}/messages mit fetch, wie im Meta-Node.js-Tab.
Bei der Send API: ein geschlossenes Fenster (Fehler 10, Subcode 2018278), ein am 27. April 2026 eingestellter Tag (Fehler 100), ein Token ohne freigegebenes pages_messaging (Fehler 200, Subcode 2018028) oder eine Person, die Ihre Nachrichten blockiert (Fehler 551). Bei Unipile: provider/access_restricted, wenn Facebook den Empfänger ablehnt, oder eine Seite, die eine Unterhaltung beginnen will.
Für einen Seiten-Bot auf Metas Plattform beantwortet Ihr Endpoint die GET-Verifizierung, indem er hub.challenge zurückgibt, prüft die Signatur X-Hub-Signature-256 mit Ihrem App Secret und abonniert messages; die sender.id jedes Events ist die PSID, an die Sie antworten. Mit Unipile registrieren Sie eine einzige URL und erhalten message.new-Events für jedes verbundene Konto.
Nein. Unipile ist ein unabhängiges Unternehmen: Es ist kein Meta Partner und wird von Meta weder unterstützt noch gesponsert oder genehmigt. Die Meta-Tabs auf dieser Seite rufen Metas eigene öffentliche Send API auf, die anderen Tabs die API von Unipile. Facebook und Messenger sind Marken von Meta Platforms, Inc.
Nein. Meta-App, Page Token und App Review gehören nur zum Weg über die Send API. Mit Unipile verbinden Ihre Nutzer ihr eigenes Facebook-Konto oder die Seiten, die sie verwalten, über die gehostete Authentifizierung, und Sie senden mit einer account_id und Ihrem API-Schlüssel.
Unipile ist im Sinne des Digital Markets Act konzipiert: Jeder Nutzer verbindet sein eigenes Konto, und Nachrichten gehen in seinem Namen in seinen eigenen Unterhaltungen hinaus, ohne dass Unipile Nutzerprofile speichert. Details auf unserer Seite zum Digital Markets Act.
Ja. Jedes verbundene Konto bleibt an die Nutzungsbedingungen von Meta gebunden. Senden Sie Nachrichten für legitime Zwecke wie Support-Antworten, CRM-Follow-ups und Unterhaltungen, die Personen erwarten; unaufgeforderte Massennachrichten und Spam können zur Einschränkung des Kontos führen.
Noch Fragen? Unser Team hilft Ihnen gern.
Mit einem Experten sprechen