AccediInizia la prova gratuita
easyCoexistence API ufficiali

Campi webhook di Instagram: l'elenco completo

Per un account professionale su Instagram Login, la tabella dei campi webhook di Meta elenca comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover e standby, con le menzioni consegnate dentro comments; i suoi esempi aggiungono message_edit. Ognuno richiede instagram_business_basic più instagram_business_manage_comments o, per la maggior parte dei campi di messaggistica, instagram_business_manage_messages. story_insights non è offerto con Instagram Login.

easyCoexistence sottoscrive ogni account Instagram collegato a comments, messages e mentions, e inoltra quegli eventi al tuo endpoint HTTPS man mano che arrivano, firmati con il segreto di quell'account.

8

Campi con cui un nuovo prodotto Instagram nella App Dashboard parte sottoscritto, tra cui comments, messages e message_reactions.

Per app

I campi si selezionano per l'app, non per singolo account: un account riceve i campi che l'app ha selezionato.

Advanced Access

Livello di accesso che la guida alla configurazione di Meta indica per i webhook di Instagram Login, e richiede per le notifiche di comments e live_comments.

story_insights

Segnato come non disponibile per Instagram Login nella tabella dei campi di Meta, che lo offre con Facebook Login e Unified Login.

10 Sep 2025

Quando Meta ha introdotto il webhook message_edit per Business Login for Instagram e Facebook Login for Business.

Quali campi webhook offre Instagram Login?

Questi, dalla tabella dei campi di Meta, con ciò che attiva ciascuno ricavato dai suoi esempi e dal riferimento dei webhook. Ogni campo richiede anche instagram_business_basic oltre al permesso indicato, e Meta richiede l'Advanced Access per le notifiche di comments e live_comments.

commentsA comment or reply on the account's posts, Reels, Stories or ads, @mentions included. instagram_business_manage_comments.
live_commentsA comment on the account's Live while it is broadcast. instagram_business_manage_comments.
mentionsNo field of its own with Instagram Login: Meta includes mentions in the comments notification.
messagesA DM: text, attachments, shares, Story replies and mentions, quick replies, deletions, and echoes of the account's own messages. instagram_business_manage_messages.
message_echoesListed with instagram_business_manage_comments; the account's own messages arrive on messages with is_echo set to true.
message_reactionsA person reacts to a message or removes the reaction. instagram_business_manage_messages.
message_editA person edits a message, with mid, text and num_edit. In Meta's examples and changelog, not in its fields table.
messaging_postbacksA tap on an ice breaker, a template's postback button or a persistent menu item. instagram_business_manage_messages.
messaging_referralAn ig.me link with a ref parameter, opened in an existing conversation. instagram_business_manage_messages.
messaging_seenA person reads a message, reported as read.mid. instagram_business_manage_messages.
messaging_optinsListed with instagram_business_manage_messages; Meta's Instagram examples show no payload for it.
messaging_handoverThread control passed, taken or requested between apps under the handover protocol. instagram_business_manage_messages.
standbyA message that arrives while another app controls the conversation. instagram_business_manage_messages.

Quali campi non sono disponibili con Instagram Login?

Tre righe della tabella dei campi di Meta non hanno un permesso per Instagram Login, quindi un'app su Instagram Login non li riceve, e un altro campo esiste solo al di fuori di essa:

  • story_insights: le metriche di una Storia quando scade, con Facebook Login o Unified Login e instagram_manage_insights. Il riferimento alle metriche dei media di Meta dice che il webhook insights non è supportato con Instagram Login.
  • messaging_policy_enforcement e response_feedback: solo nella colonna della Instagram Messaging API di Meta.
  • mentions come campo a sé: Facebook Login e Unified Login lo elencano, con instagram_manage_comments, mentre Instagram Login include le menzioni in comments.

Come si sottoscrivono i campi?

In due punti. Nelle impostazioni webhook del prodotto Instagram nella App Dashboard, salvi l'URL di callback e il token di verifica, il che attiva la richiesta di verifica di Meta, poi selezioni i campi; un nuovo prodotto Instagram parte sottoscritto a otto di essi. Poi sottoscrivi ogni account con POST /<IG_ID>/subscribed_apps su graph.instagram.com, con subscribed_fields impostato sui campi selezionati nella dashboard, separati da virgole.

Subscribing one account to three fields
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
  ?subscribed_fields=comments,messages,message_reactions
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{ "success": true }

