Webhook dei commenti di Instagram: il payload, campo per campo
Il campo comments del webhook di Instagram avvisa un'app quando qualcuno commenta i contenuti di un account professionale, Reel inclusi, o risponde a un commento su di essi. Meta invia un elemento changes con field impostato su comments: il campo value contiene l'id e il testo del commento, l'ID con ambito Instagram e lo username dell'autore in from, l'id e il media_product_type del media, e parent_id quando il commento è una risposta.
easyCoexistence iscrive ogni account Instagram collegato a comments e inoltra al tuo endpoint HTTPS gli eventi comments che Meta consegna per esso, appena arrivano, firmati con il segreto di quell'account e senza conservare alcuna copia.
Presente quando il commento è una risposta, con l'ID del commento a cui risponde.
Compare dentro from quando l'account commenta i propri media, accanto al suo ID.
Campo separato per i commenti durante una diretta; le notifiche si fermano quando la diretta termina.
Richiesto per le notifiche comments e live_comments; i media di account privati non generano alcuna notifica.
Tempo rimasto per inviare al commentatore una risposta privata, indirizzata tramite l'ID del commento.
Quando si attiva il campo comments?
Quando qualcuno commenta un media di proprietà dell'account professionale, o menziona l'account, una volta che app e account sono entrambi iscritti al campo. Ogni commento è una modifica nella notifica, e questi casi condividono la stessa struttura:
- Un nuovo commento su un post, un Reel, una Story o un annuncio, con media.
media_product_typeche indica su quale superficie si trova il media. - Una risposta a un commento esistente, che porta
parent_idcon l'ID del commento a cui risponde. - Un commento che l'account scrive sui propri media, risposte incluse: from.id è l'ID dell'account stesso, e from aggiunge
self_ig_scoped_id. - Una menzione dell'account: con Instagram Login, Meta include le menzioni nella notifica dei commenti invece di un campo proprio.
- Un commento durante una diretta arriva su un campo separato,
live_comments, con la stessa forma del valore, e si ferma quando la diretta termina.
Che aspetto ha una notifica dei commenti?
Una POST il cui JSON ha object impostato su instagram e un array entry. Ogni entry è un account professionale: il suo ID, l'ora in cui Meta ha inviato la notifica e un array changes con una modifica per commento. Una risposta su un Reel appare così:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}Cosa significa ogni campo?
I campi che la reference del webhook di Meta elenca per un commento, dall'esterno verso l'interno:
- entry[].id: l'ID dell'account professionale, lo
user_idche /me restituisce per esso. Indica a quale account appartiene il commento. - entry[].time: quando Meta ha inviato la notifica, come timestamp Unix. Non è il momento in cui il commento è stato scritto.
- changes[].field: comments, oppure
live_commentsper una diretta. Controllalo prima di leggere value. - value.id: l'ID del commento, quello a cui rispondere in pubblico o in privato, da nascondere o eliminare.
- value.text: il testo del commento, incluso quando il commento contiene testo.
- value.from.id e value.from.username: l'ID con ambito Instagram e lo username dell'autore. value.from.
self_ig_scoped_idcompare quando l'account stesso ha scritto il commento. - value.media.id e value.media.
media_product_type: il media commentato e la sua superficie; il riferimento dei media di Meta indica AD, FEED, STORY e REELS. - value.
parent_id: in una risposta, l'ID del commento a cui risponde. Un commento di primo livello non lo ha. - value.media.
ad_id,ad_titleeoriginal_media_id: elencati nel riferimento per i commenti fatti su un annuncio.
Cosa non riporta il campo comments?
Alcune cose che un gestore potrebbe aspettarsi sono escluse dall'evento o non vengono mai inviate, secondo la guida di configurazione e i riferimenti di Meta:
- Commenti su media di proprietà di un account privato: Meta non invia notifiche di commenti o menzioni per essi.
- ID degli album: l'evento non li include, e Meta consiglia di cercare l'album con l'ID del commento.
- ID degli annunci per i media usati negli annunci dinamici.
- L'ora di creazione del commento: GET /<
COMMENT_ID>?fields=timestamp la restituisce in ISO 8601. - I commenti in diretta dopo la fine della diretta, quando le notifiche per i media live si fermano.
- Le menzioni nelle Story, che l'API delle menzioni di Meta non supporta; arrivano invece all'account come DM.
- Eventi passati: Meta non conserva una cronologia delle notifiche da interrogare, quindi salva ciò che ti serve man mano che ciascuna arriva.
Cosa richiede il campo comments?
Con Instagram Login, i permessi instagram_business_basic e instagram_business_manage_comments, e l'Advanced Access, che Meta richiede per le notifiche comments e live_comments. L'app deve essere in modalità Live e iscritta a comments nell'App Dashboard, e ogni account deve essere iscritto tramite POST /<IG_ID>/subscribed_apps con comments tra i subscribed_fields. Meta raccomanda vivamente questo webhook rispetto all'interrogazione periodica per i commenti, perché non consuma il limite di frequenza.
Come si risponde a un commento dall'evento?
Con gli ID che porta. POST /<COMMENT_ID>/replies con un campo message pubblica una risposta pubblica sotto il commento, usando value.id. POST /<IG_ID>/messages con recipient.comment_id impostato su value.id invia all'autore una sola risposta privata, entro 7 giorni dal commento, o finché dura la diretta se il commento proviene da una diretta. from.id è un ID con ambito Instagram, ma un DM inviato direttamente a quell'ID fallisce finché la persona non ha scritto all'account, quindi la risposta privata è il modo per raggiungerla via DM.
Come inoltra un commento easyCoexistence?
Appena arriva, una volta impostato un endpoint per l'account con set_social_webhook_destination da Claude o ChatGPT, oppure con PUT /channels/:id/webhook sulla Partner API. easyCoexistence iscrive ogni account collegato ai campi che trasportano i suoi commenti, le menzioni e i DM, verifica la firma di Meta su ogni consegna, risponde subito a Meta e invia con POST ogni entry di quell'account al tuo URL HTTPS dentro una busta:
- platform e
external_id: instagram, e l'ID Instagram dell'account, uguale a entry.id. account_id: l'ID della connessione in easyCoexistence, quello che restituiscelist_social_accountse che usano gli strumenti MCP.- entry: l'entry di Meta per l'account, invariata, quindi una consegna raggruppata diventa una POST per ogni entry. Il campo object di Meta e X-Hub-Signature-256 non vengono inoltrati.
- Consegna: un solo tentativo, con attesa fino a 8 secondi, senza seguire reindirizzamenti, verso un indirizzo HTTPS che risolve in un IP pubblico. Nessuna copia viene conservata e nulla viene ritentato.
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": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}Cosa fanno le regole commento-DM con lo stesso evento?
Lo leggono insieme all'inoltro. Una regola scatta quando il commento contiene una delle sue parole chiave, senza distinguere maiuscole e minuscole, su un post scelto o su tutti, e invia all'autore il DM della regola come risposta privata, più una risposta pubblica se la regola ne ha una. I commenti dell'account stesso vengono saltati, le automazioni che partono da un commento prendono quelli a cui nessuna regola ha risposto, e un commento a cui una regola ha risposto raggiunge comunque il tuo endpoint. La risposta pubblica della regola può tornare come nuovo evento comments dall'account stesso.
Errori comuni
- Cercare comment_id. Con Instagram Login l'ID del commento sta in value.id; comment_id appartiene ai payload degli altri setup di login di Meta.
- Rispondere ai commenti dell'account stesso. Le sue risposte tornano come eventi comments con from.id uguale a entry.id, e un'automazione che risponde a loro finisce per parlare con se stessa.
- Leggere entry.time come ora del commento. Registra quando Meta ha inviato la notifica; il timestamp del commento dice quando è stato scritto.
- Aspettarsi i commenti in diretta sul campo comments. Arrivano su live_comments, che richiede una propria iscrizione e tace quando la diretta termina.
Le regole commento-DM e le automazioni rispondono agli stessi commenti a tutte le ore. 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 gratuiti.
Domande frequenti
Il webhook dei commenti di Instagram include le risposte ai commenti?
Sì. Una risposta arriva come evento comments a sé, con parent_id che contiene l'ID del commento a cui risponde.
I commenti sui Reel attivano il webhook dei commenti di Instagram?
Sì. Un commento su un Reel arriva sul campo comments come uno su un post, e media.media_product_type distingue i due casi.
Perché il mio webhook dei commenti di Instagram non si attiva?
Più spesso l'app non è in modalità Live o non ha l'Advanced Access, l'account non è stato iscritto tramite /subscribed_apps, il media appartiene a un account privato, oppure il commento era su una diretta, che usa live_comments.
Il webhook dei commenti include lo username di chi commenta?
Sì. value.from riporta lo username della persona accanto al suo ID con ambito Instagram, quindi non serve alcuna chiamata in più per mostrare chi ha commentato.
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