Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Webhook komentarzy Instagrama: payload, pole po polu

Pole comments webhooka Instagrama informuje aplikację, gdy ktoś skomentuje lub odpowie na komentarz pod mediami profesjonalnego konta, w tym pod Reelsami. Meta wysyła zmianę, w której pole field ma wartość comments, a value zawiera id i tekst komentarza, Instagram-scoped ID autora oraz jego nazwę użytkownika w from, id mediów i ich typ produktu oraz parent_id, gdy komentarz jest odpowiedzią.

easyCoexistence zasubskrybowuje każde podłączone konto Instagram do comments i przekazuje zdarzenia comments, które Meta dostarcza dla tego konta, na twój endpoint HTTPS, gdy tylko nadejdą, podpisane sekretem tego konta i bez zapisywania kopii.

parent_id

Obecne, gdy komentarz jest odpowiedzią, i zawiera ID komentarza, na który odpowiada.

self_ig_scoped_id

Pojawia się w from, gdy konto komentuje własne media, obok jego własnego ID.

live_comments

Osobne pole dla komentarzy podczas transmisji Live; jego powiadomienia ustają po zakończeniu transmisji.

Advanced Access

Wymagane dla powiadomień comments i live_comments; media konta prywatnego nie wywołują żadnego.

7 days

Czas, w którym można wysłać komentującemu jedną prywatną odpowiedź, adresowaną ID komentarza.

Kiedy uruchamia się pole comments?

Gdy ktoś skomentuje media należące do profesjonalnego konta albo wspomni o koncie, po tym jak aplikacja i konto są oba zasubskrybowane do pola. Każdy komentarz to jedna zmiana w powiadomieniu, a te przypadki mają wspólny kształt:

  • Nowy komentarz pod postem, Reelsem, relacją lub reklamą, z media.media_product_type wskazującym powierzchnię, na której są media.
  • Odpowiedź pod istniejącym komentarzem, która zawiera parent_id z ID komentarza, na który odpowiada.
  • Komentarz, który konto napisze pod własnymi mediami, w tym jego odpowiedzi: from.id to własne ID konta, a from dostaje self_ig_scoped_id.
  • Wzmianka o koncie (@mention): przy Instagram Login Meta dołącza wzmianki do powiadomienia comments, zamiast używać osobnego pola.
  • Komentarz podczas transmisji Live przychodzi w osobnym polu live_comments, o tym samym kształcie wartości, i ustaje po zakończeniu transmisji.

Jak wygląda powiadomienie o komentarzu?

POST z JSON-em, w którym object ma wartość instagram, oraz tablicą entry. Każdy wpis to jedno profesjonalne konto: jego ID, czas wysłania powiadomienia przez Meta i tablica changes z jedną zmianą na komentarz. Odpowiedź na Reelsa wygląda tak:

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"
            }
          }
        }
      ]
    }
  ]
}

Co oznacza każde pole?

Pola, które dokumentacja webhooków Meta podaje dla komentarza, od zewnątrz do środka:

  • entry[].id: ID profesjonalnego konta, czyli user_id, które zwraca /me dla tego konta. Mówi, do którego konta należy komentarz.
  • entry[].time: moment wysłania powiadomienia przez Meta w formacie Unix timestamp. To nie czas napisania komentarza.
  • changes[].field: comments albo live_comments dla transmisji Live. Sprawdź je, zanim przeczytasz value.
  • value.id: ID komentarza, na który odpowiadasz publicznie lub prywatnie, który ukrywasz lub usuwasz.
  • value.text: tekst komentarza, obecny, gdy komentarz zawiera tekst.
  • value.from.id i value.from.username: Instagram-scoped ID autora i jego nazwa użytkownika. value.from.self_ig_scoped_id pojawia się, gdy komentarz napisało samo konto.
  • value.media.id i value.media.media_product_type: komentowane media i ich powierzchnia; dokumentacja Meta dla mediów wymienia AD, FEED, STORY i REELS.
  • value.parent_id: przy odpowiedzi ID komentarza, na który odpowiada. Komentarz najwyższego poziomu go nie ma.
  • value.media.ad_id, ad_title i original_media_id: wymienione w dokumentacji dla komentarzy pod reklamą.

Czego pole comments nie przekazuje?

Kilka rzeczy, których obsługa mogłaby oczekiwać, zostaje pominiętych w zdarzeniu albo nigdy nie jest wysyłanych, według instrukcji konfiguracji i dokumentacji Meta:

  • Komentarze pod mediami konta prywatnego: Meta nie wysyła dla nich powiadomień o komentarzach ani wzmiankach.
  • ID albumów: zdarzenie ich nie zawiera, a Meta zaleca wyszukać album przez ID komentarza.
  • ID reklam dla mediów użytych w reklamach dynamicznych.
  • Czas utworzenia komentarza: GET /<COMMENT_ID>?fields=timestamp zwraca go w formacie ISO 8601.
  • Komentarze na żywo po zakończeniu transmisji, gdy powiadomienia dla mediów Live ustają.
  • Wzmianki w relacjach, których API wzmianek Meta nie obsługuje; trafiają do konta jako DM-y.
  • Zdarzenia z przeszłości: Meta nie przechowuje historii powiadomień do odpytania, więc zapisuj to, czego potrzebujesz, gdy każde z nich nadejdzie.

