Webhook live_comments na Instagramie: komentarze podczas transmisji Live
Pole live_comments w webhooku Instagrama informuje aplikację o komentarzach pod transmisją Live profesjonalnego konta, gdy jest ona na antenie. Każdy komentarz przychodzi jako element tablicy changes z polem field o wartości live_comments i tym samym kształtem wartości co pole comments: identyfikator i tekst komentarza, Instagram-scoped ID oraz nazwa użytkownika autora w from, a także id multimediów. Powiadomienia ustają po zakończeniu transmisji.
easyCoexistence subskrybuje każde połączone konto Instagrama do comments, messages i mentions i przekazuje komentarze pod jego postami i Reelsami na Twój endpoint HTTPS w chwili ich nadejścia, podpisane sekretem tego konta.
Wymagane dla powiadomień live_comments, tak jak dla comments; multimedia należące do konta prywatnego nie wysyłają żadnych.
Liczba prywatnych odpowiedzi na sekundę, jaką aplikacja może wysłać na konto w odpowiedzi na komentarze pod Instagram Live.
Moment, w którym przestają przychodzić powiadomienia o komentarzach do multimediów na żywo.
Kiedy można wysłać prywatną odpowiedź na komentarz pod Live; po zakończeniu transmisji już nie można.
Kiedy Meta wprowadziła live_comments, dla komentarzy pod filmami na żywo w trakcie ich nadawania.
Kiedy uruchamia się live_comments?
Gdy ktoś skomentuje film Live profesjonalnego konta podczas nadawania, pod warunkiem że aplikacja i konto są zasubskrybowane do tego pola. Jest ono odrębne od comments: komentarz pod postem, Reelsem, relacją lub reklamą trafia do comments, a komentarz w czasie Live do live_comments. Powiadomienia o multimediach na żywo ustają po zakończeniu transmisji, a multimedia należące do konta prywatnego nie uruchamiają żadnych.
Jak wygląda powiadomienie live_comments?
Koperta komentarza: object o wartości instagram, jeden wpis na konto i tablica changes, której pole field ma wartość live_comments. Przykład Meta dla Instagram Login podaje jeden kształt wartości dla comments i live_comments, więc to nazwa pola je odróżnia:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "live_comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<LIVE_MEDIA_ID>",
"media_product_type": "<MEDIA_PRODUCT_TYPE>"
}
}
}
]
}
]
}Co oznacza każde pole?
Pola, które dokumentacja webhooków Meta podaje dla live_comments, od zewnątrz do środka:
- entry[].id: profesjonalne konto. entry[].time: moment, w którym Meta wysłała powiadomienie, a nie moment napisania komentarza.
- changes[].field:
live_comments. Sprawdź je przed odczytem value, bo kształt pasuje do comments. - value.id: identyfikator komentarza, czyli ten, do którego adresowana jest prywatna odpowiedź.
- value.text: tekst komentarza.
- value.from.id i value.from.username: Instagram-scoped ID i nazwa użytkownika autora; from.
self_ig_scoped_idpojawia się, gdy konto komentuje samo. - value.media.id i value.media.
media_product_type: film na żywo i format, w którym jest emitowany. - value.
parent_id: w dokumentacji dla komentarza będącego odpowiedzią na inny komentarz.
Czym live_comments różni się od comments?
Treść powiadomienia jest taka sama, ale zasady już nie. Dokumentacja Meta dotycząca komentarzy traktuje komentarze pod filmami na żywo jako osobny przypadek, a jej limity szybkości i zasady prywatnych odpowiedzi podają dla nich inne liczby. Zestawienie, po lewej pole comments:
| comments | live_comments | |
|---|---|---|
| Fires for | Comments on posts, Reels, Stories and ads | Comments on a Live while it broadcasts |
| Notifications | As each comment is made | Stop when the broadcast ends |
| Public reply | POST /<COMMENT_ID>/replies | Not supported on live video |
| Hide or delete | Supported | Not supported on live video |
| Private reply | Within 7 days of the comment | Only during the broadcast |
| Private reply rate | 750 per hour per account | 100 per second per account |
Jak odpowiedzieć na komentarz z Live?
Prywatną odpowiedzią, w czasie transmisji. POST /<IG_ID>/messages z recipient.comment_id ustawionym na identyfikator komentarza wysyła jego autorowi jedną wiadomość DM, która trafia do skrzynki odbiorczej, jeśli obserwuje konto, a do żądań wiadomości, jeśli nie. Referencje Meta wykluczają publiczne ścieżki przy filmach na żywo: odpowiadanie, tworzenie, ukrywanie i usuwanie komentarzy tam nie jest obsługiwane. Po zakończeniu transmisji prywatnych odpowiedzi na jej komentarze nie można już wysłać.
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"recipient": { "comment_id": "<COMMENT_ID>" },
"message": { "text": "<REPLY_TEXT>" }
}Czy komentarze z Live da się odczytać bez webhooka?
Tylko w trakcie trwania Live. Referencja komentarzy Meta mówi, że komentarze pod filmem na żywo można odczytać wyłącznie wtedy, gdy multimedia są nadawane, a referencja multimediów mówi to samo o samym filmie na żywo. Jej krawędź live_media, która zwraca bieżące Live konta, jest udokumentowana dla Facebook Login na graph.facebook.com. Meta nie prowadzi historii powiadomień do odpytania, więc zapisuj to, czego potrzebujesz, z każdego zdarzenia w chwili jego nadejścia.
Czego potrzebuje live_comments?
Przy Instagram Login: instagram_business_basic i instagram_business_manage_comments, czyli ta sama para co dla comments, plus Advanced Access, którego Meta wymaga dla powiadomień comments i live_comments. Nowy produkt Instagram w App Dashboard zaczyna z subskrypcją live_comments, a każde konto subskrybuje się przez POST /<IG_ID>/subscribed_apps. Konto, do którego należy Live, musi być publiczne.
Czy easyCoexistence przekazuje komentarze z Live?
Nie. Aplikacja easyCoexistence i każde połączone konto są subskrybowane do comments, messages i mentions, a nie do live_comments, więc komentarze napisane podczas Live nie są przekazywane. Komentarze pod postami i Reelsami są, a reply_to_comment, hide_comment, reguły komentarz-do-DM i automatyzacje mogą na nich działać.
Typowe błędy
- Oczekiwanie na komentarze z Live w polu comments. Trafiają one do live_comments, z polem field ustawionym na live_comments, i wymagają wybrania tego pola w aplikacji.
- Publiczna odpowiedź na komentarz z Live. Meta nie obsługuje odpowiedzi, ukrywania ani usuwania komentarzy pod filmami na żywo; drogą jest prywatna odpowiedź w czasie transmisji.
- Kolejkowanie prywatnych odpowiedzi na czas po Live. Po zakończeniu transmisji nie można ich już wysłać, więc odpowiadaj, gdy jest na antenie.
- Traktowanie live_comments jako historii. Powiadomienia ustają po zakończeniu transmisji, a Meta nie przechowuje żadnych do odpytania, więc zapisuj to, czego potrzebujesz, w chwili nadejścia każdego z nich.
reply_to_comment odpowiada publicznie lub prywatną odpowiedzią, a reguły comment-to-DM działają całą dobę. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.
Najczęściej zadawane pytania
Czy webhook komentarzy na Instagramie zawiera komentarze z Live?
Nie. Komentarze publikowane w czasie transmisji Live trafiają do osobnego pola live_comments, o tym samym kształcie wartości.
Kiedy Meta dodała webhook live_comments?
9 listopada 2021 roku, dla komentarzy pod filmami na żywo w trakcie ich nadawania.
Dlaczego mój webhook live_comments przestał działać?
Najprawdopodobniej transmisja się skończyła, a to zatrzymuje powiadomienia o komentarzach do multimediów na żywo. Jeśli nigdy nie ruszył, sprawdź Advanced Access, subskrypcję konta i to, czy konto jest publiczne.
Jak szybko aplikacja może wysyłać prywatne odpowiedzi na komentarze z Instagram Live?
Do 100 na sekundę na konto, czyli limit Meta dla prywatnych odpowiedzi na komentarze z Live, wobec 750 na godzinę dla komentarzy pod postami i Reelsami. Każda musi wyjść przed zakończeniem transmisji.
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