Messenger Send API: Nachrichten von einer Facebook-Seite senden
Eine Facebook-Seite sendet Messenger-Nachrichten mit POST /{page-id}/messages und einem Page-Token. Das Feld recipient enthält die seitenbezogene ID der Person (PSID), messaging_type ist RESPONSE oder UPDATE innerhalb des Standard-Messaging-Fensters oder MESSAGE_TAG danach, und message enthält Text oder einen Anhang wie Bild, Audio, Video oder Datei. Meta antwortet mit recipient_id und message_id.
easyCoexistence beantwortet DMs auf Messenger mit send_social_dm aus Claude, ChatGPT oder Ihrem eigenen Code innerhalb des 24-Stunden-Fensters, als Text; Medien, Quick Replies und Templates sind nicht abgedeckt.
Send-API-Aufrufe pro Page, die eine App für Nachrichten mit Text, Links, Reaktionen und Stickern ausführen kann.
Send-API-Aufrufe pro Page, die eine App für Nachrichten mit Audio oder Video ausführen kann.
Größte Datei, die die Messenger Platform zur Wiederverwendung speichert; ein über eine URL hochgeladenes Bild ist auf 8 MB begrenzt.
Höchstzahl an Bildern, die eine Nachricht im Array attachments tragen kann, der einzige dort erlaubte Medientyp.
Wie lange eine gespeicherte attachment_id gültig bleibt, bevor die Medien erneut hochgeladen werden müssen.
Was enthält eine Send-API-Anfrage?
Meta nennt sechs Bestandteile, die ein Versand enthalten muss: die ID der sendenden Page, die ID der empfangenden Person, ein Page-Token dieser Page, die Erlaubnis der Person, den Nachrichtentyp und den Inhalt. Die Anfrage ist ein POST mit JSON an /{page-id}/messages. Eine Antwort an jemanden, der gerade geschrieben hat, sieht so aus:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }Welche ID gehört in recipient?
Meist die seitenbezogene ID (PSID), die Meta einer Person beim ersten Schreiben an die Page zuweist; sie kommt als sender.id im messages-Webhook an. Das Objekt recipient akzeptiert für bestimmte Fälle auch andere ID-Arten:
- id: die PSID, eindeutig für diese Person und diese Page.
user_ref: für jemanden, der ein Plugin oder einen Postback-Button genutzt hat, um die Page anzuschreiben.comment_idoderpost_id: für eine private Antwort auf einen Kommentar oder einen Besucher-Beitrag.- IDs aus Facebook Login sind app-bezogen und funktionieren auf der Messenger Platform nicht.
Welcher messaging_type sollte eine Nachricht verwenden?
Der Typ teilt Meta mit, warum die Nachricht gesendet wird, und bestimmt, wann der Versand erlaubt ist. Metas Referenz zu Page-Nachrichten nennt vier Werte:
- RESPONSE: eine Antwort auf eine Nachricht, die die Page erhalten hat, werblich oder nicht, innerhalb des Standard-Messaging-Fensters.
- UPDATE: eine Nachricht, die die Page von sich aus sendet, werblich oder nicht, ebenfalls innerhalb des Fensters.
MESSAGE_TAG: eine nicht werbliche Nachricht nach dem Fenster, mit einem Tag, das zu einem genehmigten Anwendungsfall passt.- UTILITY: eine Service-Nachricht auf Basis eines genehmigten Templates, etwa ein Update zu Bestellung oder Termin.
Was kann eine Nachricht enthalten?
Text oder ein Anhang-Objekt mit Typ und payload: Bild-, Audio-, Video- und Dateianhänge verweisen auf eine URL oder eine gespeicherte attachment_id, Template-Anhänge enthalten strukturierte Nachrichten mit Buttons. Derselbe Endpoint nimmt außerdem diese Felder entgegen:
- attachments: ein Array mit bis zu 30 Bildern, gesendet als eine Nachricht.
reply_tomit mid: eine Antwort auf eine bestimmte frühere Nachricht, die der Person oder der Page.quick_replies: bis zu 13 Buttons über dem Eingabefeld, jeweils mit einem title von höchstens 20 Zeichen.sender_action: eine Tippanzeige, eine Gelesen-Markierung oder eine Reaktion, in einer eigenen Anfrage getrennt von der Nachricht.notification_type: standardmäßig REGULAR, oderSILENT_PUSHbzw.NO_PUSH.
Wie groß dürfen Anhänge sein?
Metas Anleitung zum Speichern von Assets setzt die Grenzen für Medien, die die Messenger Platform abruft und behält: Assets bis 25 MB, Bilder bis 8 MB beim Hochladen über eine URL, Audio mit einem Audio-Content-Type und Videos, die innerhalb von 75 Sekunden abgerufen werden. Wird is_reusable auf true gesetzt, liefert die Anfrage eine attachment_id, die nur die sendende Page 90 Tage lang wiederverwenden kann. POST /{page-id}/message_attachments lädt Medien im Voraus hoch.
Wie lauten die Ratenlimits der Send API?
Meta zählt sie pro Page und nach Inhalt. Die Referenz zu Page-Nachrichten führt unter den Versandfehlern den Fehlercode 613 auf: Calls to this api have exceeded the rate limit. Erscheint dieser Fehler, sollten Sie die Frequenz senken, statt sofort erneut zu senden:
- 300 Aufrufe pro Sekunde und Page für Nachrichten mit Text, Links, Reaktionen und Stickern.
- 10 Aufrufe pro Sekunde und Page für Nachrichten mit Audio oder Video.
- Zu viele Nachrichten an einen einzelnen Thread können auch für sich allein gedrosselt werden.
- Messenger-API-Aufrufe insgesamt: das 200-Fache der Anzahl aktiver Nutzer in einem rollierenden Zeitraum von 24 Stunden.
- Ab 40 Nachrichten pro Sekunde zeigt der Posteingang der Page keine neuen Nachrichten mehr an, und die Page kann erst wieder senden, wenn das Volumen sinkt.
Welche Fehler gibt die Send API zurück?
Metas Fehlertabelle für den Messenger ordnet jedem Code einen Subcode zu, der die Ursache benennt. Dies sind die Fehler, auf die eine Page beim Senden am häufigsten trifft:
- 10 mit 2018278 oder 2534022: Die Nachricht wurde außerhalb des zulässigen Fensters gesendet.
- 10 mit 2018300: Eine andere App steuert die Unterhaltung.
- 100: ungültiger Parameter, etwa eine falsche Empfänger-ID; Subcode 2018001 lautet „No matching user found“.
- 551: Die Person ist nicht erreichbar, etwa weil sie die Page blockiert oder ihr Konto deaktiviert hat; 200 mit 1545041 lautet „This person isn't available right now“.
- 200 mit 2018028: Die App kann keine Personen außerhalb ihrer Rollen anschreiben, bis
pages_messaginggeprüft und die App live ist. - 10904: Die Page hat Nachrichten in den Einstellungen deaktiviert.
Wie sendet easyCoexistence darüber?
send_social_dm nimmt account_id, die recipient_id der Person, also sender.id in einem weitergeleiteten messages-Ereignis, sowie den Text entgegen und sendet sie an /{page-id}/messages mit messaging_type RESPONSE. Das Ergebnis ist Metas Antwort mit message_id; ein abgelehnter Versand kommt mit Metas Fehlercode und Meldung zurück. Medien, Quick Replies, Templates und Sender-Aktionen gehören nicht zu den Tools: send_social_dm sendet Text.
Häufige Fehler
- Eine Tippanzeige zusammen mit der Nachricht senden. Meta verlangt sender_action allein mit dem Empfänger, Text oder Templates in einer separaten Anfrage.
- Eine Salve an eine Person schicken. Meta kann einen einzelnen Thread unabhängig von den 300 Aufrufen pro Sekunde der Page drosseln.
- Audio oder Video mit der Textrate senden. Nachrichten mit Audio oder Video sind auf 10 Aufrufe pro Sekunde und Page begrenzt.
- Eine attachment_id wiederverwenden, die älter als 90 Tage ist. Gespeicherte attachment-IDs laufen ab, daher müssen die Medien für eine neue ID erneut hochgeladen werden.
Automatisierungen antworten auf neue Nachrichten selbstständig, mit einem festen Text oder einer KI-Antwort. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.
Häufig gestellte Fragen
Ist die Messenger Send API kostenlos?
Ja, für Standardnachrichten. Metas Überblick nennt die Messenger Platform kostenlos nutzbar, sodass eine Page, die auf Personen antwortet, die ihr geschrieben haben, pro Nachricht nichts zahlt; Marketing-Nachrichten werden pro Nachricht berechnet.
Welche Page-Aufgabe braucht der Versand einer Nachricht?
Metas Messenger-Überblick verlangt ein Page-Token von jemandem, der die Aufgaben MESSAGING und MODERATE ausführen kann, mit erteilter Berechtigung pages_messaging.
Kann easyCoexistence auf Messenger mit Bildern antworten?
Heute nicht. send_social_dm sendet Text, und kein Tool sendet einen Anhang.
Was kostet easyCoexistence für eine Facebook-Seite?
Jede verbundene Page ist eine Verbindung und kostet je nach Anzahl US$ 9 bis US$ 0.75 pro Verbindung und Monat. Die ersten 3 Tage sind kostenlos.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am