InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Instagram-DM-bijlagen in de berichten-webhook

De messages-webhook van Instagram levert DM-media aan via message.attachments: een array van objecten, elk met een type en een payload die meestal een CDN-url bevat. Metas lijst voor Instagram Login noemt image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story en het verouderde share. Media die eenmalig te bekijken is, komt aan als een ephemeral bijlage zonder url.

easyCoexistence abonneert elk verbonden Instagram-account op messages en stuurt DM's met hun bijlagen zoals Meta ze verstuurt door naar je HTTPS-endpoint, ondertekend met het geheim van dat account en zonder kopie te bewaren, zodat je agent of code de media ophaalt die het nodig heeft.

ig_post

Bijlagetype voor een gedeelde post; de payload voegt naast url ig_post_media_id en title toe, het bijschrift van de post.

1 Feb 2026

Wanneer het oude bijlagetype share voor gedeelde Instagram-posts niet meer werd ondersteund.

ephemeral

Bijlagetype voor verdwijnende media die eenmalig bekeken kan worden; komt zonder url aan.

is_unsupported

Op true gezet in een message-event wanneer het bericht niet-ondersteunde media bevat.

First image

Wat een melding rapporteert wanneer iemand reageert op of doorstuurt naar één afbeelding uit een carrouselpost.

Welke bijlagetypen kan een DM-event bevatten?

De voorbeelden van Meta voor Instagram Login noemen deze waarden voor message.attachments[].type, elk met een payload-object. De meeste payloads bevatten een url naar de media op de CDN van Meta, en Meta documenteert extra payloadvelden alleen voor ig_post, dus lees eerst het type en daarna de payload.

imageA photo. Meta's Instagram Login list also puts GIFs and stickers under this type.
videoA video, at payload.url.
audioAudio, at payload.url.
fileA file, at payload.url.
ig_postA shared post: url, ig_post_media_id and title, its caption.
ig_reel and reelA shared Reel; Meta lists both names, each with a url.
story_mentionA Story that mentions the account, at its CDN URL.
shareThe legacy post share, supported until 1 February 2026.
media, story, ig_storyAlso in Meta's list, with no payload described.
ephemeralView-once media, sent with no URL.

Hoe ziet een DM met bijlagen eruit?

Een messages-event waarin het message-object bijlagen bevat in plaats van tekst, of naast tekst. Het voorbeeld van Meta stuurt twee mediaitems in één bericht, elk met een eigen type en payload.url, dus een handler moet over de array lopen in plaats van alleen het eerste element te lezen:

A DM with two attachments, as Meta sends it
{
  "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>" } }
            ]
          }
        }
      ]
    }
  ]
}

Hoe ziet een gedeelde post eruit?

Een ig_post-bijlage. Vanaf 3 november 2025 stuurde Meta gedeelde posts met zowel een share- als een ig_post-bijlage; share werd voor posts ondersteund tot 1 februari 2026, en Meta zegt dat nieuwe integraties ig_post moeten ondersteunen. De payload voegt het media-ID van de post toe en het bijschrift als title:

The attachment of a shared post
"attachments": [
  {
    "type": "ig_post",
    "payload": {
      "ig_post_media_id": "<MEDIA_ID>",
      "title": "<POST_CAPTION>",
      "url": "<CDN_URL>"
    }
  }
]

Wat betekent elk veld?

De bijlagevelden die Meta voor een DM-event documenteert, van de array naar beneden:

  • message.attachments[]: één object per mediaitem; het voorbeeld van Meta bevat er twee in één bericht.
  • type: wat het item is, uit de lijst hierboven. Vertak op het type voordat je de payload leest.
  • payload.url: een CDN-url voor de media. Het overzicht van Meta noemt deze url's privacybewust: ze leveren niets meer op zodra de inhoud is verwijderd of verlopen.
  • payload.ig_post_media_id en payload.title: alleen bij ig_post, het media-ID van de gedeelde post en het bijschrift.
  • message.text: alleen aanwezig wanneer het bericht ook tekst bevat.
  • message.is_unsupported: true wanneer het bericht media bevat die de webhook niet ondersteunt.

