Instagram-DM-Anhänge im Nachrichten-Webhook
Der Webhook für Nachrichten von Instagram trägt DM-Medien in message.attachments: ein Array aus Objekten, jeweils mit einem type und einer Payload, die meist eine CDN-URL enthält. Metas Liste für Instagram Login nennt image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story und das veraltete share. Einmal ansehbare Medien kommen als ephemeral-Anhang ohne URL an.
easyCoexistence abonniert jedes verbundene Instagram-Konto für messages und leitet DMs mit ihren Anhängen so an Ihren HTTPS-Endpoint weiter, wie Meta sie sendet.
Anhangtyp für einen geteilten Beitrag; seine Payload ergänzt neben url die Felder ig_post_media_id und title, die Bildunterschrift des Beitrags.
Ab wann der alte Anhangtyp share für geteilte Instagram-Beiträge nicht mehr unterstützt wurde.
Anhangtyp für verschwindende, einmal ansehbare Medien, die ohne URL ankommen.
Auf true gesetzt bei einem Nachrichten-Event, wenn die Nachricht nicht unterstützte Medien enthält.
Was eine Benachrichtigung meldet, wenn jemand auf ein Bild eines Karussell-Beitrags reagiert oder es weiterleitet.
Welche Anhangtypen kann ein DM-Event tragen?
Metas Beispiele für Instagram Login nennen diese Werte für message.attachments[].type, jeweils mit einem Payload-Objekt. Die meisten Payloads enthalten eine url zu den Medien im CDN von Meta. Meta dokumentiert zusätzliche Payload-Felder nur für ig_post, deshalb sollte der type vor der Payload gelesen werden.
Wie sieht eine DM mit Anhängen aus?
Ein Nachrichten-Event, dessen message-Objekt Anhänge statt Text enthält oder zusammen mit Text. Metas Beispiel schickt zwei Medien in einer Nachricht, jeweils mit eigenem type und payload.url. Ein Handler muss deshalb über das Array iterieren, statt nur das erste Element zu lesen:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "image", "payload": { "url": "<CDN_URL>" } },
{ "type": "video", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
]
}Wie sieht ein geteilter Beitrag aus?
Ein ig_post-Anhang. Ab dem 3. November 2025 sendete Meta geteilte Beiträge mit einem share- und einem ig_post-Anhang. share wurde für Beiträge bis zum 1. Februar 2026 unterstützt, und laut Meta müssen neue Integrationen ig_post unterstützen. Seine Payload ergänzt die Medien-ID des Beitrags und seine Bildunterschrift als title:
"attachments": [
{
"type": "ig_post",
"payload": {
"ig_post_media_id": "<MEDIA_ID>",
"title": "<POST_CAPTION>",
"url": "<CDN_URL>"
}
}
]Was bedeutet jedes Feld?
Die Anhangfelder, die Meta für ein DM-Event dokumentiert, vom Array abwärts:
- message.attachments[]: ein Objekt pro Medium; Metas Beispiel enthält zwei in einer Nachricht.
- type: was das Element ist, aus der Liste oben. Vor dem Lesen der Payload danach verzweigen.
- payload.url: eine CDN-URL für das Medium. Metas Übersicht nennt diese URLs datenschutzbewusst: Sie liefern nichts mehr, sobald der Inhalt gelöscht wurde oder abgelaufen ist.
- payload.
ig_post_media_idund payload.title: nur beiig_post, die Medien-ID des geteilten Beitrags und seine Bildunterschrift. - message.text: nur vorhanden, wenn die Nachricht auch Text enthält.
- message.
is_unsupported: true, wenn die Nachricht Medien enthält, die der Webhook nicht unterstützt.
Wie lange funktionieren Anhang-URLs?
Meta bindet sie an den Inhalt. Die Übersicht sagt, dass die CDN-URLs von Instagram datenschutzbewusst sind und keine Medien mehr liefern, sobald der Inhalt gelöscht wurde oder abgelaufen ist. Der Leitfaden zu Story-Erwähnungen sagt, dass die URL einer Story nicht mehr angezeigt wird, wenn die Story abläuft oder gelöscht wird. Eine App, die eine Datei braucht, sollte sie beim Eintreffen des Events abrufen, im Rahmen der Regeln von Meta. Story-Medien dürfen unter anderem nicht gespeichert oder zwischengespeichert werden.
Welche Medien lässt der Webhook weg?
Metas Leitfaden zur Instagram-Nachrichtenübermittlung nennt diese Lücken, mit denen ein Handler rechnen sollte, statt sie als Fehler zu behandeln:
- Verschwindende Medien, einmal ansehbar oder mit erlaubter Wiedergabe: ein Anhang vom Typ ephemeral, ohne URL.
- Nicht unterstützte Medien: die Nachricht kommt mit
is_unsupportedauf true an. - GIFs und Sticker: dieser Leitfaden sagt, dass sie keinen Webhook auslösen, während Metas Beispiele für Instagram Login sie unter image aufführen.
- Das gewählte Karussell-Bild: eine Reaktion auf oder Weiterleitung eines Bilds aus einem Karussell-Beitrag meldet das erste Bild.
- Geteilte Beiträge allgemein: Metas Leitfäden zur Nachrichtenübermittlung sagen weiterhin, dass nur die URL geteilter Medien enthalten ist, obwohl
ig_postnun Medien-ID und Bildunterschrift ergänzt.
Wie leitet easyCoexistence Anhänge weiter?
Unverändert, innerhalb von entry: Eine DM mit Medien erreicht Ihren Endpoint mit dem attachments-Array von Meta, so wie Meta es gesendet hat, in einem Umschlag aus platform, account_id, external_id und entry, signiert mit X-EC-Signature. Anhänge werden nicht heruntergeladen, und Ereignisse werden standardmäßig nicht gespeichert: Ein Konto mit eingeschalteter Automatisierung behält den Text einer DM, nicht deren Medien, 7 Tage lang. Rufen Sie die benötigten Medien über payload.url ab, sobald das Ereignis eintrifft, und speichern Sie Story-Medien nicht.
Häufige Fehler
- Nur den ersten Anhang lesen. message.attachments ist ein Array, und Metas Beispiel enthält zwei Elemente in einer Nachricht. Iterieren Sie deshalb darüber.
- Für geteilte Beiträge weiterhin nach dem Typ share suchen. Meta unterstützte ihn für Beiträge bis zum 1. Februar 2026. Lesen Sie stattdessen ig_post, mit Medien-ID und Bildunterschrift in der Payload.
- payload.url für späteres Abrufen speichern. Die URL liefert nichts mehr, sobald der Inhalt gelöscht wird oder abläuft. Laden Sie daher beim Eintreffen herunter, was Sie brauchen, außer Story-Medien.
- payload.url lesen, ohne den Typ zu prüfen. Einmal ansehbare Medien kommen als ephemeral ohne URL an, und nicht unterstützte Medien setzen stattdessen is_unsupported.
Die Weiterleitung ist mit dem Secret des jeweiligen Kontos signiert, und es wird keine Kopie gespeichert, sodass Ihr Agent oder Code die benötigten Medien selbst abruft. send_social_dm antwortet innerhalb des 24-Stunden-Fensters. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit der kostenlosen Testphase von 3 Tagen.
Häufig gestellte Fragen
Kann ich Medien aus einem Instagram-DM-Anhang speichern?
Laden Sie herunter, was Sie brauchen, sobald das Event eintrifft, denn payload.url liefert nichts mehr, sobald der Inhalt gelöscht wird oder abläuft. Story-Medien sind die Ausnahme: Metas Regeln besagen, dass sie nicht gespeichert oder zwischengespeichert werden dürfen.
Warum hat ein Instagram-DM-Webhook keine Medien-URL?
Meist, weil das Medium einmal ansehbar ist. Es kommt dann als ephemeral-Anhang ohne URL an. Oder es ist nicht unterstützt, dann setzt is_unsupported den Wert auf true.
Lösen Instagram-GIFs und Sticker den Nachrichten-Webhook aus?
Metas Dokumentation widerspricht sich: Die Beispiele für Instagram Login führen GIFs und Sticker unter image auf, während der Leitfaden zur Instagram-Nachrichtenübermittlung sagt, dass sie keinen Webhook auslösen. Testen Sie mit einem echten Konto.
Kann ein Instagram-DM-Event mehrere Anhänge enthalten?
Ja. message.attachments ist ein Array, und Metas Beispiel zeigt zwei Medien in einer einzigen Nachricht.
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