AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Messenger-Gesprächsverlauf über die API auslesen

Der Messenger-Verlauf einer Facebook-Page wird mit GET /{page-id}/conversations?platform=messenger gelesen. Das liefert Konversations-IDs mit dem Zeitpunkt der letzten Aktualisierung. Danach liefert GET /{conversation-id}?fields=messages die Nachrichten-IDs und GET /{message-id} Absender, Empfänger, Text und Anhänge jeder Nachricht. Meta gibt Details zu den 20 neuesten Nachrichten einer Konversation zurück, und die Aufrufe benötigen ein Page-Token mit pages_messaging.

easyCoexistence leitet neue Messenger-Nachrichten einer Page an Ihren Endpoint weiter, sobald sie eintreffen, und send_social_dm antwortet innerhalb des 24-Stunden-Fensters, aus Claude, ChatGPT oder Ihrem eigenen Code.

20 messages

Nur die 20 neuesten Nachrichten einer Konversation liefern Details; ältere geben einen Fehler zurück, dass die Nachricht gelöscht wurde.

2 per second

Conversations-API-Aufrufe, die eine App pro Facebook-Page ausführen darf.

30 days

Konversationen im Anfragen-Ordner, die so lange nicht aktiv waren, fehlen in den API-Ergebnissen.

MESSAGING or MODERATE

Die Page-Aufgabe, die die Person hinter dem Token ausführen können muss, um Konversationen zu lesen.

80006

Fehler bei zu vielen Messenger-API-Aufrufen für ein Page-Konto; Meta empfiehlt, kurz zu warten und es erneut zu versuchen.

Wie listet man die Konversationen einer Page auf?

Mit GET /{page-id}/conversations, wobei platform auf messenger gesetzt wird. Das Ergebnis enthält ein data-Array mit Konversations-IDs, jeweils mit updated_time, dem Zeitpunkt, zu dem die letzte Nachricht hinzugefügt wurde, und einem paging-Objekt. Laut Metas Referenz ist zeitbasiertes Paging bei diesem Endpoint nicht verfügbar. Folgen Sie daher dem paging-Objekt, um durch die Liste zu blättern.

Listing a Page's Messenger conversations
GET /{page-id}/conversations?platform=messenger

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
  ],
  "paging": { ... }
}

Wie findet man die Konversation einer Person?

Fügen Sie derselben Anfrage user_id hinzu, gesetzt auf die Page-spezifische ID der Person (PSID). Meta antwortet mit der ID der Konversation zwischen der Page und dieser Person. Das ist der kürzeste Weg von einem messages-Webhook, bei dem die PSID als sender.id ankommt, zum dahinterliegenden Verlauf:

One person's conversation
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>

{ "data": [ { "id": "<CONVERSATION_ID>" } ] }

Wie liest man die Nachrichten einer Konversation?

In zwei Schritten. GET /{conversation-id} mit fields=messages liefert die Nachrichten-IDs der Konversation, jeweils mit created_time, die neueste zuerst. Danach gibt GET /{message-id} mit den benötigten Feldern, etwa id, created_time, from, to, message und reply_to, den Inhalt einer Nachricht zurück. Die Standardfelder sind id und created_time. Ein Feld ohne Daten wird aus der Antwort weggelassen.

Welche Felder kann man lesen?

Konversationen und Nachrichten stellen unterschiedliche Felder bereit. Dies sind die Felder, die Metas Referenzen für das Page-Messaging auflisten:

  • Konversation: id, updated_time, participants mit ID, Name und E-Mail, messages sowie is_owner, sobald Conversation Routing aktiviert ist.
  • Nachricht: id, created_time, from und to, jeweils mit ID, Name und E-Mail, sowie message, der Text, der leer ist, wenn keiner vorhanden ist.
  • attachments: Dateien, Bilder und Videos mit ihren CDN-URLs sowie is_unsupported, das nur zurückgegeben wird, wenn eine Nachricht nicht unterstützte Inhalte enthält.
  • reactions, reply_to mit der mid, auf die geantwortet wird, und is_self_reply sowie shares für geteilte Beiträge und Reels.
  • tags: Ordner und Quelle der Nachricht, etwa inbox, read oder source:chat.

Wie weit zurück kann man lesen?

So weit die Konversation reicht, wenn es um IDs geht, nicht aber um Inhalte. Metas Leitfaden besagt, dass der Konversations-Endpoint alle Nachrichten-IDs einer Konversation zurückgibt, Details aber nur für die 20 neuesten Nachrichten. Fragt man nach einer älteren, kommt ein Fehler, dass die Nachricht gelöscht wurde. Konversationen im Anfragen-Ordner, die 30 Tage inaktiv waren, werden gar nicht zurückgegeben.

