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.
Pola, na które nowy produkt Instagram w App Dashboard startuje z subskrypcją, w tym comments, messages i message_reactions.
Pola wybiera się dla aplikacji, a nie dla konta: konto otrzymuje pola wybrane przez aplikację.
Poziom dostępu podany w przewodniku konfiguracji Meta dla webhooków Instagram Login; powiadomienia o comments i live_comments wymagają go.
Oznaczone jako niedostępne dla Instagram Login w tabeli pól Meta, która oferuje je przy Facebook Login i Unified Login.
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.
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 orazinstagram_manage_insights. Dokumentacja insights mediów Meta mówi, że webhook insights nie jest obsługiwany przy Instagram Login.messaging_policy_enforcementiresponse_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.
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_echoustawione 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_controllubrequest_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.
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