Ogni account può ricevere campi diversi?

No. La guida alla configurazione di Meta dice che i campi non possono essere selezionati per l'account di ogni utente dell'app: un account riceve i campi selezionati per l'app. subscribed_fields nella sottoscrizione dell'account deve elencare i campi della dashboard, quindi un gestore deve aspettarsi qualsiasi campo selezionato dall'app e decidere in base a ciò che contiene ogni evento, non a ciò che ha chiesto per un singolo account.

Come si distinguono i campi in una notifica?

Dalla forma della voce. I campi dei commenti arrivano in un array changes, dove ogni modifica indica il proprio campo. I campi di messaggistica arrivano in un array messaging senza nome di campo, e la chiave accanto a sender, recipient e timestamp li distingue:

  • changes[].field: comments o live_comments, con il commento in value.
  • message: messages, inclusi gli echi dei messaggi dell'account, che hanno is_echo impostato su true.
  • reaction: message_reactions. postback: messaging_postbacks. read: messaging_seen. message_edit: message_edit.
  • referral accanto a sender: messaging_referral. Un referral dentro message appartiene a messages, da una nuova conversazione o da un annuncio Click-to-Direct.
  • pass_thread_control, take_thread_control o request_thread_control: messaging_handover, come li elenca il riferimento dei webhook di Meta.

A quali campi si sottoscrive easyCoexistence?

comments, messages e mentions, l'elenco con cui ogni account Instagram viene sottoscritto quando si collega. Con Instagram Login le menzioni arrivano dentro comments, quindi la sottoscrizione copre commenti e messaggi diretti (DM), con echi, risposte alle Storie, menzioni nelle Storie e allegati tra i DM. Gli altri campi della tabella vengono consegnati da Meta a un'app sottoscritta ad essi e non fanno parte della sottoscrizione di una connessione. Una volta impostato un endpoint con set_social_webhook_destination o con la Partner API, easyCoexistence verifica la firma di Meta, risponde subito a Meta e invia con POST ogni voce dell'account al tuo endpoint:

  • 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 usano gli strumenti MCP.
  • entry: la voce di Meta per l'account, invariata. Il campo object di Meta e l'intestazione X-Hub-Signature-256 non vengono inoltrati.
  • X-EC-Signature: t=<unix>,v1=<hex>, un HMAC-SHA256 del timestamp, un punto e il corpo grezzo, con la chiave segreta propria dell'account.
  • Consegna: un tentativo di massimo 8 secondi, senza seguire reindirizzamenti, senza conservare copie e senza nuovi tentativi.

Errori comuni

  • Attendere un campo mentions con Instagram Login. Meta include le menzioni nella notifica dei commenti, quindi un gestore legato al campo mentions non viene mai eseguito.
  • Supporre che un account riceva solo i campi nominati dalla propria sottoscrizione. Meta consegna i campi selezionati per l'app, quindi basa la logica su ciò che contiene ogni evento.
  • Trattare message.referral e un referral di primo livello come un unico evento. Il primo viaggia su messages; il secondo è messaging_referral, per un link ig.me aperto in una conversazione esistente.
  • Attendere story_insights con Instagram Login. Meta lo segna come non disponibile, quindi leggi le metriche di una Storia dall'endpoint insights finché è attiva.
Farlo con EasyCoexistence

Gli eventi non vengono conservati per impostazione predefinita; un account con un'automazione attiva conserva i suoi DM e commenti per 7 giorni. Imposta l'endpoint con set_social_webhook_destination da Claude o ChatGPT, oppure con la Partner API. Da US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.

Domande frequenti

Instagram Login ha un campo webhook mentions?

No, non uno separato. Meta include le menzioni nella notifica dei commenti per Instagram Login; mentions è un campo a sé con Facebook Login e Unified Login.

story_insights è disponibile con Instagram Login?

No. La tabella dei campi di Meta lo segna come non disponibile per Instagram Login, e il riferimento alle metriche dei media dice che il webhook insights non è supportato lì.

Quali permessi richiede il webhook dei messaggi Instagram?

instagram_business_basic e instagram_business_manage_messages, con Advanced Access, che la guida alla configurazione di Meta indica per i webhook di Instagram Login.

Quando Meta ha aggiunto il webhook message_edit per Instagram?

Il 10 settembre 2025, per Business Login for Instagram e Facebook Login for Business. Una modifica arriva nell'array messaging sotto una chiave message_edit.

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