Czego wymaga pole comments?

Przy Instagram Login uprawnień instagram_business_basic i instagram_business_manage_comments oraz Advanced Access, którego Meta wymaga dla powiadomień comments i live_comments. Aplikacja musi mieć status Live i być zasubskrybowana do comments w App Dashboard, a każde konto musi zostać zasubskrybowane przez POST /<IG_ID>/subscribed_apps z comments wśród subscribed_fields. Meta zdecydowanie zaleca ten webhook zamiast odpytywania o komentarze, bo oszczędza limit żądań.

Jak odpowiedzieć na komentarz z tego zdarzenia?

Używając ID, które zdarzenie zawiera. POST /<COMMENT_ID>/replies z polem message publikuje publiczną odpowiedź pod komentarzem, z value.id. POST /<IG_ID>/messages z recipient.comment_id ustawionym na value.id wysyła autorowi jedną prywatną odpowiedź, w ciągu 7 dni od komentarza albo w trakcie transmisji Live. from.id to Instagram-scoped ID, ale wiadomość DM wysłana wprost na nie kończy się błędem, dopóki osoba nie napisała do konta, więc prywatna odpowiedź to sposób na dotarcie do niej przez DM.

Jak easyCoexistence przekazuje komentarz?

Od razu po nadejściu, gdy dla konta ustawiono endpoint przez set_social_webhook_destination z Claude lub ChatGPT albo przez PUT /channels/:id/webhook w Partner API. easyCoexistence subskrybuje każde podłączone konto do pól, które niosą jego komentarze, wzmianki i DM-y, sprawdza podpis Meta przy każdym dostarczeniu, od razu odpowiada Meta i wysyła POST z każdym wpisem dla tego konta na Twój adres HTTPS, w kopercie:

  • platform i external_id: instagram oraz ID konta w Instagramie, równe entry.id.
  • account_id: ID połączenia w easyCoexistence, zwracane przez list_social_accounts i używane przez narzędzia MCP.
  • entry: wpis Meta dla konta, bez zmian, więc dostawa zbiorcza staje się jednym POST na wpis. Pole object od Meta i X-Hub-Signature-256 nie są przekazywane dalej.
  • Dostarczenie: jedna próba, czekanie do 8 sekund, bez podążania za przekierowaniami, na adres HTTPS rozwiązujący się do publicznego adresu IP. Kopia nie jest zapisywana i nic nie jest ponawiane.
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" }
        }
      }
    ]
  }
}

Co z tym samym zdarzeniem robią reguły komentarz-DM?

Czytają je razem z przekazywaniem. Reguła pasuje, gdy komentarz zawiera jedno z jej słów kluczowych, bez względu na wielkość liter, pod jednym wybranym postem albo pod wszystkimi, i wysyła autorowi DM z reguły jako jego prywatną odpowiedź, a także publiczną odpowiedź, jeśli reguła ją ma. Komentarze napisane przez samo konto są pomijane, automatyzacje startujące od komentarza obsługują te, na które żadna reguła nie odpowiedziała, a komentarz, na który odpowiedziała reguła, i tak trafia na twój endpoint. Publiczna odpowiedź reguły może wrócić jako nowe zdarzenie comments od samego konta.

Typowe błędy

  • Szukanie comment_id. Przy Instagram Login ID komentarza znajduje się w value.id; comment_id należy do payloadów innych konfiguracji logowania Meta.
  • Odpowiadanie na własne komentarze konta. Jego odpowiedzi wracają jako zdarzenia comments z from.id równym entry.id, więc automatyzacja, która na nie odpowiada, rozmawia sama ze sobą.
  • Traktowanie entry.time jako czasu komentarza. Ten czas zapisuje, kiedy Meta wysłała powiadomienie; własne pole timestamp komentarza mówi, kiedy został napisany.
  • Czekanie na komentarze Live w polu comments. Trafiają one do live_comments, które wymaga osobnej subskrypcji i milknie po zakończeniu transmisji.
Z EasyCoexistence zrobisz to

Reguły komentarz-DM i automatyzacje odpowiadają na te same komentarze całą dobę. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając w miarę dodawania połączeń, z pierwszymi 3 dniami bezpłatnie.

Najczęściej zadawane pytania

Czy webhook komentarzy Instagrama obejmuje odpowiedzi na komentarze?

Tak. Odpowiedź przychodzi jako osobne zdarzenie comments, z parent_id zawierającym ID komentarza, na który odpowiada.

Czy komentarze pod Reelsami uruchamiają webhook komentarzy Instagrama?

Tak. Komentarz pod Reelsem przychodzi w polu comments tak samo jak pod postem, a media.media_product_type pozwala je rozróżnić.

Dlaczego mój webhook komentarzy Instagrama nie działa?

Najczęściej aplikacja nie ma statusu Live albo nie ma Advanced Access, konto nigdy nie zostało zasubskrybowane przez /subscribed_apps, media należą do konta prywatnego, albo komentarz był pod transmisją Live, która używa live_comments.

Czy webhook komentarzy zawiera nazwę użytkownika komentującego?

Tak. value.from zawiera nazwę użytkownika obok Instagram-scoped ID, więc nie potrzeba dodatkowego zapytania, by pokazać, kto skomentował.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w