Instagram-webhook-kentät: täydellinen luettelo
Ammatillisella tilillä Instagram Loginilla Metan webhook-kenttätaulukko listaa kentät comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover ja standby. Maininnat (mentions) toimitetaan kommenttien sisällä, ja esimerkeissä on lisäksi message_edit. Jokainen kenttä tarvitsee oikeuden instagram_business_basic sekä joko oikeuden instagram_business_manage_comments tai useimmille viestikentille oikeuden instagram_business_manage_messages. story_insights ei ole tarjolla Instagram Loginilla.
easyCoexistence tilaa jokaisen yhdistetyn Instagram-tilin kommentteihin, viesteihin ja mainintoihin ja välittää nämä tapahtumat HTTPS-päätepisteeseesi niiden saapuessa, allekirjoitettuina tilin omalla salaisuudella.
Kentät, joihin uusi Instagram-tuote sovelluksen hallintapaneelissa tilautuu alun perin, joukossa comments, messages ja message_reactions.
Kentät valitaan sovellukselle, ei tilikohtaisesti: tili saa ne kentät, jotka sovellus on valinnut.
Käyttötaso, jonka Metan asennusohje listaa Instagram Loginin webhookeille ja joka vaaditaan comments- ja live_comments-ilmoituksille.
Merkitty Instagram Loginilla saatavilla olemattomaksi Metan kenttätaulukossa, joka tarjoaa sen Facebook Loginilla ja Unified Loginilla.
Kun Meta otti käyttöön message_edit-webhookin Business Login for Instagramille ja Facebook Login for Businessille.
Mitä webhook-kenttiä Instagram Login tarjoaa?
Nämä, Metan kenttätaulukosta, ja kunkin kentän laukaisema tapahtuma on otettu sen esimerkeistä ja webhook-viitteestä. Kukin kenttä tarvitsee näytetyn oikeuden lisäksi myös oikeuden instagram_business_basic, ja Meta vaatii Advanced Accessin comments- ja live_comments-ilmoituksille.
Mitä kenttiä ei ole saatavilla Instagram Loginilla?
Metan kenttätaulukon kolmella rivillä ei ole Instagram Loginin oikeutta, joten Instagram Loginilla toimiva sovellus ei saa niitä, ja yksi kenttä on olemassa vain sen ulkopuolella:
story_insights: storyn mittarit sen vanhentuessa, Facebook Loginilla tai Unified Loginilla ja oikeudellainstagram_manage_insights. Metan media-insights-viite kertoo, ettei insights-webhookia tueta Instagram Loginilla.messaging_policy_enforcementjaresponse_feedback: vain Metan Instagram Messaging API:n sarakkeessa.- mentions omana kenttänään: Facebook Login ja Unified Login listaavat sen oikeudella
instagram_manage_comments, kun taas Instagram Login yhdistää maininnat kommentteihin.
Miten kenttiin tilaudutaan?
Kahdessa paikassa. Sovelluksen hallintapaneelissa Instagram-tuotteen webhook-asetuksissa tallennat callback-URL-osoitteen ja vahvistustunnuksen, mikä käynnistää Metan vahvistuspyynnön, ja valitset sitten kentät. Uusi Instagram-tuote tilautuu alun perin kahdeksaan niistä. Sen jälkeen tilaat jokaisen tilin POST /<IG_ID>/subscribed_apps-pyynnöllä osoitteessa graph.instagram.com, ja subscribed_fields asetetaan pilkuin eroteltuina kenttiin, jotka valittiin hallintapaneelissa.
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
?subscribed_fields=comments,messages,message_reactions
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{ "success": true }Voiko kullekin tilille saada eri kentät?
Ei. Metan asennusohjeen mukaan kenttiä ei voi valita kullekin sovelluksen käyttäjän tilille: tili saa sovellukselle valitut kentät. Tilin subscribed_fields-kentän on tarkoitus listata hallintapaneelin kentät, joten käsittelijän kannattaa odottaa mitä tahansa sovelluksen valitsemaa kenttää ja päättää sen perusteella, mitä kukin tapahtuma sisältää, ei sen perusteella, mitä se pyysi yhdelle tilille.
Miten kentät erotetaan toisistaan ilmoituksessa?
Merkinnän rakenteesta. Kommenttikentät saapuvat changes-taulukossa, ja jokainen muutos nimeää kentän. Viestikentät saapuvat messaging-taulukossa ilman kentän nimeä, ja sender-, recipient- ja timestamp-kenttien vieressä oleva avain erottaa ne toisistaan:
- changes[].field: comments tai
live_comments, kommentti arvossa value. - message: messages, mukaan lukien tilin omien viestien kaiut, joissa
is_echoon asetettu arvoon true. - reaction:
message_reactions. postback:messaging_postbacks. read:messaging_seen.message_edit:message_edit. - referral sender-kentän vieressä:
messaging_referral. Referral message-kentän sisällä kuuluu messages-kenttään, uudesta ketjusta tai Click-to-Direct-mainoksesta. pass_thread_control,take_thread_controltairequest_thread_control:messaging_handover, kuten Metan webhook-viite ne listaa.
Mihin kenttiin easyCoexistence tilaa?
comments, messages ja mentions, luettelo, johon kukin Instagram-tili tilataan yhdistettäessä. Instagram Loginilla maininnat tulevat kommenttien sisällä, joten tilaus kattaa kommentit ja DM-viestit, ja DM-viesteihin kuuluvat kaiut, story-vastaukset, story-maininnat ja liitteet. Taulukon muut kentät Meta toimittaa sovellukselle, joka on tilannut ne, eivätkä ne kuulu yhteyden tilaukseen. Kun päätepiste on asetettu set_social_webhook_destination-työkalulla tai Partner API:lla, easyCoexistence tarkistaa Metan allekirjoituksen, vastaa Metalle heti ja lähettää jokaisen tilin merkinnän sinne:
- platform ja
external_id: instagram ja tilin Instagram-ID, joka on sama kuin entry.id. account_id: yhteyden ID easyCoexistencessa, sama jonka MCP-työkalut ottavat.- entry: Metan merkintä tilille muuttumattomana. Metan object-kenttää ja X-Hub-Signature-256-otsaketta ei välitetä eteenpäin.
- X-EC-Signature: t=<unix>,v1=<hex>, HMAC-SHA256 aikaleimasta, pisteestä ja raakarungosta, avaimena tilin oma salaisuus.
- Toimitus: yksi yritys, enintään 8 sekuntia, ilman uudelleenohjauksia, ilman säilytettyä kopiota ja ilman uusintayrityksiä.
Yleiset virheet
- Mentions-kentän odottaminen Instagram Loginilla. Meta yhdistää maininnat kommenttien ilmoitukseen, joten käsittelijä, joka on sidottu kenttään mentions, ei koskaan käynnisty.
- Oletus, että tili saa vain omaan tilaukseensa nimetyt kentät. Meta toimittaa sovellukselle valitut kentät, joten haarauta sen mukaan, mitä kukin tapahtuma sisältää.
- message.referralin ja ylätason referralin käsittely yhtenä tapahtumana. Ensimmäinen kulkee messages-kentässä; toinen on messaging_referral, ig.me-linkistä, joka avattiin olemassa olevassa keskustelussa.
- story_insights-kentän odottaminen Instagram Loginilla. Meta merkitsee sen Instagram Loginille saatavilla olemattomaksi, joten lue storyn mittarit insights-päätepisteestä niin kauan kuin story on vielä näkyvissä.
Tapahtumia ei säilytetä oletuksena; tili, jolla automaatio on päällä, säilyttää DM-viestit ja kommentit 7 päivää. Aseta päätepiste set_social_webhook_destination-työkalulla Claudesta tai ChatGPT:stä tai Partner API:lla. Hinta on US$ 9:stä US$ 0,75:een yhteydeltä kuukaudessa, ja se laskee yhteyksien määrän kasvaessa. Ensimmäiset 3 päivää ovat ilmaista kokeilua.
Usein kysytyt kysymykset
Onko Instagram Loginilla mentions-webhook-kenttää?
Ei erillistä. Meta sisällyttää maininnat Instagram Loginin kommentti-ilmoitukseen. mentions on oma kenttänsä Facebook Loginilla ja Unified Loginilla.
Onko story_insights saatavilla Instagram Loginilla?
Ei. Metan kenttätaulukko merkitsee sen saatavilla olemattomaksi Instagram Loginille, ja sen media-insights-viite kertoo, ettei insights-webhookia tueta siellä.
Mitä oikeuksia Instagram-viestien webhookille tarvitaan?
instagram_business_basic ja instagram_business_manage_messages, lisäksi Advanced Access, jonka Metan asennusohje listaa Instagram Loginin webhookeille.
Milloin Meta lisäsi message_edit-webhookin Instagramille?
10. syyskuuta 2025, Business Login for Instagramille ja Facebook Login for Businessille. Muokkaus saapuu messaging-taulukossa message_edit-avaimen alla.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu