Menzioni nelle storie e risposte alle storie nel webhook di Instagram
Instagram consegna le menzioni e le risposte alle storie come DM sul campo messages del webhook. Una menzione arriva come messaggio il cui attachments contiene un elemento di tipo story_mention, con l'URL CDN della storia in payload.url. Una risposta contiene il testo della persona e reply_to.story con url e id della storia e, per una storia con sticker con link, link_sticker_url.
easyCoexistence iscrive ogni account Instagram collegato a messages, così menzioni e risposte alle storie arrivano al tuo endpoint HTTPS insieme agli altri DM non appena vengono ricevute, firmate con il segreto di quell'account e senza conservare copie.
Tipo di allegato dell'evento messages che Meta invia quando qualcuno menziona l'account nella propria storia.
Campo aggiunto da Meta a reply_to.story il 12 dicembre 2025, con l'URL dello sticker con link della storia a cui si risponde.
Per quanto tempo resta attiva una storia; una volta scaduta o eliminata, il suo URL di menzione smette di essere visualizzato.
Account da cui arrivano le menzioni nelle storie; la menzione di un account privato arriva solo se segue l'account professionale.
Risposte alle storie che il webhook non supporta, secondo la guida di Meta alla messaggistica di Instagram.
Come arriva una menzione in una storia?
Come DM. Quando una persona menziona l'account professionale nella propria storia, Instagram inserisce nella casella dell'account un messaggio che rimanda a quella storia, e Meta invia per esso un evento messages. sender.id è l'ID con ambito Instagram della persona, e message.attachments contiene un solo elemento di tipo story_mention il cui payload.url è l'URL CDN della storia. Negli esempi di Meta non c'è testo, quindi leggi l'allegato:
{
"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>" }
}
]
}
}
]
}
]
}Come arriva una risposta a una storia?
Anche come DM, con il messaggio della persona e un oggetto reply_to che rimanda alla storia dell'account. reply_to.story contiene l'URL CDN della storia e il suo id. Il riferimento del webhook di Meta elenca lì anche link_sticker_url, aggiunto a dicembre 2025 per le risposte a storie con uno sticker con link, che Meta suggerisce per instradare le automazioni in base al link. Una risposta in linea a un messaggio precedente usa invece reply_to.mid.
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL>",
"id": "<STORY_ID>"
}
}
}Cosa significa ogni campo?
I campi che Meta documenta per questi due eventi, dall'esterno verso l'interno:
- entry[].id e recipient.id: l'account professionale. sender.id: l'ID con ambito Instagram della persona, cioè l'ID a cui va una risposta.
- timestamp: quando il messaggio è stato inviato, in millisecondi negli esempi di Meta; entry[].time è quando Meta ha inviato la notifica.
- message.mid: l'ID del messaggio, utile per deduplicare i tentativi e per rispondere con
reply_to.mid. - attachments[].type
story_mentione payload.url: una menzione, e l'URL CDN della storia che l'ha generata. reply_to.story.url ereply_to.story.id: la storia dell'account a cui ha risposto la persona.reply_to.story.link_sticker_url: l'URL dello sticker con link di quella storia.- message.text: il testo della risposta, incluso quando il messaggio contiene testo.
Per quanto tempo funziona l'URL della storia?
Finché funziona la storia. Una storia scompare dopo 24 ore o quando il suo autore la elimina, e la guida di Meta alle menzioni nelle storie dice che in quel caso l'URL smette di essere visualizzato; la panoramica aggiunge che gli URL CDN di Instagram rispettano la privacy e non restituiscono nulla per contenuti eliminati o scaduti. La stessa guida permette di conservare l'URL CDN ma non il contenuto multimediale: un'app non deve memorizzare né mettere in cache il contenuto della storia sui propri server, e dovrebbe mostrare un segnaposto una volta che la storia non c'è più.
Quando non si attiva nessuno dei due eventi?
Le guide di Meta indicano questi casi, in cui un gestore in attesa di un evento di storia non riceve nulla:
- Una menzione in una storia da parte di un account privato che non segue l'account professionale.
- Un tag su un post normale: Meta precisa che solo le menzioni nelle storie attivano il webhook messages, non i tag nei post.
- Una risposta alla storia fatta con una GIF o uno sticker, che il webhook non supporta.
- Storie tramite l'API delle menzioni: GET /<
IG_ID>/tags e POST /<IG_ID>/mentions non le supportano, quindi il DM è il modo in cui arriva una menzione in una storia.
Menzioni e risposte alle storie aprono la finestra di messaggistica?
Una risposta è un messaggio della persona, e Meta include le menzioni nelle storie tra i canali con cui una persona avvia una conversazione. La finestra aperta dalla sua azione dura 24 ore per la maggior parte delle azioni, quindi l'account può rispondere con POST /<IG_ID>/messages e recipient.id impostato sul sender.id dell'evento finché la finestra è aperta. La risposta dell'account torna su messages come echo, con is_echo impostato su true.
Come li inoltra easyCoexistence?
Sul campo messages, a cui è iscritto ogni account collegato, quindi menzioni e risposte alle storie arrivano al tuo endpoint insieme agli altri DM dell'account: ogni evento dentro una busta con platform, account_id, external_id ed entry, firmato in X-EC-Signature con il segreto dell'account, inviato una sola volta e senza conservare copie. send_social_dm risponde alla persona usando il sender.id dell'evento come recipient_id, entro la finestra di 24 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>" } }
]
}
}
]
}
}Errori comuni
- Memorizzare il contenuto multimediale della storia. La guida di Meta alle menzioni nelle storie permette di conservare l'URL CDN, non il contenuto, che non deve essere memorizzato né messo in cache sui tuoi server.
- Leggere solo message.text. Una menzione in una storia contiene un allegato di tipo story_mention e, negli esempi di Meta, nessun testo, quindi un gestore che legge solo il testo vede un messaggio vuoto.
- Visualizzare l'URL della storia giorni dopo. Smette di funzionare quando la storia scade dopo 24 ore o viene eliminata, quindi da quel momento mostra un segnaposto.
- Cercare le menzioni nelle storie nel campo comments o nell'API delle menzioni. Meta le consegna come DM su messages.
send_social_dm risponde alla persona entro la finestra di 24 ore, da Claude, ChatGPT o dal tuo codice. Da US$ 9 a US$ 0.75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.
Domande frequenti
Un evento di menzione in una storia di Instagram contiene del testo?
Non negli esempi di Meta. Una menzione in una storia contiene un allegato di tipo story_mention con l'URL CDN della storia, quindi un gestore che legge solo message.text vede un messaggio vuoto.
Cos'è link_sticker_url in una risposta a una storia di Instagram?
È l'URL dello sticker con link della storia a cui ha risposto la persona, in reply_to.story.link_sticker_url. Meta l'ha aggiunto il 12 dicembre 2025 e ne suggerisce l'uso per instradare le automazioni in base al link.
Le risposte a una storia con GIF o sticker attivano il webhook?
No. La guida di Meta alla messaggistica di Instagram dice che il webhook non supporta le risposte alle storie fatte con una GIF o uno sticker.
Gli account privati attivano i webhook delle menzioni nelle storie?
Solo quando l'account privato segue l'account professionale. Le menzioni da account pubblici arrivano nel momento in cui avvengono.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il