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

Instagram webhook polja: potpuni popis

Za profesionalni račun uz Instagram Login, Metina tablica polja za webhookove navodi comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover i standby, a mentions se isporučuje unutar comments; njezini primjeri navode i message_edit. Svako od njih zahtijeva instagram_business_basic te instagram_business_manage_comments ili, za većinu polja poruka, instagram_business_manage_messages. story_insights se ne nudi uz Instagram Login.

easyCoexistence pretplaćuje svaki povezani Instagram račun na comments, messages i mentions te prosljeđuje te događaje na vaš HTTPS endpoint čim stignu, potpisane tajnim ključem tog računa.

8

Polja na koja se novi Instagram proizvod u App Dashboardu u početku pretplaćuje, među njima comments, messages i message_reactions.

Per app

Polja se biraju za aplikaciju, ne po računu: račun prima polja koja je aplikacija odabrala.

Advanced Access

Razina pristupa koju Metin vodič za postavljanje navodi za webhookove uz Instagram Login, a traži se za obavijesti o comments i live_comments.

story_insights

Označeno kao nedostupno za Instagram Login u Metinoj tablici polja, koja ga nudi uz Facebook Login i Unified Login.

10 Sep 2025

Kada je Meta uvela webhook message_edit za Business Login for Instagram i Facebook Login for Business.

Koja webhook polja nudi Instagram Login?

Evo ih iz Metine tablice polja, uz ono što pokreće svako od njih, preuzeto iz primjera i reference za webhookove. Uz dozvolu prikazanu za svako polje potrebna je i instagram_business_basic, a Meta za obavijesti o comments i live_comments traži Advanced Access.

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.

Koja polja Instagram Login ne nudi?

Tri retka Metine tablice polja nemaju dozvolu za Instagram Login, pa aplikacija uz Instagram Login ne prima ta polja, a jedno polje postoji samo izvan nje:

  • story_insights: metrike priče kad istekne, uz Facebook Login ili Unified Login i instagram_manage_insights. Metina referenca za media insights kaže da webhook insights nije podržan uz Instagram Login.
  • messaging_policy_enforcement i response_feedback: samo u stupcu za Metin Instagram Messaging API.
  • mentions kao zasebno polje: Facebook Login i Unified Login ga navode, uz instagram_manage_comments, dok Instagram Login mentions uključuje u comments.

Kako se pretplaćuju polja?

Na dva mjesta. U App Dashboardu, pod postavkama webhooka Instagram proizvoda, spremi callback URL i verify token, čime Meta pokreće svoj zahtjev za provjeru, zatim odaberi polja; novi Instagram proizvod u početku je pretplaćen na osam njih. Zatim pretplati svaki račun pomoću POST /<IG_ID>/subscribed_apps na graph.instagram.com, s subscribed_fields postavljenim na polja odabrana u nadzornoj ploči, odvojena zarezima.

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 }

Može li svaki račun dobiti različita polja?

Ne. Metin vodič za postavljanje kaže da se polja ne mogu birati za svakog korisnika aplikacije: račun prima polja odabrana za aplikaciju. subscribed_fields u pretplati računa treba navoditi polja iz nadzorne ploče, pa rukovatelj treba očekivati bilo koje polje koje je aplikacija odabrala i odlučiti prema tome što svaki događaj sadrži, a ne prema tome što je jedan račun zatražio.

Kako se polja razlikuju u obavijesti?

Prema obliku zapisa. Polja za komentare stižu u nizu changes, pri čemu svaka promjena imenuje svoje polje. Polja poruka stižu u nizu messaging bez naziva polja, a ključ uz sender, recipient i timestamp ih razlikuje:

  • changes[].field: comments ili live_comments, s komentarom u value.
  • message: messages, uključujući odjeke poruka računa, koji imaju is_echo postavljen na true.
  • reaction: message_reactions. postback: messaging_postbacks. read: messaging_seen. message_edit: message_edit.
  • referral uz sender: messaging_referral. Referral unutar message pripada messages, iz nove niti ili Click-to-Direct oglasa.
  • pass_thread_control, take_thread_control ili request_thread_control: messaging_handover, kako navodi Metina referenca za webhookove.

Koja polja easyCoexistence pretplaćuje?

comments, messages i mentions, popis na koji se svaki Instagram račun pretplaćuje kad se poveže. Uz Instagram Login mentions dolazi unutar comments, pa se pretplata odnosi na comments i DM-ove, a među DM-ovima su odjeci, odgovori na priče, spominjanja u pričama i privitci. Ostala polja iz tablice Meta isporučuje aplikaciji koja su na njih pretplaćena i nisu dio pretplate veze. Kad se odredište postavi pomoću set_social_webhook_destination ili Partner API, easyCoexistence provjerava Metin potpis, odmah odgovara Meti i za svaki unos računa šalje POST na njega:

  • platform i external_id: instagram, i Instagram ID računa, jednak entry.id.
  • account_id: ID veze u easyCoexistence, onaj koji uzimaju MCP alati.
  • entry: Metin entry za račun, nepromijenjen. Metino polje object i zaglavlje X-Hub-Signature-256 se ne prosljeđuju.
  • X-EC-Signature: t=<unix>,v1=<hex>, HMAC-SHA256 vremenske oznake, točke i sirovog tijela, s tajnim ključem samog računa.
  • Isporuka: jedan pokušaj s trajanjem do 8 sekundi, bez praćenja preusmjeravanja, bez zadržane kopije i bez ponovnih pokušaja.

Uobičajene pogreške

  • Čekanje polja mentions uz Instagram Login. Meta spaja mentions u obavijest o comments, pa rukovatelj vezan uz polje mentions nikad ne radi.
  • Pretpostavka da račun dobiva samo polja koja je navela njegova pretplata. Meta isporučuje polja odabrana za aplikaciju, pa grananje treba raditi prema tome što svaki događaj sadrži.
  • Izjednačavanje message.referral i referral na vrhu kao jednog događaja. Prvo ide uz messages; drugo je messaging_referral, za ig.me poveznicu otvorenu u postojećem razgovoru.
  • Čekanje story_insights uz Instagram Login. Meta ga tamo označava kao nedostupno, pa metrike priče čitaj iz insights endpointa dok je priča aktivna.
Radite ovo uz EasyCoexistence

Događaji se prema zadanim postavkama ne pohranjuju; račun s uključenom automatizacijom zadržava svoje DM-ove i komentare 7 dana. Odredište postavite pomoću set_social_webhook_destination iz Claudea ili ChatGPT-ja ili putem Partner API-ja. Od US$ 9 do US$ 0.75 po vezi mjesečno, cijena pada kako dodajete veze, uz besplatno probno razdoblje od 3 dana.

Često postavljana pitanja

Ima li Instagram Login zasebno webhook polje za mentions?

Ne. Meta uključuje mentions u obavijest o comments za Instagram Login; mentions je zasebno polje uz Facebook Login i Unified Login.

Je li story_insights dostupan uz Instagram Login?

Ne. Metina tablica polja ga označava kao nedostupno za Instagram Login, a njezina referenca za media insights kaže da webhook insights tamo nije podržan.

Koje dozvole treba webhook za poruke na Instagramu?

instagram_business_basic i instagram_business_manage_messages, uz Advanced Access, koji Metin vodič za postavljanje navodi za webhookove uz Instagram Login.

Kada je Meta dodala webhook message_edit za Instagram?

10. rujna 2025., za Business Login for Instagram i Facebook Login for Business. Uređivanje stiže u nizu messaging pod ključem message_edit.

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