Mențiuni Story și răspunsuri la Story în webhook-ul Instagram
Instagram livrează mențiunile și răspunsurile la Story ca DM-uri pe câmpul messages al webhook-ului. O mențiune sosește ca un mesaj ale cărui atașamente conțin un element de tip story_mention, cu URL-ul CDN al Story-ului în payload.url. Un răspuns conține textul persoanei și reply_to.story cu url-ul și id-ul Story-ului și, pentru un Story cu autocolant cu link, link_sticker_url.
easyCoexistence abonează fiecare cont Instagram conectat la messages, astfel încât mențiunile în Story și răspunsurile la Story ajung la endpoint-ul dumneavoastră HTTPS împreună cu celelalte DM-uri, pe măsură ce sosesc, semnate cu secretul acelui cont și fără nicio copie păstrată.
Tipul atașamentului din evenimentul messages pe care Meta îl trimite când cineva menționează contul în Story-ul său.
Câmpul pe care Meta l-a adăugat în reply_to.story la 12 decembrie 2025, care conține URL-ul autocolantului cu link al Story-ului la care s-a răspuns.
Cât timp rămâne activ un Story; după ce expiră sau este șters, URL-ul mențiunii nu mai este afișat.
Conturile de la care sosesc mențiunile în Story; mențiunea unui cont privat ajunge doar dacă acesta urmărește contul profesional.
Răspunsurile la Story pe care webhook-ul nu le acceptă, potrivit ghidului Meta Instagram Messaging.
Cum ajunge o mențiune în Story?
Ca DM. Când cineva menționează contul profesional în Story-ul său, Instagram pune în căsuța de mesaje a contului un mesaj care face referire la acel Story, iar Meta trimite pentru el un eveniment messages. sender.id este ID-ul Instagram-scoped al persoanei, iar message.attachments conține un element de tip story_mention al cărui payload.url este URL-ul CDN al Story-ului. Exemplele Meta nu includ text, așa că citiți atașamentul:
{
"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>" }
}
]
}
}
]
}
]
}Cum ajunge un răspuns la Story?
Tot ca DM, cu mesajul persoanei și un obiect reply_to care indică Story-ul contului. reply_to.story conține URL-ul CDN al Story-ului și id-ul său. Documentația webhook-ului Meta listează aici și link_sticker_url, adăugat în decembrie 2025 pentru răspunsurile la Story-urile cu autocolant cu link, câmp recomandat de Meta pentru direcționarea automatizărilor după link. Un răspuns inline la un mesaj anterior folosește în schimb reply_to.mid.
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL>",
"id": "<STORY_ID>"
}
}
}Ce înseamnă fiecare câmp?
Câmpurile pe care Meta le documentează pentru aceste două evenimente, de la nivelul exterior la cel interior:
- entry[].id și recipient.id: contul profesional. sender.id: ID-ul Instagram-scoped al persoanei, adică ID-ul la care ajunge un răspuns.
- timestamp: momentul trimiterii mesajului, în milisecunde în exemplele Meta; entry[].time este momentul în care Meta a trimis notificarea.
- message.mid: ID-ul mesajului, pentru deduplicarea reîncercărilor și pentru a răspunde cu
reply_to.mid. - attachments[].type
story_mentionși payload.url: o mențiune și URL-ul CDN al Story-ului care a generat-o. reply_to.story.url șireply_to.story.id: Story-ul contului la care a răspuns persoana.reply_to.story.link_sticker_url: URL-ul de pe autocolantul cu link al acelui Story.- message.text: cuvintele răspunsului, incluse când mesajul conține text.
Cât timp funcționează URL-ul Story-ului?
Atât timp cât Story-ul există. Un Story dispare după 24 de ore sau când autorul îl șterge, iar ghidul Meta despre mențiunile în Story spune că URL-ul nu mai este afișat; prezentarea generală adaugă că URL-urile CDN ale Instagram țin cont de confidențialitate și nu returnează nimic pentru conținutul șters sau expirat. Același ghid permite păstrarea URL-ului CDN, dar nu și a conținutului media: o aplicație nu trebuie să stocheze sau să pună în cache conținutul Story-ului pe serverele sale și ar trebui să afișeze un placeholder odată ce Story-ul a dispărut.
Când nu se declanșează niciun eveniment?
Ghidurile Meta enumeră aceste cazuri, în care un handler care așteaptă un eveniment Story nu primește nimic:
- O mențiune în Story făcută de un cont privat care nu urmărește contul profesional.
- O etichetare într-o postare obișnuită: Meta spune că doar mențiunile în Story declanșează webhook-ul messages, nu etichetarea în postări.
- Un răspuns la Story făcut cu un GIF sau un autocolant, pe care webhook-ul nu îl acceptă.
- Story-urile prin API-ul de mențiuni: GET /<
IG_ID>/tags și POST /<IG_ID>/mentions nu le acceptă, deci DM-ul este modul în care ajunge o mențiune în Story.
Mențiunile și răspunsurile la Story deschid fereastra de mesagerie?
Un răspuns este un mesaj al persoanei, iar Meta include mențiunile în Story printre canalele prin care o persoană începe o conversație. Fereastra pe care o deschide acțiunea sa durează 24 de ore pentru majoritatea acțiunilor, deci contul poate răspunde cu POST /<IG_ID>/messages și cu recipient.id setat la sender.id al evenimentului cât timp fereastra este deschisă. Răspunsul contului revine pe messages ca echo, cu is_echo setat la true.
Cum le transmite easyCoexistence?
Pe câmpul messages, la care este abonat fiecare cont conectat, astfel încât mențiunile în Story și răspunsurile la Story ajung la endpoint-ul dumneavoastră împreună cu celelalte DM-uri ale contului: fiecare intrare, încapsulată într-un plic cu platform, account_id, external_id și entry, semnată în X-EC-Signature cu secretul contului, trimisă o singură dată și fără nicio copie păstrată. send_social_dm răspunde persoanei folosind sender.id al evenimentului ca recipient_id, în fereastra de 24 de ore.
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>" } }
]
}
}
]
}
}Greșeli frecvente
- Stocarea conținutului media al Story-ului. Ghidul Meta despre mențiunile în Story permite păstrarea URL-ului CDN, nu a conținutului, care nu trebuie stocat sau pus în cache pe serverele dumneavoastră.
- Citirea doar a message.text. O mențiune în Story are un atașament de tip story_mention și, în exemplele Meta, nu are text, așa că un handler care citește doar textul vede un mesaj gol.
- Afișarea URL-ului Story-ului zile mai târziu. Acesta încetează să funcționeze după ce Story-ul expiră după 24 de ore sau este șters, așa că de atunci afișați un placeholder.
- Căutarea mențiunilor în Story pe câmpul comments sau în API-ul de mențiuni. Meta le livrează ca DM-uri pe messages.
send_social_dm răspunde persoanei în fereastra de 24 de ore, din Claude, ChatGPT sau din propriul cod. US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu o perioadă de probă gratuită de 3 zile.
Întrebări frecvente
Un eveniment de mențiune în Story Instagram include text?
Nu în exemplele Meta. O mențiune în Story are un atașament de tip story_mention cu URL-ul CDN al Story-ului, așa că un handler care citește doar message.text vede un mesaj gol.
Ce este link_sticker_url într-un răspuns la Story Instagram?
Este URL-ul de pe autocolantul cu link al Story-ului la care a răspuns persoana, în reply_to.story.link_sticker_url. Meta l-a adăugat pe 12 decembrie 2025 și îl recomandă pentru direcționarea automatizărilor după link.
Răspunsurile la Story făcute cu GIF sau autocolant declanșează webhook-ul?
Nu. Ghidul Meta Instagram Messaging spune că webhook-ul nu acceptă răspunsurile la Story făcute cu un GIF sau un autocolant.
Conturile private declanșează webhook-urile pentru mențiuni în Story?
Doar când contul privat urmărește contul profesional. Mențiunile de la conturile publice ajung pe măsură ce au loc.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la