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

Pola webhooków Instagrama: pełna lista

Przy koncie profesjonalnym w Instagram Login tabela pól webhooków Meta wymienia comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover oraz standby, a wzmianki są dostarczane wewnątrz comments; jej przykłady dodają message_edit. Każde pole wymaga instagram_business_basic oraz instagram_business_manage_comments albo, dla większości pól związanych z wiadomościami, instagram_business_manage_messages. story_insights nie jest dostępne w Instagram Login.

easyCoexistence subskrybuje każde podłączone konto Instagram do comments, messages i mentions i przekazuje te zdarzenia na Twój endpoint HTTPS w miarę ich nadchodzenia, podpisane sekretem danego konta.

8

Pola, na które nowy produkt Instagram w App Dashboard startuje z subskrypcją, w tym comments, messages i message_reactions.

Per app

Pola wybiera się dla aplikacji, a nie dla konta: konto otrzymuje pola wybrane przez aplikację.

Advanced Access

Poziom dostępu podany w przewodniku konfiguracji Meta dla webhooków Instagram Login; powiadomienia o comments i live_comments wymagają go.

story_insights

Oznaczone jako niedostępne dla Instagram Login w tabeli pól Meta, która oferuje je przy Facebook Login i Unified Login.

10 Sep 2025

Moment, w którym Meta wprowadziła webhook message_edit dla Business Login for Instagram i Facebook Login for Business.

Jakie pola webhooków oferuje Instagram Login?

Oto pola z tabeli Meta, z opisem tego, co uruchamia każde z nich, zaczerpniętym z jej przykładów i dokumentacji webhooków. Każde pole wymaga także instagram_business_basic oprócz pokazanego uprawnienia, a Meta wymaga Advanced Access dla powiadomień comments i live_comments.

commentsA comment or reply on the account's posts, Reels, Stories or ads, @mentions included. instagram_business_manage_comments.
live_commentsA comment on the account's Live while it is broadcast. instagram_business_manage_comments.
mentionsNo field of its own with Instagram Login: Meta includes mentions in the comments notification.
messagesA DM: text, attachments, shares, Story replies and mentions, quick replies, deletions, and echoes of the account's own messages. instagram_business_manage_messages.
message_echoesListed with instagram_business_manage_comments; the account's own messages arrive on messages with is_echo set to true.
message_reactionsA person reacts to a message or removes the reaction. instagram_business_manage_messages.
message_editA person edits a message, with mid, text and num_edit. In Meta's examples and changelog, not in its fields table.
messaging_postbacksA tap on an ice breaker, a template's postback button or a persistent menu item. instagram_business_manage_messages.
messaging_referralAn ig.me link with a ref parameter, opened in an existing conversation. instagram_business_manage_messages.
messaging_seenA person reads a message, reported as read.mid. instagram_business_manage_messages.
messaging_optinsListed with instagram_business_manage_messages; Meta's Instagram examples show no payload for it.
messaging_handoverThread control passed, taken or requested between apps under the handover protocol. instagram_business_manage_messages.
standbyA message that arrives while another app controls the conversation. instagram_business_manage_messages.

Których pól nie ma w Instagram Login?

Trzy wiersze tabeli pól Meta nie mają uprawnienia Instagram Login, więc aplikacja z Instagram Login ich nie otrzymuje, a jedno pole istnieje wyłącznie poza nią:

  • story_insights: statystyki relacji po jej wygaśnięciu, przy Facebook Login lub Unified Login oraz instagram_manage_insights. Dokumentacja insights mediów Meta mówi, że webhook insights nie jest obsługiwany przy Instagram Login.
  • messaging_policy_enforcement i response_feedback: tylko w kolumnie dotyczącej Instagram Messaging API od Meta.
  • mentions jako osobne pole: Facebook Login i Unified Login je wymieniają, z instagram_manage_comments, podczas gdy Instagram Login włącza wzmianki do comments.

Jak subskrybować pola?

Na dwóch etapach. W App Dashboard, w ustawieniach webhooków produktu Instagram, zapisz adres callback URL i token weryfikacyjny, co uruchamia żądanie weryfikacyjne Meta, a potem wybierz pola; nowy produkt Instagram startuje z subskrypcją ośmiu z nich. Następnie zasubskrybuj każde konto żądaniem POST /<IG_ID>/subscribed_apps na graph.instagram.com, z subscribed_fields ustawionym na pola wybrane w panelu, oddzielone przecinkami.

Subscribing one account to three fields
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
  ?subscribed_fields=comments,messages,message_reactions
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{ "success": true }

Czy każde konto może mieć inne pola?

