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.
Polja na koja se novi Instagram proizvod u App Dashboardu u početku pretplaćuje, među njima comments, messages i message_reactions.
Polja se biraju za aplikaciju, ne po računu: račun prima polja koja je aplikacija odabrala.
Razina pristupa koju Metin vodič za postavljanje navodi za webhookove uz Instagram Login, a traži se za obavijesti o comments i live_comments.
Označeno kao nedostupno za Instagram Login u Metinoj tablici polja, koja ga nudi uz Facebook Login i Unified Login.
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.
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 iinstagram_manage_insights. Metina referenca za media insights kaže da webhook insights nije podržan uz Instagram Login.messaging_policy_enforcementiresponse_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.
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_echopostavljen 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_controlilirequest_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.
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