Oznake u Instagram pričama i odgovori na priče u webhooku
Instagram isporučuje oznake u pričama i odgovore na priče kao izravne poruke (DM) na messages webhook polju. Oznaka stiže kao poruka čiji attachments sadrže stavku tipa story_mention, a CDN URL priče nalazi se u payload.url. Odgovor nosi tekst osobe i reply_to.story s url-om i id-om priče te, za priču s naljepnicom s poveznicom, polje link_sticker_url.
easyCoexistence pretplaćuje svaki povezani Instagram račun na messages, pa oznake u pričama i odgovori na priče stižu na vaš HTTPS endpoint zajedno s ostalim DM porukama čim nastanu, potpisani tajnim ključem tog računa i bez zadržavanja kopije.
Tip priloga messages događaja koji Meta šalje kada netko označi račun u svojoj priči.
Polje koje je Meta dodala u reply_to.story 12. prosinca 2025., s URL-om naljepnice s poveznicom priče na koju se odgovara.
Koliko priča traje; kad istekne ili se izbriše, URL njezine oznake prestaje se prikazivati.
Računi čije oznake u pričama stižu; oznaka privatnog računa stiže samo ako on prati profesionalni račun.
Odgovori na priče koje webhook ne podržava, prema Metinom vodiču za Instagram Messaging.
Kako stiže oznaka u priči?
Kao izravna poruka. Kada netko označi profesionalni račun u svojoj priči, Instagram u prijemno sanduče računa stavlja poruku koja upućuje na tu priču, a Meta za nju šalje događaj messages. sender.id je Instagram-scoped ID te osobe, a message.attachments sadrži jednu stavku tipa story_mention čiji payload.url je CDN URL priče. Metini primjeri nemaju tekst, pa prilog treba čitati:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{
"type": "story_mention",
"payload": { "url": "<CDN_URL>" }
}
]
}
}
]
}
]
}Kako stiže odgovor na priču?
Također kao izravna poruka, s porukom osobe i objektom reply_to koji upućuje na priču računa. reply_to.story sadrži CDN url priče i njezin id. Metin webhook referentni vodič navodi i link_sticker_url na tom mjestu, dodan u prosincu 2025. za odgovore na priče s naljepnicom s poveznicom, koju Meta preporučuje za usmjeravanje automatizacija prema poveznici. Odgovor umetnut u raniju poruku koristi reply_to.mid.
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL>",
"id": "<STORY_ID>"
}
}
}Što znači svako polje?
Polja koja Meta dokumentira za ta dva događaja, od vanjskog prema unutarnjem:
- entry[].id i recipient.id: profesionalni račun. sender.id: Instagram-scoped ID osobe, ID na koji ide odgovor.
- timestamp: trenutak slanja poruke, u milisekundama u Metinim primjerima; entry[].time je trenutak kada je Meta poslala obavijest.
- message.mid: ID poruke, za uklanjanje duplikata ponovljenih pokušaja i za odgovor s
reply_to.mid. - attachments[].type
story_mentioni payload.url: oznaka i CDN URL priče koja ju je izazvala. reply_to.story.url ireply_to.story.id: priča računa na koju je osoba odgovorila.reply_to.story.link_sticker_url: URL na naljepnici s poveznicom te priče.- message.text: riječi odgovora, uključene kada poruka sadrži tekst.
Koliko dugo radi URL priče?
Onoliko koliko i sama priča. Priča nestaje nakon 24 sata ili kada je autor izbriše, a Metin vodič za oznake u pričama kaže da tada URL prestaje prikazivati sadržaj. Pregled dodaje da su Instagramovi CDN URL-ovi osjetljivi na privatnost i ne vraćaju ništa za izbrisan ili istekao sadržaj. Isti vodič dopušta čuvanje CDN URL-a, ali ne i medija: aplikacija ne smije na svojim poslužiteljima pohranjivati ni predmemorirati sadržaj priče, a nakon što priče nema treba prikazati zamjenski prikaz.
Kada se ne aktivira nijedan događaj?
Metini vodiči navode ove slučajeve u kojima obrađivač koji čeka događaj priče ne dobiva ništa:
- Oznaka u priči privatnog računa koji ne prati profesionalni račun.
- Označavanje na običnoj objavi: Meta kaže da samo oznake u pričama aktiviraju webhook messages, a ne označavanje na objavama.
- Odgovor na priču s GIF-om ili naljepnicom, što webhook ne podržava.
- Priče kroz mentions API: GET /<
IG_ID>/tags i POST /<IG_ID>/mentions ih ne podržavaju, pa oznaka u priči stiže kao DM.
Otvaraju li oznake u pričama i odgovori prozor za poruke?
Odgovor je poruka od osobe, a Meta među kanale kojima osoba započinje razgovor navodi i oznake u pričama. Prozor koji njihova radnja otvori traje 24 sata za većinu radnji, pa račun može odgovoriti s POST /<IG_ID>/messages i recipient.id postavljenim na sender.id događaja dok je prozor otvoren. Odgovor računa vraća se na messages kao echo, s is_echo postavljenim na true.
Kako easyCoexistence prosljeđuje ove događaje?
Na polju messages, na koje je pretplaćen svaki povezani račun, pa oznake u pričama i odgovori na priče stižu na vaš endpoint uz ostale DM poruke računa: svaki unos unutar omotnice s poljima platform, account_id, external_id i entry, potpisan u X-EC-Signature tajnim ključem računa, poslan jednom i bez zadržavanja kopije. send_social_dm odgovara osobi s sender.id događaja kao recipient_id, unutar 24-satnog prozora.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "story_mention", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
}Uobičajene pogreške
- Pohranjivanje medija priče. Metin vodič za oznake u pričama dopušta čuvanje CDN URL-a, ne sadržaja, koji se ne smije pohranjivati ni predmemorirati na vašim poslužiteljima.
- Čitanje samo message.text. Oznaka u priči nosi prilog tipa story_mention i, u Metinim primjerima, nema tekst, pa obrađivač koji gleda samo tekst vidi praznu poruku.
- Prikazivanje URL-a priče nakon nekoliko dana. Prestaje raditi kada priča istekne nakon 24 sata ili bude izbrisana, pa od tada prikažite zamjenski prikaz.
- Traženje oznaka u pričama na polju comments ili u mentions API-ju. Meta ih šalje kao DM poruke na polju messages.
send_social_dm odgovara osobi unutar 24-satnog prozora, iz Claudea, ChatGPT-ja ili vašeg koda. Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, a prva 3 dana su besplatna.
Često postavljana pitanja
Sadrži li događaj oznake u Instagram priči tekst?
Ne u Metinim primjerima. Oznaka u priči nosi prilog tipa story_mention s CDN URL-om priče, pa obrađivač koji čita samo message.text vidi praznu poruku.
Što je link_sticker_url u odgovoru na Instagram priču?
URL na naljepnici s poveznicom priče na koju je osoba odgovorila, u reply_to.story.link_sticker_url. Meta ga je dodala 12. prosinca 2025. i preporučuje ga za usmjeravanje automatizacija prema poveznici.
Pokreću li odgovori na priču s GIF-om ili naljepnicom webhook?
Ne. Metin vodič za Instagram Messaging kaže da webhook ne podržava odgovore na priče napravljene GIF-om ili naljepnicom.
Pokreću li oznake privatnih računa webhook za priče?
Samo kada privatni račun prati profesionalni račun. Oznake s javnih računa stižu čim se dogode.
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