Webhook za komentare na Instagramu: payload, polje po polje
Polje comments webhooka za Instagram obavještava aplikaciju kad netko komentira ili odgovori na komentar na medijima profesionalnog računa, uključujući Reels. Meta šalje promjenu u kojoj je field jednak comments, a vrijednost nosi ID komentara i njegov tekst, Instagram-scoped ID autora i korisničko ime u from, id medija i njegov media_product_type te parent_id kad je komentar odgovor.
easyCoexistence pretplaćuje svaki povezani Instagram račun na comments i prosljeđuje događaje comments koje Meta isporuči za njega na vaš HTTPS endpoint čim stignu, potpisane tajnom tog računa i bez spremanja kopije.
Prisutno kad je komentar odgovor i sadrži ID komentara na koji odgovara.
Dodaje se polje from kad račun komentira vlastite medije, uz vlastiti ID.
Zasebno polje za komentare tijekom Live emitiranja; obavijesti prestaju kad emitiranje završi.
Potreban za obavijesti comments i live_comments; mediji privatnih računa ne šalju nijednu.
Vrijeme koje preostaje za jedan privatni odgovor komentatoru, upućen na ID komentara.
Kada se aktivira polje comments?
Kad netko komentira medije koje profesionalni račun posjeduje ili spomene račun, jednom kad su aplikacija i račun pretplaćeni na polje. Svaki komentar je jedna promjena u obavijesti, a ovi slučajevi dijele isti oblik:
- Novi komentar na objavi, Reelu, Storyju ili oglasu, s media.
media_product_typekoji kaže na kojoj je površini medij. - Odgovor ispod postojećeg komentara, koji nosi
parent_ids ID-om komentara na koji odgovara. - Komentar koji račun ostavi na vlastitim medijima, uključujući odgovore: from.id je vlastiti ID računa, a from dodaje
self_ig_scoped_id. - Spominjanje računa (@mention): uz Instagram Login, Meta uključuje spominjanja u obavijest o komentarima umjesto u zasebno polje.
- Komentar tijekom Live emitiranja dolazi na zasebno polje
live_comments, s istim oblikom vrijednosti, i prestaje kad emitiranje završi.
Kako izgleda obavijest o komentarima?
POST zahtjev čiji JSON ima object postavljen na instagram i niz entry. Svaki entry je jedan profesionalni račun: njegov ID, vrijeme kad je Meta poslala obavijest i niz changes s jednom promjenom po komentaru. Odgovor na Reelu izgleda ovako:
{
"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"
}
}
}
]
}
]
}Što znači svako polje?
Polja koja Metina referenca webhooka navodi za komentar, od vanjskih prema unutarnjima:
- entry[].id: profesionalni ID računa,
user_idkoji /me vraća za njega. Pokazuje kojem računu komentar pripada. - entry[].time: kad je Meta poslala obavijest, kao Unix vremenska oznaka. Nije to kad je komentar napisan.
- changes[].field: comments, ili
live_commentsza Live emitiranje. Provjerite ga prije čitanja value. - value.id: ID komentara, onaj na koji odgovarate javno ili privatno, koji sakrijete ili brišete.
- value.text: tekst komentara, uključen kad komentar ima tekst.
- value.from.id i value.from.username: Instagram-scoped ID autora i korisničko ime. value.from.
self_ig_scoped_idse pojavljuje kad je sam račun napisao komentar. - value.media.id i value.media.
media_product_type: medij na koji je komentar ostavljen i njegova površina; Metina referenca za medije navodi AD, FEED, STORY i REELS. - value.
parent_id: na odgovoru, ID komentara na koji odgovara. Komentar najviše razine ga nema. - value.media.
ad_id,ad_titleioriginal_media_id: navedeni u referenci za komentare ostavljene na oglasu.
Što polje comments ne prijavljuje?
Neke stvari koje bi obrađivač mogao očekivati izostavljene su iz događaja ili se nikad ne šalju, prema Metinom vodiču za postavljanje i referencama:
- Komentari na medijima privatnog računa: Meta za njih ne šalje obavijesti o komentarima ni spominjanjima.
- ID-ovi albuma: događaj ih ne uključuje, a Meta preporučuje da album potražite pomoću ID-a komentara.
- ID-ovi oglasa za medije korišteni u dinamičkim oglasima.
- Vrijeme nastanka komentara: GET /<
COMMENT_ID>?fields=timestamp ga vraća u ISO 8601 formatu. - Komentari uživo nakon završetka emitiranja, kad obavijesti za Live medije prestaju.
- Spominjanja u Storyjima, koja Metin API za spominjanja ne podržava; umjesto toga do računa stižu kao DM.
- Prošli događaji: Meta ne čuva povijest obavijesti za upite, pa spremite što trebate kako svaka stiže.
Što polje comments treba?
Uz Instagram Login, dozvole instagram_business_basic i instagram_business_manage_comments te Advanced Access, koji Meta zahtijeva za obavijesti comments i live_comments. Aplikacija mora biti u Live načinu rada i pretplaćena na comments u App Dashboardu, a svaki račun mora biti pretplaćen putem POST /<IG_ID>/subscribed_apps s comments među subscribed_fields. Meta snažno preporučuje ovaj webhook umjesto periodičnog provjeravanja komentara, jer štedi ograničenje učestalosti zahtjeva.
Kako odgovoriti na komentar iz događaja?
Pomoću ID-ova koje sadrži. POST /<COMMENT_ID>/replies s message objavljuje javni odgovor ispod komentara, koristeći value.id. POST /<IG_ID>/messages s recipient.comment_id postavljenim na value.id šalje autoru jedan privatni odgovor, unutar 7 dana od komentara, ili dok traje Live emitiranje. from.id je Instagram-scoped ID, ali DM poslan izravno na njega ne uspijeva dok osoba ne piše računu, pa je privatni odgovor način da se do njih dođe DM-om.
Kako easyCoexistence prosljeđuje komentar?
Čim stigne, nakon što se za račun postavi endpoint pomoću set_social_webhook_destination iz Clauda ili ChatGPT-ja, ili pomoću PUT /channels/:id/webhook na Partner API-ju. easyCoexistence pretplaćuje svaki povezani račun na polja koja nose njegove komentare, spominjanja i DM-ove, provjerava Metin potpis na svakoj isporuci, odmah odgovara Meti i šalje svaki entry za taj račun na vaš HTTPS URL u omotnici:
- platform i
external_id: instagram te ID računa na Instagramu, jednak entry.id. account_id: ID veze u easyCoexistenceu, onaj koji vraćalist_social_accountsi koji uzimaju MCP alati.- entry: Metin entry za račun, nepromijenjen, pa se grupna isporuka pretvara u jedan POST po entryju. Metino polje object i X-Hub-Signature-256 se ne prosljeđuju.
- Isporuka: jedan pokušaj, čekanje do 8 sekundi, bez praćenja preusmjeravanja, na HTTPS adresu koja se razrješava u javnu IP adresu. Ne čuva se nikakva kopija, a ništa se ne ponavlja.
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" }
}
}
]
}
}Što pravila komentar-u-DM rade s istim događajem?
Čitaju ga uz prosljeđivanje. Pravilo se podudara kad komentar sadrži jednu od njegovih ključnih riječi, bez obzira na velika i mala slova, na jednoj odabranoj objavi ili na svim objavama, i autoru šalje DM pravila kao privatni odgovor, plus javni odgovor ako pravilo ima jedan. Komentari samog računa se preskaču, automatizacije koje se pokreću na komentaru preuzimaju one na koje nijedno pravilo nije odgovorilo, a komentar na koji je pravilo odgovorilo i dalje stiže na vaš endpoint. Javni odgovor pravila može se vratiti kao novi događaj comments od samog računa.
Uobičajene pogreške
- Traženje comment_id. Uz Instagram Login ID komentara je u value.id; comment_id pripada payloadima Metinih drugih načina prijave.
- Odgovaranje na vlastite komentare računa. Njegovi odgovori stižu kao događaji comments s from.id jednakim entry.id, pa automatizacija koja im odgovara završi razgovarajući sama sa sobom.
- Čitanje entry.time kao vremena komentara. Ono bilježi kad je Meta poslala obavijest; vlastita vremenska oznaka komentara pokazuje kad je napisan.
- Čekanje komentara uživo na polju comments. Oni stižu na live_comments, koje treba vlastitu pretplatu i utihne kad emitiranje završi.
Pravila komentar-u-DM i automatizacije odgovaraju na iste komentare neprekidno. US$ 9 do US$ 0,75 mjesečno po vezi, a cijena pada kako dodajete veze, s besplatnim probnim razdobljem od prvih 3 dana.
Često postavljana pitanja
Uključuje li webhook za komentare na Instagramu odgovore na komentare?
Da. Odgovor stiže kao zaseban događaj comments, a parent_id sadrži ID komentara na koji odgovara.
Pokreću li komentari na Reelsima webhook za komentare na Instagramu?
Da. Komentar na Reelu dolazi na polju comments kao i onaj na objavi, a media.media_product_type razlikuje ta dva.
Zašto se moj webhook za komentare na Instagramu ne aktivira?
Najčešće aplikacija nije u Live načinu rada ili nema Advanced Access, račun nikad nije pretplaćen putem /subscribed_apps, medij pripada privatnom računu ili je komentar bio na Liveu, koji koristi live_comments.
Uključuje li webhook za komentare korisničko ime onoga tko je komentirao?
Da. value.from nosi korisničko ime osobe uz njezin Instagram-scoped ID, pa nije potreban dodatni poziv da se prikaže tko je komentirao.
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