Instagram DM prilozi u webhooku za poruke
Webhook za poruke na Instagramu prenosi medije iz DM-a u message.attachments: niz objekata, a svaki ima type i payload koji obično sadrži url do CDN-a. Spisak kompanije Meta za Instagram Login navodi image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story i stari share, dok mediji za jednokratni prikaz stižu kao ephemeral prilog bez URL-a.
easyCoexistence pretplaćuje svaki povezani Instagram nalog na messages i prosleđuje DM-ove sa prilozima na vaš HTTPS endpoint onako kako ih šalje Meta, potpisane tajnim ključem tog naloga i bez čuvanja kopije, pa vaš agent ili kod preuzima medije koji su mu potrebni.
Tip priloga za podeljenu objavu; njegov payload uz url dodaje ig_post_media_id i title, odnosno opis objave.
Kada je prestala podrška za stari tip priloga share za deljenje objava na Instagramu.
Tip priloga za medije koji nestaju nakon jednog prikaza; stižu bez URL-a.
Postavlja se na true u događaju poruke kada poruka sadrži nepodržan medij.
Šta obaveštenje javlja kada neko reaguje na jednu sliku iz karusela objave ili je prosledi.
Koje tipove priloga događaj DM može da nosi?
Primeri za Instagram Login navode ove vrednosti za message.attachments[].type, a svaki ima objekat payload. Većina payloada sadrži url do medija na CDN-u kompanije Meta, a dodatna polja payloada dokumentovana su samo za ig_post, pa prvo pročitajte type, pa tek onda payload.
Kako izgleda DM sa prilozima?
Događaj poruke čiji objekat message sadrži prilog umesto teksta ili pored njega. Primer kompanije Meta šalje dva medija u jednoj poruci, svaki sa svojim type i payload.url, pa handler mora da prođe kroz niz, a ne da čita samo prvi element:
{
"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 podeljena objava?
Prilog ig_post. Od 3. novembra 2025. Meta je za deljenje objava slala i prilog share i prilog ig_post; share je važio za objave do 1. februara 2026, a Meta kaže da nove integracije moraju da podržavaju ig_post. Njegov payload dodaje ID medija objave i njen opis kao title:
"attachments": [
{
"type": "ig_post",
"payload": {
"ig_post_media_id": "<MEDIA_ID>",
"title": "<POST_CAPTION>",
"url": "<CDN_URL>"
}
}
]Šta znači svako polje?
Polja priloga koja Meta dokumentuje za DM događaj, od niza naniže:
- message.attachments[]: jedan objekat po mediju; primer kompanije Meta nosi dva u jednoj poruci.
- type: šta stavka predstavlja, prema spisku iznad. Proverite ga pre čitanja payloada.
- payload.url: CDN URL za medij. U pregledu kompanije Meta ovi URL-ovi se opisuju kao svesni privatnosti: ne vraćaju ništa kada sadržaj bude obrisan ili istekne.
- payload.
ig_post_media_idi payload.title: samo zaig_post, ID medija podeljene objave i njen opis. - message.text: prisutan 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?
Vezani su za sadržaj. Pregled kaže da CDN URL-ovi na Instagramu vode računa o privatnosti i prestaju da vraćaju medij kada sadržaj bude obrisan ili istekne, a vodič za spominjanje u Story-ju kaže da URL Story-ja prestaje da se prikazuje kada istekne ili bude obrisan. Aplikacija kojoj je potreban fajl treba da ga preuzme kada događaj stigne, u skladu sa pravilima kompanije Meta: medije iz Story-ja, na primer, ne smete da čuvate ili keširate.
Koje medije webhook ne šalje?
Praznine koje navodi vodič za Instagram Messaging; handler ih treba očekivati, a ne tretirati kao greške:
- Mediji koji nestaju, za prikaz jednom ili za dozvoljeno ponovno puštanje: prilog tipa ephemeral, bez URL-a.
- Nepodržani mediji: poruka stiže sa
is_unsupportedpostavljenim na true. - GIF-ovi i nalepnice: taj vodič kaže da ne okidaju webhook, dok ih primeri za Instagram Login navode pod image.
- Odabrana slika u karuselu: reakcija na jednu sliku ili prosleđivanje jedne slike iz karusel objave prijavljuje prvu sliku.
- Deljenja uopšte: vodiči za poruke i dalje kažu da je uključen samo URL podeljenog medija, iako
ig_postsada dodaje ID medija i opis.
Kako easyCoexistence prosleđuje priloge?
Nepromenjeno, unutar entry: DM sa medijem stiže na vaš endpoint sa Metinim nizom attachments onako kako ga je Meta poslala, u omotu od platform, account_id, external_id i entry, potpisanom pomoću X-EC-Signature. Prilozi se ne preuzimaju, a događaji se podrazumevano ne čuvaju: nalog sa uključenom automatizacijom zadržava tekst DM-a, a ne i medij, 7 dana. Medij koji vam treba preuzmite sa payload.url kada događaj stigne, a medije iz Story-ja ne čuvajte.
Česte greške
- Čitanje samo prvog priloga. message.attachments je niz, a primer kompanije Meta nosi dve stavke u jednoj poruci, pa prolazite kroz ceo niz.
- I dalje traženje tipa share za deljene objave. Meta ga je podržavala za objave do 1. februara 2026; čitajte ig_post, sa ID-em medija i opisom u payloadu.
- Čuvanje payload.url za kasnije preuzimanje. Prestaje da vraća medij kada sadržaj bude obrisan ili istekne, pa preuzmite šta vam treba odmah po dolasku, osim medija iz Story-ja.
- Čitanje payload.url bez provere tipa. Medij za jednokratni prikaz stiže kao ephemeral bez URL-a, a nepodržan medij postavlja is_unsupported.
send_social_dm odgovara unutar prozora od 24 sata. US$ 9 do US$ 0,75 po povezanom nalogu mesečno, uz pad kako dodajete naloge i prva 3 dana besplatno.
Često postavljana pitanja
Mogu li da sačuvam medije iz priloga Instagram DM-a?
Preuzmite šta vam treba kada događaj stigne, jer payload.url prestaje da vraća medij kada sadržaj bude obrisan ili istekne. Story je izuzetak: pravila kompanije Meta kažu da se ne sme čuvati ni keširati.
Zašto webhook za Instagram DM nema URL medija?
Obično zato što je medij za jednokratni prikaz, koji stiže kao ephemeral prilog bez URL-a, ili nepodržan, što postavlja is_unsupported na true.
Da li Instagram GIF-ovi i nalepnice okidaju webhook za poruke?
Dokumentacija kompanije Meta se ne slaže: primeri za Instagram Login navode GIF-ove i nalepnice pod image, a vodič za Instagram Messaging kaže da ne okidaju webhook. Proverite na pravom Instagram nalogu.
Da li jedan DM događaj na Instagramu može da nosi više priloga?
Da. message.attachments je niz, a primer kompanije Meta prikazuje dva medija u jednoj poruci.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na