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.
Vrsta priloga za podijeljenu objavu; njezin payload uz url dodaje ig_post_media_id i title, opis objave.
Kada je stara vrsta priloga share prestala biti podržana za dijeljenje objava na Instagramu.
Vrsta priloga za nestajući medij koji se gleda jednom; stiže bez URL-a.
Postavljeno na true u događaju poruke kada poruka sadrži nepodržani medij.
Š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.
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:
{
"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:
"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_idi payload.title: samo zaig_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_unsupportedpostavljenim 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_postsada 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.
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