Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

DM prilozi na Instagramu u webhooku za poruke

Instagram webhook za poruke prenosi medijske priloge DM-a u message.attachments: niz objekata, od kojih svaki ima type i payload koji obično sadrži CDN url. Metin popis za Instagram Login navodi image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story i naslijeđeni share, a medij koji se gleda jednom stiže kao privremeni prilog bez URL-a.

easyCoexistence pretplaćuje svaki povezani Instagram račun na poruke i prosljeđuje DM-ove s njihovim prilozima na vaš HTTPS endpoint kakve ih Meta šalje, potpisane tajnim ključem tog računa i bez zadržane kopije, pa vaš agent ili kod dohvaća medij koji mu treba.

ig_post

Vrsta priloga za podijeljenu objavu; njezin payload uz url dodaje ig_post_media_id i title, opis objave.

1 Feb 2026

Kada je stara vrsta priloga share prestala biti podržana za dijeljenje objava na Instagramu.

ephemeral

Vrsta priloga za nestajući medij koji se gleda jednom; stiže bez URL-a.

is_unsupported

Postavljeno na true u događaju poruke kada poruka sadrži nepodržani medij.

First image

Što obavijest prijavljuje kada netko reagira na jednu sliku karuselne objave ili je proslijedi dalje.

Koje vrste priloga događaj DM-a može sadržavati?

Metini primjeri za Instagram Login navode ove vrijednosti za message.attachments[].type, a svaka ima payload objekt. Većina payloada sadrži url do medija na Metinom CDN-u, a Meta dokumentira dodatna polja payloada samo za ig_post, pa prvo pročitajte type, pa tek onda 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.

Kako izgleda DM s prilozima?

Događaj poruke čiji objekt message sadrži priloge umjesto teksta ili uz tekst. Metin primjer šalje dvije medijske stavke u jednoj poruci, svaka sa svojim type i payload.url, pa rukovatelj mora proći kroz cijeli niz, a ne čitati samo prvi element:

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>" } }
            ]
          }
        }
      ]
    }
  ]
}

Kako izgleda podijeljena objava?

Prilog ig_post. Od 3. studenoga 2025. Meta je dijeljenje objava slala s priloicima share i ig_post; share je za objave bio podržan do 1. veljače 2026., a Meta navodi da nove integracije moraju podržavati ig_post. Njegov payload uz ID medija objave dodaje i opis objave kao title:

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

Što znači svako polje?

Polja priloga koja Meta dokumentira za događaj DM-a, od niza prema dolje:

  • message.attachments[]: jedan objekt po medijskoj stavci; Metin primjer u jednoj poruci donosi dva.
  • type: što stavka jest, s gornjeg popisa. Grananje prema njemu obavite prije čitanja payloada.
  • payload.url: CDN URL medija. Metin pregled naziva ove URL-ove privatnima: ne vraćaju ništa nakon što je sadržaj obrisan ili istekao.
  • payload.ig_post_media_id i payload.title: samo za ig_post, ID medija podijeljene objave i njezin opis.
  • message.text: prisutno samo kada poruka sadrži i tekst.
  • message.is_unsupported: true kada poruka sadrži medij koji webhook ne podržava.

Koliko dugo rade URL-ovi priloga?

Meta ih veže uz sadržaj. Njezin pregled kaže da su CDN URL-ovi Instagrama privatni i da prestaju vraćati medij kada je sadržaj obrisan ili istekao, a njezin vodič o spominjanju u pričama kaže da URL priče prestaje prikazivati kada priča istekne ili bude obrisana. Aplikacija kojoj treba datoteka treba je dohvatiti kada događaj stigne, unutar Metinih pravila: medij priča, primjerice, ne smije se pohranjivati ni predmemorirati.

Koje medije webhook ne šalje?

Metin vodič za slanje poruka na Instagramu navodi ove praznine, koje rukovatelj treba očekivati, a ne tretirati kao greške:

  • Nestajući medij, gledanje jednom ili dopuštanje ponovnog gledanja: prilog vrste ephemeral, bez URL-a.
  • Nepodržani medij: poruka stiže s is_unsupported postavljenim na true.
  • GIF-ovi i naljepnice: taj vodič kaže da ne pokreću webhook, dok ih Metini primjeri za Instagram Login navode pod image.
  • Odabrana slika karuselne objave: reakcija na jednu sliku karuselne objave ili njezino proslijeđivanje prijavljuje prvu sliku.
  • Dijeljenja općenito: Metini vodiči za poruke još kažu da se uključuje samo URL dijeljenog medija, iako ig_post sada dodaje ID medija i opis.

Kako easyCoexistence prosljeđuje priloge?

Nepromijenjeno, unutar entry: DM s medijem stiže na vaš endpoint s Metinim nizom attachments onako kako ga je Meta poslala, u omotnici od platform, account_id, external_id i entry, potpisanoj s X-EC-Signature. Privitci se ne preuzimaju, a događaji se prema zadanim postavkama ne pohranjuju: račun s uključenom automatizacijom zadržava tekst DM-a, a ne njegov medij, 7 dana. Medij koji vam treba dohvatite s payload.url kada događaj stigne i ne pohranjujte medij priča.

Uobičajene pogreške

  • Čitanje samo prvog priloga. message.attachments je niz, a Metin primjer u jednoj poruci donosi dvije stavke, pa prođite kroz cijeli niz.
  • I dalje traženje vrste share za podijeljene objave. Meta ju je za objave podržavala do 1. veljače 2026.; čitajte ig_post, s ID-em medija i opisom u payloadu.
  • Spremanje payload.url za kasnije dohvaćanje. Prestaje vraćati medij kada sadržaj bude obrisan ili istekne, pa preuzmite što vam treba po dolasku, osim medija priča.
  • Čitanje payload.url bez provjere vrste. Medij koji se gleda jednom stiže kao ephemeral bez URL-a, a nepodržani medij postavlja is_unsupported.
Radite ovo uz EasyCoexistence

send_social_dm odgovara unutar 24-satnog prozora. Od US$ 9 do US$ 0,75 po vezi mjesečno, uz smanjenje kako dodajete veze, s prvih 3 dana besplatno.

Često postavljana pitanja

Mogu li pohraniti medij iz priloga DM-a na Instagramu?

Preuzmite što vam treba kada događaj stigne, jer payload.url prestaje vraćati medij kada sadržaj bude obrisan ili istekne. Medij priča je iznimka: Metina pravila kažu da se ne smije pohranjivati ni predmemorirati.

Zašto webhook za DM na Instagramu nema URL medija?

Obično zato što je medij takav da se gleda jednom; on stiže kao ephemeral prilog bez URL-a, ili je nepodržan, pa je is_unsupported postavljen na true.

Pokreću li GIF-ovi i naljepnice na Instagramu webhook za poruke?

Metini dokumenti se razilaze: njezini primjeri za Instagram Login navode GIF-ove i naljepnice pod image, dok njezin vodič za slanje poruka na Instagramu kaže da ne pokreću webhook. Provjerite sa stvarnim računom.

Može li jedan događaj DM-a na Instagramu nositi više priloga?

Da. message.attachments je niz, a Metin primjer pokazuje dvije medijske stavke u jednoj poruci.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na