Welche Berechtigungen und Aufgaben werden benötigt?

Ein Page-Zugriffstoken von jemandem, der die Aufgabe MESSAGING oder MODERATE auf der Page ausführen kann, mit den Berechtigungen pages_manage_metadata, pages_read_engagement und pages_messaging. Konversationen mit Personen zu lesen, die keine Rolle in der App, auf der Page oder im Unternehmen haben, erfordert Advanced Access, das Meta über das App Review gewährt.

Welche Limits gelten für die Aufrufe?

Metas Rate Limits erlauben der Conversations API 2 Aufrufe pro Sekunde und Page. Aufrufe über dem Limit kommen mit 613 oder 80006 zurück, mit der Meldung „There have been too many messenger api calls to this Page account“. Eine Page, die Metas Limit für hohes Volumen erreicht, etwa mit mehr als 40 gesendeten Nachrichten pro Sekunde, kann ihre Konversationen erst auflisten, wenn das Volumen sinkt. Eine einzelne Konversation kann trotzdem auf neue Nachrichten hin abgefragt werden.

Wann sollte man die API statt Webhooks nutzen?

Für die Vergangenheit. Webhooks liefern neue Nachrichten, sobald sie eintreffen, und Meta weist darauf hin, dass vergangene Benachrichtigungen später nicht abgefragt werden können. Die Conversations API ist deshalb der Weg, mit dem eine Integration liest, was vor dem Start des Zuhörens kam, oder nach einem Ausfall aufholt. Ist Conversation Routing aktiviert, grenzt das Feld is_owner die Liste auf die Konversationen ein, die die App beantworten soll. Meta empfiehlt dies für die Wiederherstellung nach einem Ausfall.

Wie liest easyCoexistence den Messenger-Verlauf?

Es liest keinen Verlauf. Die Page wird mit den Berechtigungen pages_messaging, pages_manage_metadata und pages_read_engagement verbunden, aber kein Tool ruft die Conversations API auf, und Page-Tokens werden nicht herausgegeben. Neue Nachrichten erreichen Ihren Endpoint über set_social_webhook_destination, sobald sie eintreffen, und werden ohne Kopie weitergeleitet, sodass Ihr eigenes System den Verlauf behält, den es braucht.

Häufige Fehler

  • Nachrichteninhalte im Listenaufruf erwarten. Der Konversations-Endpoint liefert Nachrichten-IDs. Die Felder jeder Nachricht lesen Sie unter /{message-id}.
  • Auf den gesamten Verlauf zählen. Details enden bei den 20 neuesten Nachrichten. Speichern Sie deshalb, was Sie benötigen, aus den Webhooks, sobald die Nachrichten eintreffen.
  • Neue Nachrichten abfragen. Bei 2 Aufrufen pro Sekunde und Page stößt eine Polling-Schleife schnell an das Rate Limit, während der messages-Webhook die Nachrichten liefert, sobald sie eintreffen.
  • Konversationen nach Datum mit since und until paginieren. Zeitbasiertes Paging ist beim Konversations-Endpoint nicht verfügbar. Folgen Sie stattdessen dem paging-Objekt.
Mit EasyCoexistence

Für die Conversations API gibt es kein Tool, ältere Verläufe werden daher im Posteingang der Page gelesen. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, inklusive einer kostenlosen Testphase von 3 Tagen.

Häufig gestellte Fragen

Gehören die eigenen Nachrichten der Page zur Conversations API?

Ja. Die Felder from und to nennen die Person oder die Page, daher enthalten die Nachrichten einer Konversation beide Seiten.

Kann ich Messenger-Konversationen ohne App Review lesen?

Für Personen mit einer Rolle in der App oder auf der Page reicht Standard Access. Konversationen mit allen anderen erfordern Advanced Access, das über das App Review gewährt wird.

Kann die Conversations API Antworten senden?

Nein. Metas Referenz zur Konversation besagt, dass der Edge nicht veröffentlichen kann. Antworten laufen über die Send API unter /{page-id}/messages.

Speichert easyCoexistence meine Messenger-Konversationen?

Nicht standardmäßig. Weitergeleitete Ereignisse werden ohne Kopie weitergegeben; ist eine Automatisierung eingeschaltet, wird der Nachrichtentext 7 Tage und das Laufprotokoll der Automatisierung 30 Tage gespeichert.

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