Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

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.

parent_id

Prisutno kad je komentar odgovor i sadrži ID komentara na koji odgovara.

self_ig_scoped_id

Dodaje se polje from kad račun komentira vlastite medije, uz vlastiti ID.

live_comments

Zasebno polje za komentare tijekom Live emitiranja; obavijesti prestaju kad emitiranje završi.

Advanced Access

Potreban za obavijesti comments i live_comments; mediji privatnih računa ne šalju nijednu.

7 days

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_type koji kaže na kojoj je površini medij.
  • Odgovor ispod postojećeg komentara, koji nosi parent_id s 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:

A comments notification, as Meta sends it
{
  "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_id koji /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_comments za 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_id se 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_title i original_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ća list_social_accounts i 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.
A forwarded comment, headers included
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.
Radite ovo uz EasyCoexistence

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