AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Instagram-DM-Verlauf lesen: die Conversations API

Die Instagram Conversations API liest den DM-Verlauf eines professionellen Kontos über graph.instagram.com. GET /me/conversations?platform=instagram listet die Gespräche mit ihrem updated_time, GET /<CONVERSATION_ID>?fields=messages listet die Nachrichten eines Gesprächs nach ID und Zeitpunkt, und GET /<MESSAGE_ID>?fields=id,created_time,from,to,message liefert eine einzelne Nachricht. Details sind für die 20 neuesten Nachrichten jedes Gesprächs verfügbar.

easyCoexistence leitet neue Instagram-DMs bei Eingang an Ihren Endpoint weiter und antwortet mit send_social_dm innerhalb des 24-Stunden-Fensters, aus Claude, ChatGPT oder Ihrem eigenen Code, über Metas offizielle API; für den Verlauf der Conversations API hat es kein Tool.

20

Die neuesten Nachrichten pro Gespräch, deren Details die API zurückgibt; ältere antworten mit einem Fehler, dass sie gelöscht wurden.

30 days

Inaktivität, nach der Gespräche im Ordner Anfragen nicht mehr zurückgegeben werden.

2/sec

Anzahl der Conversations-API-Aufrufe pro Sekunde, die eine App für jedes professionelle Instagram-Konto ausführen kann.

2 permissions

instagram_business_basic und instagram_business_manage_messages, mit einem Token von jemandem, der die Nachrichten des Kontos verwalten darf.

Wie listet man die Gespräche eines Kontos auf?

Mit GET /me/conversations oder /<IG_ID>/conversations und platform=instagram, mit einem Instagram-User-Access-Token von jemandem, der Nachrichten auf dem Konto verwalten darf. Jeder Eintrag im data-Array ist ein Gespräch mit seiner id und seinem updated_time.

Listing conversations
GET https://graph.instagram.com/me/conversations
  ?platform=instagram
  &access_token=<ACCESS_TOKEN>

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
  ]
}

Wie findet man das Gespräch mit einer bestimmten Person?

Man ergänzt user_id um die Instagram-scoped ID der Person, also die IGSID, die als sender.id ankommt, wenn sie dem Konto schreibt. Die Antwort liefert die id dieses Gesprächs. So wird ein Webhook-Ereignis in seinen Thread überführt, ohne die gesamte Liste zu durchblättern.

One person's conversation
GET https://graph.instagram.com/me/conversations
  ?user_id=<IGSID>
  &access_token=<ACCESS_TOKEN>

Wie liest man die Nachrichten?

In zwei Schritten. GET /<CONVERSATION_ID>?fields=messages listet die Nachrichten des Gesprächs mit id und created_time, den Standardfeldern. GET /<MESSAGE_ID> mit fields=id,created_time,from,to,message liefert dann eine einzelne Nachricht: wer sie gesendet hat und an wen, jeweils mit username und ID, sowie ihren Text.

A conversation's messages, then one message
GET https://graph.instagram.com/<CONVERSATION_ID>
  ?fields=messages
  &access_token=<ACCESS_TOKEN>

GET https://graph.instagram.com/<MESSAGE_ID>
  ?fields=id,created_time,from,to,message
  &access_token=<ACCESS_TOKEN>

Wie weit zurück kann man lesen?

Metas Leitfaden und Überblick legen vier Grenzen fest für das, was zurückkommt:

  • Nachrichtendetails: die 20 neuesten Nachrichten jedes Gesprächs; eine ältere Nachricht anzufordern liefert einen Fehler, dass sie gelöscht wurde.
  • Anfragen: Gespräche im Ordner Anfragen ohne Aktivität seit 30 Tagen werden nicht zurückgegeben.
  • Geteilte Inhalte: ein geteilter Beitrag oder Reel kommt nur als Bild- oder Video-URL zurück.
  • Rate: 2 Aufrufe pro Sekunde für jedes professionelle Instagram-Konto.

Was wird dafür benötigt?

Bei Instagram Login die Berechtigungen instagram_business_basic und instagram_business_manage_messages sowie ein Token von jemandem, der Nachrichten auf dem Konto verwalten darf. Standard Access genügt für Konten, die Ihnen gehören oder die Sie verwalten und der App hinzugefügt haben; für Konten anderer Inhaber ist Advanced Access nötig. Außerdem muss in den Instagram-App-Einstellungen des Kontos die Option Zugriff auf Nachrichten erlauben aktiviert sein.

Warum sollte man Webhooks zur Aufzeichnung nutzen?

Da die API nur die letzten 20 Nachrichten jedes Gesprächs mit Details zurückgibt, muss ein vollständiger Verlauf fortlaufend gespeichert werden. Der messages-Webhook liefert DMs bei Eingang, mit der IGSID der Person als sender.id. Vom Konto gesendete Nachrichten kommen ebenfalls an, mit vertauschten IDs, sodass beide Seiten eines Gesprächs erfasst werden können.

Wie liest man den DM-Verlauf über easyCoexistence?

Es leitet DMs weiter, statt den Verlauf zu lesen. Neue DMs erreichen Ihren Endpoint bei Eingang, sobald Sie einen mit set_social_webhook_destination festlegen; sie werden ohne Kopie weitergeleitet. send_social_dm antwortet innerhalb des 24-Stunden-Fensters, aus Claude, ChatGPT oder Ihrem eigenen Code. Kein Tool ruft me/conversations auf, daher werden frühere Nachrichten in der Instagram-App gelesen oder von Ihrem eigenen System bei Eingang aufbewahrt.

Häufige Fehler

  • Die vollständige Historie von der API erwarten. Details enden bei den 20 neuesten Nachrichten, daher DMs aus dem messages-Webhook bei Eingang speichern.
  • Gespräche nach neuen DMs abfragen. Die API erlaubt 2 Aufrufe pro Sekunde und Konto, während der messages-Webhook jede DM bei Eingang liefert.
  • Nach einer alten Nachrichtenanfrage suchen. Gespräche in Anfragen mit 30 Tagen Inaktivität werden nicht mehr zurückgegeben.
  • Die Fehlermeldung deleted als Löschung durch die Person deuten. Meta antwortet so für jede Nachricht, die älter als die letzten 20 ist.
Mit EasyCoexistence

US$ 9 bis US$ 0,75 pro Verbindung und Monat, sinkend mit weiteren Verbindungen, die ersten 3 Tage kostenlos.

Häufig gestellte Fragen

Kann ich den vollständigen DM-Verlauf eines Instagram-Kontos exportieren?

Nicht vollständig über die API: Sie listet die Gespräche, liefert aber Details nur zu den 20 neuesten Nachrichten jedes Gesprächs. Ein vollständiges Archiv entsteht, wenn Sie DMs speichern, sobald der Webhook sie liefert.

Markiert das Lesen von Nachrichten über die API sie als gelesen?

Nein. Meta erklärt, dass über die API zugestellte Nachrichten in der Instagram-App erst als gelesen markiert werden, wenn eine Antwort gesendet wird.

Funktioniert die Conversations API mit Instagram Login?

Ja. Metas Leitfaden dafür ist auf Instagram Login ausgelegt, mit Aufrufen an graph.instagram.com und den Berechtigungen instagram_business_*.

Wie erhalte ich den Benutzernamen einer Person aus einem Gespräch?

Fragen Sie from bei einer Nachricht an; das liefert Benutzernamen und ID des Absenders. Die User Profile API liefert mehr, etwa den Namen, anhand der IGSID, sobald die Person dem Konto geschrieben hat.

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