Instagram-kommenttien webhook: payload kenttä kerrallaan
Instagramin kommenttien webhook ilmoittaa sovellukselle, kun joku kommentoi ammattitilin mediaa tai vastaa kommenttiin, Reelsit mukaan lukien. Meta lähettää muutoksen, jossa field on comments. Sen value sisältää kommentin ID:n ja tekstin, tekijän Instagram-kohtaisen ID:n ja käyttäjänimen kentässä from, median ID:n ja tuotetyypin sekä parent_id:n, kun kyseessä on vastaus.
easyCoexistence tilaa jokaisen yhdistetyn Instagram-tilin kommentteihin ja välittää Metan toimittamat comments-tapahtumat tilin osalta HTTPS-päätepisteeseesi heti, kun ne saapuvat.
Läsnä silloin, kun kommentti on vastaus, ja sisältää sen kommentin ID:n, johon se vastaa.
Lisätään kenttään from, kun tili kommentoi omaa mediaansa, tilin oman ID:n viereen.
Erillinen kenttä Live-lähetyksen kommenteille; sen ilmoitukset loppuvat lähetyksen päättyessä.
Vaaditaan comments- ja live_comments-ilmoituksiin; yksityisen tilin omistamasta mediasta ei synny ilmoituksia.
Aika, jonka aikana kommentoijalle voi lähettää yhden yksityisen vastauksen, osoitettuna kommentin ID:llä.
Milloin comments-kenttä laukeaa?
Kun joku kommentoi ammattitilin omistamaa mediaa tai mainitsee tilin, kun sekä sovellus että tili on tilattu kenttään. Jokainen kommentti on yksi muutos ilmoituksessa, ja nämä tapaukset jakavat saman muodon:
- Uusi kommentti julkaisussa, Reelsissä, Storyssa tai mainoksessa. media.
media_product_typekertoo, mihin pintaan media kuuluu. - Vastaus olemassa olevaan kommenttiin, jossa on
parent_idsen kommentin ID:llä, johon se vastaa. - Tilin oman median kommentti, myös sen vastaukset: from.id on tilin oma ID, ja from saa lisäkentän
self_ig_scoped_id. - Instagram Login -kirjautumisessa Meta sisällyttää maininnat comments-ilmoitukseen eikä niille omaan kenttään.
- Live-lähetyksen aikana tuleva kommentti tulee erilliseen kenttään
live_commentssamalla arvomuodolla ja loppuu lähetyksen päätyttyä.
Miltä kommentti-ilmoitus näyttää?
POST-pyyntö, jonka JSON-sisällössä object on instagram ja taulukko entry. Jokainen entry on yksi ammattitili: sen ID, aika jolloin Meta lähetti ilmoituksen, ja changes-taulukko, jossa on yksi muutos kommenttia kohden. Vastaus Reelsiin näyttää tältä:
{
"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"
}
}
}
]
}
]
}Mitä kukin kenttä tarkoittaa?
Kentät, jotka Metan webhook-viite listaa kommentille, ulkoa sisäänpäin:
- entry[].id: ammattitilin ID, eli
user_id, jonka /me palauttaa sille. Se kertoo, mihin tiliin kommentti kuuluu. - entry[].time: milloin Meta lähetti ilmoituksen, Unix-aikaleimana. Se ei ole aika, jolloin kommentti kirjoitettiin.
- changes[].field: comments tai
live_commentsLive-lähetystä varten. Tarkista se ennen value-kentän lukemista. - value.id: kommentin ID, jolla vastataan julkisesti tai yksityisesti, piilotetaan tai poistetaan.
- value.text: kommentin teksti, mukana kun kommentissa on tekstiä.
- value.from.id ja value.from.username: tekijän Instagram-kohtainen ID ja käyttäjänimi. value.from.
self_ig_scoped_idilmestyy, kun tili itse kirjoitti kommentin. - value.media.id ja value.media.
media_product_type: kommentoitu media ja sen pinta. Metan media-viite nimeää AD, FEED, STORY ja REELS. - value.
parent_id: vastauksessa sen kommentin ID, johon se vastaa. Ylätason kommentilla sitä ei ole. - value.media.
ad_id,ad_titlejaoriginal_media_id: viite listaa ne mainokseen tehdyille kommenteille.
Mitä comments-kenttä ei raportoi?
Muutamia asioita, joita käsittelijä voisi odottaa, jää tapahtumasta pois tai niitä ei lähetetä lainkaan, Metan asennusohjeen ja viitteiden mukaan:
- Yksityisen tilin omistamaan mediaan tehdyt kommentit: Meta ei lähetä niistä kommentti- eikä maininta-ilmoituksia.
- Albumi-ID:t: tapahtuma ei sisällä niitä, ja Meta neuvoo hakemaan albumin kommentin ID:llä.
- Dynaamisissa mainoksissa käytetyn median mainos-ID:t.
- Kommentin luontiaika: GET /<
COMMENT_ID>?fields=timestamp palauttaa sen ISO 8601 -muodossa. - Live-kommentit lähetyksen päätyttyä, kun live-median ilmoitukset loppuvat.
- Story-maininnat, joita Metan mentions-rajapinta ei tue. Ne saapuvat tilille DM-viesteinä.
- Menneet tapahtumat: Meta ei säilytä ilmoitushistoriaa kyselyitä varten, joten tallenna tarvitsemasi heti, kun jokainen saapuu.
Mitä comments-kenttä tarvitsee?
Instagram Login -kirjautumisella oikeudet instagram_business_basic ja instagram_business_manage_comments sekä Advanced Access, jonka Meta vaatii comments- ja live_comments-ilmoituksiin. Sovelluksen pitää olla Live-tilassa ja tilattu kommentteihin Metan sovelluksen hallintapaneelissa. Jokainen tili on tilattava POST /<IG_ID>/subscribed_apps -pyynnöllä, jossa comments on subscribed_fields-kentässä. Meta suosittelee tätä webhookia kyselyn sijaan kommenteille vahvasti, koska se säästää kutsurajoitusta.
Miten vastaat kommenttiin tapahtumasta?
Sen mukana tulevilla ID:illä. POST /<COMMENT_ID>/replies viestillä lähettää julkisen vastauksen kommentin alle käyttäen value.id:tä. POST /<IG_ID>/messages, jossa recipient.comment_id on value.id, lähettää tekijälle yhden yksityisen vastauksen 7 päivän sisällä kommentista tai Live-lähetyksen ajan. from.id on Instagram-kohtainen ID, mutta suora DM sille epäonnistuu, kunnes henkilö on viestitellyt tilille. Siksi yksityinen vastaus on tapa tavoittaa hänet DM:llä.
Miten easyCoexistence välittää kommentin?
Heti kun se saapuu, kunhan päätepiste on asetettu tilille set_social_webhook_destination-työkalulla Claudesta tai ChatGPT:stä, tai PUT /channels/:id/webhook -kutsulla Partner API:ssa. easyCoexistence tilaa jokaisen yhdistetyn tilin kenttiin, joissa kulkevat sen kommentit, maininnat ja DM-viestit, tarkistaa Metan allekirjoituksen jokaisesta toimituksesta, vastaa Metalle heti ja lähettää jokaisen tilin entryn POST-pyyntönä HTTPS-osoitteeseesi kuoressa:
- platform ja
external_id: instagram, ja tilin Instagram-ID, joka on sama kuin entry.id. account_id: yhteyden ID easyCoexistencessa, sama jonkalist_social_accountspalauttaa ja MCP-työkalut ottavat.- entry: Metan entry tilille muuttumattomana, joten erätoimitus muuttuu yhdeksi POST-pyynnöksi entryä kohden. Metan object-kenttää ja X-Hub-Signature-256-otsaketta ei välitetä eteenpäin.
- Toimitus: tehdään kerran, odotetaan enintään 8 sekuntia, ilman uudelleenohjauksia HTTPS-osoitteeseen, joka ratkeaa julkiseksi IP-osoitteeksi. Kopiota ei säilytetä, eikä toimitusta yritetä uudelleen.
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" }
}
}
]
}
}Mitä kommentista DM:ksi -säännöt tekevät samalle tapahtumalle?
Ne lukevat tapahtuman rinnakkain välityksen kanssa. Sääntö täsmää, kun kommentti sisältää jonkin sen avainsanoista kirjainkoosta välittämättä, valitussa julkaisussa tai kaikissa julkaisuissa. Se lähettää tekijälle säännön DM:n yksityisenä vastauksena, sekä julkisen vastauksen, jos säännössä on sellainen. Tilin omat kommentit ohitetaan. Kommentilla käynnistyvät automaatiot ottavat ne, joihin mikään sääntö ei vastannut, ja sääntöön vastattu kommentti saavuttaa silti päätepisteesi. Säännön julkinen vastaus voi palata tilin omana uutena comments-tapahtumana.
Yleiset virheet
- comment_id:n etsiminen. Instagram Login -kirjautumisessa kommentin ID on kentässä value.id. comment_id kuuluu Metan muiden kirjautumisasetusten tapahtumiin.
- Tilin omien kommenttien vastaaminen. Sen vastaukset tulevat takaisin comments-tapahtumina, joissa from.id on sama kuin entry.id, ja automaatio, joka vastaa niihin, päätyy keskustelemaan itsensä kanssa.
- entry.time lukeminen kommentin aikana. Se kertoo, milloin Meta lähetti ilmoituksen. Kommentin oma timestamp-kenttä kertoo, milloin se kirjoitettiin.
- Live-kommenttien odottaminen comments-kentästä. Ne tulevat live_comments-kenttään, joka vaatii oman tilauksen ja hiljenee lähetyksen päätyttyä.
Tapahtumat ovat allekirjoitettuja tilin salaisuudella, eikä kopiota säilytetä. Kommentista DM:ksi -säännöt ja automaatiot vastaavat samoihin kommentteihin ympäri vuorokauden. Hinta on US$ 9:stä US$ 0.75:een yhteydeltä kuukaudessa ja laskee, kun lisäät yhteyksiä. Ensimmäiset 3 päivää ovat ilmaista kokeilua.
Usein kysytyt kysymykset
Sisältääkö Instagramin kommenttien webhook vastaukset kommentteihin?
Kyllä. Vastaus saapuu omana comments-tapahtumanaan, ja parent_id sisältää sen kommentin ID:n, johon se vastaa.
Laukaisevatko Reelsien kommentit Instagramin kommenttien webhookin?
Kyllä. Reelsin kommentti tulee comments-kenttään kuten julkaisun kommentti, ja media.media_product_type erottaa ne toisistaan.
Miksi Instagramin kommenttien webhook ei laukea?
Useimmiten sovellus ei ole Live-tilassa tai sillä ei ole Advanced Accessia, tiliä ei ole koskaan tilattu /subscribed_apps-kutsulla, media kuuluu yksityiselle tilille tai kommentti oli Live-lähetyksessä, joka käyttää live_comments-kenttää.
Sisältääkö kommenttien webhook kommentoijan käyttäjänimen?
Kyllä. value.from kantaa henkilön käyttäjänimen Instagram-kohtaisen ID:n rinnalla, joten erillistä kutsua ei tarvita sen näyttämiseen, kuka kommentoi.
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