Hoe lang werken bijlage-url's?

Meta koppelt ze aan de inhoud. Het overzicht zegt dat CDN-url's van Instagram privacybewust zijn en geen media meer teruggeven zodra de inhoud is verwijderd of verlopen. De gids over story-vermeldingen zegt dat de url van een Story niet meer werkt wanneer de Story verloopt of wordt verwijderd. Een app die een bestand nodig heeft, haalt het op wanneer het event binnenkomt, binnen de regels van Meta: Story-media mag bijvoorbeeld niet worden opgeslagen of gecachet.

Welke media laat de webhook weg?

De gids voor Instagram-berichten van Meta noemt deze hiaten, die een handler moet verwachten en niet als fouten moet behandelen:

  • Verdwijnende media, eenmaal bekijken of opnieuw afspelen toestaan: een bijlage van het type ephemeral, zonder url.
  • Niet-ondersteunde media: het bericht komt binnen met is_unsupported op true.
  • GIF's en stickers: die gids zegt dat ze geen webhook activeren, terwijl de voorbeelden van Meta voor Instagram Login ze onder image noemen.
  • De gekozen afbeelding uit een carrousel: een reactie op of doorgestuurd bericht van één afbeelding in een carrouselpost meldt de eerste afbeelding.
  • Shares in het algemeen: de berichtengidsen van Meta zeggen nog dat alleen de url van gedeelde media wordt meegestuurd, hoewel ig_post nu het media-ID en het bijschrift toevoegt.

Hoe stuurt easyCoexistence bijlagen door?

Ongewijzigd, binnen de entry: een DM met media bereikt je endpoint met de attachments-array van Meta zoals Meta die heeft verstuurd, in een envelope van platform, account_id, external_id en entry, ondertekend met X-EC-Signature. Bijlagen worden niet gedownload, en events worden standaard niet opgeslagen: een account met een automatisering aan houdt de tekst van een DM 7 dagen bij, niet de media. Haal de media die je nodig hebt op via payload.url wanneer het event binnenkomt, en sla Story-media niet op.

Veelgemaakte fouten

  • Alleen de eerste bijlage lezen. message.attachments is een array en het voorbeeld van Meta bevat twee items in één bericht, dus loop erover.
  • Nog steeds matchen op type share voor gedeelde posts. Meta ondersteunde dat voor posts tot 1 februari 2026; lees ig_post, met het media-ID en het bijschrift in de payload.
  • payload.url opslaan om later op te halen. De url levert niets meer op zodra de inhoud is verwijderd of verlopen, dus download wat je nodig hebt bij aankomst, behalve Story-media.
  • payload.url lezen zonder het type te controleren. Eenmaal te bekijken media komt aan als ephemeral zonder url, en niet-ondersteunde media zet is_unsupported op true.
Dit doen met EasyCoexistence

send_social_dm antwoordt binnen het venster van 24 uur. US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen als gratis proefperiode.

Veelgestelde vragen

Kan ik media uit een Instagram-DM-bijlage opslaan?

Download wat je nodig hebt wanneer het event binnenkomt, want payload.url levert niets meer op zodra de inhoud is verwijderd of verlopen. Story-media is de uitzondering: volgens de regels van Meta mag die niet worden opgeslagen of gecachet.

Waarom heeft een Instagram-DM-webhook geen media-url?

Meestal omdat de media eenmalig te bekijken is, wat aankomt als een ephemeral bijlage zonder url, of niet-ondersteund is, wat is_unsupported op true zet.

Activeren Instagram-GIF's en -stickers de messages-webhook?

De documentatie van Meta spreekt zichzelf tegen: de voorbeelden voor Instagram Login noemen GIF's en stickers onder image, terwijl de gids voor Instagram-berichten zegt dat ze geen webhook activeren. Test met een echt account.

Kan één Instagram-DM-event meerdere bijlagen bevatten?

Ja. message.attachments is een array, en het voorbeeld van Meta toont twee mediaitems in één bericht.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op