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

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.

story_mention

Tip priloga messages događaja koji Meta šalje kada netko označi račun u svojoj priči.

link_sticker_url

Polje koje je Meta dodala u reply_to.story 12. prosinca 2025., s URL-om naljepnice s poveznicom priče na koju se odgovara.

24 hours

Koliko priča traje; kad istekne ili se izbriše, URL njezine oznake prestaje se prikazivati.

Public

Računi čije oznake u pričama stižu; oznaka privatnog računa stiže samo ako on prati profesionalni račun.

GIF, sticker

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:

A Story mention, 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": "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.

The message object of a Story reply
"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_mention i payload.url: oznaka i CDN URL priče koja ju je izazvala.
  • reply_to.story.url i reply_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.

A forwarded Story mention, headers included
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.
Radite ovo uz EasyCoexistence

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