Nie. Przewodnik konfiguracji Meta mówi, że pól nie można wybierać dla każdego konta użytkownika aplikacji: konto otrzymuje pola wybrane dla aplikacji. subscribed_fields w subskrypcji konta ma wyliczać pola z panelu, więc kod obsługujący powinien spodziewać się każdego pola wybranego przez aplikację i rozstrzygać na podstawie tego, co zawiera każde zdarzenie, a nie tego, o co dane konto poprosiło.

Jak rozpoznać pola w powiadomieniu?

Po kształcie wpisu. Pola komentarzy przychodzą w tablicy changes, a każda zmiana podaje swoje pole. Pola wiadomości przychodzą w tablicy messaging bez nazwy pola, a klucz obok sender, recipient i timestamp je rozróżnia:

  • changes[].field: comments lub live_comments, z komentarzem w value.
  • message: messages, łącznie z echami wysłanych przez konto wiadomości, które mają is_echo ustawione na true.
  • reaction: message_reactions. postback: messaging_postbacks. read: messaging_seen. message_edit: message_edit.
  • referral obok sender: messaging_referral. Referral wewnątrz message należy do messages, od nowego wątku lub reklamy Click-to-Direct.
  • pass_thread_control, take_thread_control lub request_thread_control: messaging_handover, tak jak wymienia je dokumentacja webhooków Meta.

Które pola subskrybuje easyCoexistence?

comments, messages i mentions, czyli lista, z jaką każde podłączone konto Instagram jest subskrybowane przy połączeniu. Przy Instagram Login wzmianki przychodzą wewnątrz comments, więc subskrypcja obejmuje comments i DM, a wśród DM są echa, odpowiedzi na relacje, wzmianki w relacjach i załączniki. Pozostałe pola z tabeli dostarcza Meta aplikacji, która je subskrybuje, i nie należą one do subskrypcji połączenia. Gdy endpoint zostanie ustawiony narzędziem set_social_webhook_destination lub przez Partner API, easyCoexistence sprawdza podpis Meta, od razu odpowiada Meta i wysyła żądaniem POST każdy wpis dotyczący konta na ten adres:

  • platform i external_id: instagram oraz identyfikator konta Instagram, równy entry.id.
  • account_id: identyfikator połączenia w easyCoexistence, ten, którego używają narzędzia MCP.
  • entry: wpis Meta dla konta, bez zmian. Pole object z Meta i nagłówek X-Hub-Signature-256 nie są przekazywane dalej.
  • X-EC-Signature: t=<unix>,v1=<hex>, HMAC-SHA256 z znacznika czasu, kropki i surowego ciała, kluczem jest własny sekret konta.
  • Dostarczenie: jedna próba trwająca do 8 sekund, bez śledzenia przekierowań, bez zachowanej kopii i bez ponowień.

Typowe błędy

  • Oczekiwanie na pole mentions przy Instagram Login. Meta wkłada wzmianki do powiadomienia o comments, więc kod obsługujący powiązany z polem mentions nigdy się nie uruchamia.
  • Zakładanie, że konto dostaje tylko pola wskazane w jego własnej subskrypcji. Meta dostarcza pola wybrane dla aplikacji, więc rozdzielaj obsługę według tego, co zawiera każde zdarzenie.
  • Traktowanie message.referral i referral na najwyższym poziomie jako jednego zdarzenia. Pierwsze należy do messages; drugie to messaging_referral, dla linku ig.me otwartego w istniejącej rozmowie.
  • Oczekiwanie na story_insights przy Instagram Login. Meta oznacza je tam jako niedostępne, więc metryki relacji odczytuj z endpointu insights, dopóki relacja jest aktywna.
Z EasyCoexistence zrobisz to

Zdarzenia nie są domyślnie przechowywane; konto z włączoną automatyzacją zachowuje swoje DM-y i komentarze przez 7 dni. Ustaw endpoint narzędziem set_social_webhook_destination z poziomu Claude lub ChatGPT albo przez Partner API. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, z każdym kolejnym połączeniem taniej, a pierwsze 3 dni są bezpłatne.

Najczęściej zadawane pytania

Czy Instagram Login ma osobne pole webhooka mentions?

Nie. Meta włącza wzmianki do powiadomienia o comments dla Instagram Login; mentions jest osobnym polem przy Facebook Login i Unified Login.

Czy story_insights jest dostępne przy Instagram Login?

Nie. Tabela pól Meta oznacza je jako niedostępne dla Instagram Login, a dokumentacja insights mediów mówi, że webhook insights tam nie jest obsługiwany.

Jakich uprawnień wymaga webhook wiadomości Instagrama?

instagram_business_basic i instagram_business_manage_messages, z Advanced Access, co przewodnik konfiguracji Meta podaje dla webhooków Instagram Login.

Kiedy Meta dodała webhook message_edit dla Instagrama?

10 września 2025 roku, dla Business Login for Instagram i Facebook Login for Business. Edycja przychodzi w tablicy messaging pod kluczem message_edit.

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