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

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.

Advanced Access

Wymagane dla powiadomień live_comments, tak jak dla comments; multimedia należące do konta prywatnego nie wysyłają żadnych.

100/sec

Liczba prywatnych odpowiedzi na sekundę, jaką aplikacja może wysłać na konto w odpowiedzi na komentarze pod Instagram Live.

Broadcast end

Moment, w którym przestają przychodzić powiadomienia o komentarzach do multimediów na żywo.

During the Live

Kiedy można wysłać prywatną odpowiedź na komentarz pod Live; po zakończeniu transmisji już nie można.

9 Nov 2021

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:

A live_comments notification, as Meta sends it
{
  "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_id pojawia 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:

commentslive_comments
Fires forComments on posts, Reels, Stories and adsComments on a Live while it broadcasts
NotificationsAs each comment is madeStop when the broadcast ends
Public replyPOST /<COMMENT_ID>/repliesNot supported on live video
Hide or deleteSupportedNot supported on live video
Private replyWithin 7 days of the commentOnly during the broadcast
Private reply rate750 per hour per account100 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ć.

A private reply to a Live comment
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.
Z EasyCoexistence zrobisz to

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