Webhook-ul pentru comentarii Instagram: payload-ul, câmp cu câmp
Câmpul comments al webhook-ului Instagram anunță o aplicație când cineva comentează sau răspunde unui comentariu de pe media unui cont profesional, inclusiv Reels. Meta trimite o modificare în care câmpul este setat la comments, iar valoarea conține ID-ul comentariului și textul acestuia, ID-ul Instagram-scoped și numele de utilizator al autorului din from, ID-ul mediei și tipul ei de produs, plus parent_id atunci când comentariul este un răspuns.
easyCoexistence abonează fiecare cont Instagram conectat la comments și trimite evenimentele comments pe care Meta le livrează pentru el către endpoint-ul dumneavoastră HTTPS, pe măsură ce sosesc, semnate cu secretul acelui cont și fără a păstra vreo copie.
Prezent când comentariul este un răspuns, cu ID-ul comentariului la care răspunde.
Completat cu from când contul comentează pe propria media, lângă ID-ul contului.
Câmp separat pentru comentariile din timpul unei transmisiuni Live; notificările lui se opresc când transmisiunea se încheie.
Cerut pentru notificările comments și live_comments; media conturilor private nu generează nicio notificare.
Timp rămas pentru a trimite unui comentator un singur răspuns privat, adresat prin ID-ul comentariului.
Când se declanșează câmpul comments?
Când cineva comentează pe media deținută de contul profesional sau menționează contul, odată ce aplicația și contul sunt abonate ambele la câmp. Fiecare comentariu este o modificare în notificare, iar aceste cazuri au aceeași structură:
- Un comentariu nou la o postare, un Reel, o Story sau o reclamă, cu media.
media_product_typecare arată pe ce suprafață se află media. - Un răspuns sub un comentariu existent, care poartă
parent_idcu ID-ul comentariului la care răspunde. - Un comentariu pe care contul îl face la propria media, inclusiv răspunsurile sale: from.id este ID-ul contului, iar from adaugă
self_ig_scoped_id. - O mențiune a contului prin @: cu Instagram Login, Meta include mențiunile în notificarea de comentarii, în loc de un câmp propriu.
- Un comentariu în timpul unei transmisiuni Live vine pe un câmp separat,
live_comments, cu aceeași formă a valorii, și se oprește când transmisiunea se încheie.
Cum arată o notificare de comentarii?
Un POST al cărui JSON are object setat la instagram și un array entry. Fiecare intrare este un cont profesional: ID-ul său, momentul în care Meta a trimis notificarea și un array changes cu câte o modificare pentru fiecare comentariu. Un răspuns la un Reel arată astfel:
{
"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"
}
}
}
]
}
]
}Ce înseamnă fiecare câmp?
Câmpurile pe care le listează referința webhook a Meta pentru un comentariu, de la exterior spre interior:
- entry[].id: ID-ul contului profesional,
user_idpe care îl returnează /me pentru acesta. Vă spune de ce cont aparține comentariul. - entry[].time: momentul în care Meta a trimis notificarea, ca timestamp Unix. Nu este momentul în care a fost scris comentariul.
- changes[].field: comments sau
live_commentspentru o transmisiune Live. Verificați-l înainte de a citi value. - value.id: ID-ul comentariului, cel la care răspundeți public sau privat, pe care îl puteți ascunde sau șterge.
- value.text: textul comentariului, inclus când comentariul are text.
- value.from.id și value.from.username: ID-ul Instagram-scoped și numele de utilizator al autorului. value.from.
self_ig_scoped_idapare când contul însuși a scris comentariul. - value.media.id și value.media.
media_product_type: media comentată și suprafața ei; referința Meta pentru media numește AD, FEED, STORY și REELS. - value.
parent_id: la un răspuns, ID-ul comentariului la care răspunde. Un comentariu de nivel superior nu are. - value.media.
ad_id,ad_titleșioriginal_media_id: listate în referință pentru comentariile făcute la o reclamă.
Ce nu raportează câmpul comments?
Câteva lucruri pe care un handler le-ar putea aștepta sunt lăsate afară din eveniment sau nu sunt trimise niciodată, potrivit ghidului de configurare și referințelor Meta:
- Comentariile la media deținută de un cont privat: Meta nu trimite pentru ele notificări de comentarii sau mențiuni.
- ID-urile albumelor: evenimentul nu le include, iar Meta recomandă să căutați albumul cu ID-ul comentariului.
- ID-urile reclamelor pentru media folosită în reclame dinamice.
- Momentul creării comentariului: GET /<
COMMENT_ID>?fields=timestamp îl returnează în format ISO 8601. - Comentariile Live după încheierea transmisiunii, când notificările pentru media live se opresc.
- Mențiunile din Story, pe care API-ul de mențiuni al Meta nu le acceptă; ajung în schimb la cont ca mesaje directe (DM).
- Evenimentele trecute: Meta nu păstrează un istoric de notificări pe care să îl interogați, așa că stocați ce aveți nevoie pe măsură ce sosește fiecare.
Ce are nevoie câmpul comments?
Cu Instagram Login, permisiunile instagram_business_basic și instagram_business_manage_comments și Advanced Access, pe care Meta îl cere pentru notificările comments și live_comments. Aplicația trebuie să fie Live și abonată la comments în App Dashboard, iar fiecare cont trebuie abonat prin POST /<IG_ID>/subscribed_apps cu comments printre subscribed_fields. Meta recomandă insistent acest webhook în locul interogării repetate (polling) pentru comentarii, deoarece scutește de limita de rată.
Cum răspundeți la un comentariu din eveniment?
Cu ID-urile pe care le transportă. POST /<COMMENT_ID>/replies cu un message postează un răspuns public sub comentariu, folosind value.id. POST /<IG_ID>/messages cu recipient.comment_id setat la value.id trimite autorului un singur răspuns privat, în 7 zile de la comentariu sau cât durează transmisiunea, dacă e Live. from.id este un ID Instagram-scoped, dar un DM trimis direct la el eșuează până când persoana nu a scris contului, așa că răspunsul privat este modalitatea de a ajunge la ea prin DM.
Cum transmite easyCoexistence un comentariu?
Pe măsură ce sosește, odată ce este setat un endpoint pentru cont cu set_social_webhook_destination din Claude sau ChatGPT, sau cu PUT /channels/:id/webhook pe API-ul Partner. easyCoexistence abonează fiecare cont conectat la câmpurile care transportă comentariile, mențiunile și DM-urile sale, verifică semnătura Meta la fiecare livrare, răspunde Meta imediat și trimite prin POST fiecare intrare a contului către URL-ul dumneavoastră HTTPS, într-un plic:
- platform și
external_id: instagram, și ID-ul Instagram al contului, egal cu entry.id. account_id: ID-ul conexiunii în easyCoexistence, cel pe care îl returneazălist_social_accountsși îl folosesc instrumentele MCP.- entry: intrarea Meta pentru cont, neschimbată, astfel încât o livrare grupată devine câte un POST pentru fiecare intrare. Câmpul object al Meta și X-Hub-Signature-256 nu sunt transmise mai departe.
- Livrare: o singură încercare, cu așteptare de până la 8 secunde, fără a urma redirecționări, către o adresă HTTPS care se rezolvă într-un IP public. Nu se păstrează nicio copie și nu se reîncearcă nimic.
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" }
}
}
]
}
}Ce fac regulile comentariu-către-DM cu același eveniment?
Ele citesc evenimentul alături de redirecționare. O regulă se potrivește când comentariul conține unul dintre cuvintele cheie ale sale, fără a ține cont de majuscule, pe o anumită postare sau pe toate, și trimite autorului DM-ul regulii ca răspuns privat, plus un răspuns public dacă regula are unul. Comentariile făcute de contul însuși sunt sărite, automatizările care pornesc dintr-un comentariu preiau cele la care nicio regulă nu a răspuns, iar un comentariu la care a răspuns o regulă ajunge totuși la endpoint-ul dumneavoastră. Răspunsul public al regulii poate reveni ca un nou eveniment comments din partea contului însuși.
Greșeli frecvente
- Căutarea lui comment_id. Sub Instagram Login, ID-ul comentariului este în value.id; comment_id aparține payload-urilor celorlalte configurări de autentificare ale Meta.
- Răspunsul la propriile comentarii ale contului. Răspunsurile sale revin ca evenimente comments cu from.id egal cu entry.id, iar o automatizare care le răspunde ajunge să vorbească cu ea însăși.
- Citirea lui entry.time drept momentul comentariului. Acesta înregistrează când a trimis Meta notificarea; câmpul de timestamp al comentariului în sine arată când a fost scris.
- Așteptarea comentariilor Live pe câmpul comments. Ele sosesc pe live_comments, care are nevoie de propriul abonament și amuțește când transmisiunea se încheie.
Regulile comentariu-către-DM și automatizările răspund acelorași comentarii non-stop. De la US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Webhook-ul de comentarii Instagram include răspunsurile la comentarii?
Da. Un răspuns sosește ca propriu eveniment comments, cu parent_id care conține ID-ul comentariului la care răspunde.
Comentariile de pe Reels declanșează webhook-ul de comentarii Instagram?
Da. Un comentariu la un Reel vine pe câmpul comments ca unul de la o postare, iar media.media_product_type deosebește cele două.
De ce nu se declanșează webhook-ul meu de comentarii Instagram?
Cel mai adesea aplicația nu este Live sau nu are Advanced Access, contul nu a fost abonat niciodată prin /subscribed_apps, media aparține unui cont privat sau comentariul era la o transmisiune Live, care folosește live_comments.
Include webhook-ul de comentarii numele de utilizator al comentatorului?
Da. value.from conține numele de utilizator al persoanei alături de ID-ul ei Instagram-scoped, așa că nu este nevoie de niciun apel suplimentar ca să se afle cine a comentat.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la