Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Webhook-ul live_comments de pe Instagram: comentariile din timpul difuziunii Live

Câmpul live_comments al webhook-ului Instagram notifică o aplicație despre comentariile de la difuziunea Live a unui cont profesional, cât timp aceasta este în aer. Fiecare comentariu sosește ca o modificare, cu câmpul setat la live_comments și aceeași structură de valori ca la câmpul comments: id-ul și textul comentariului, ID-ul delimitat pentru Instagram al autorului și numele de utilizator din from, precum și id-ul conținutului media. Notificările se opresc când se încheie difuzarea.

easyCoexistence abonează fiecare cont Instagram conectat la comments, messages și mentions și transmite comentariile de la postările și Reel-urile sale către endpoint-ul dumneavoastră HTTPS pe măsură ce sosesc, semnate cu secretul acelui cont.

Advanced Access

Obligatoriu pentru notificările live_comments, ca și pentru comentarii; conținutul media al unui cont privat nu trimite niciuna.

100/sec

Răspunsuri private pe secundă pe care o aplicație le poate trimite per cont, la comentariile dintr-un Live pe Instagram.

Broadcast end

Când încetează notificările despre comentarii pentru conținutul media live.

During the Live

Când poate fi trimis un răspuns privat la un comentariu din Live; după încheierea difuzării, nu mai poate fi trimis.

9 Nov 2021

Când Meta a introdus live_comments, pentru comentariile de la videoclipurile live cât timp sunt difuzate.

Când se declanșează live_comments?

Atunci când cineva comentează videoclipul Live al contului profesional în timp ce acesta este difuzat, după ce aplicația și contul sunt abonate la câmp. Este separat de comments: un comentariu la o postare, un Reel, o poveste sau un anunț sosește pe comments, iar un comentariu în timpul unui Live pe live_comments. Notificările pentru conținutul media live se opresc când se încheie difuzarea, iar conținutul media al unui cont privat nu declanșează niciuna.

Cum arată o notificare live_comments?

Învelișul unui comentariu: object setat la instagram, o intrare per cont și un array changes al cărui câmp are valoarea live_comments. Exemplul Instagram Login de la Meta folosește o singură structură de valori pentru comments și live_comments, deci numele câmpului este cel care le deosebește:

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

Ce înseamnă fiecare câmp?

Câmpurile pe care referința webhook-ului Meta le listează pentru live_comments, de la exterior spre interior:

  • entry[].id: contul profesional. entry[].time: momentul în care Meta a trimis notificarea, nu momentul în care a fost scris comentariul.
  • changes[].field: live_comments. Verificați-l înainte de a citi value, deoarece structura seamănă cu cea de la comments.
  • value.id: ID-ul comentariului, cel la care este adresat un răspuns privat.
  • value.text: textul comentariului.
  • value.from.id și value.from.username: ID-ul autorului delimitat pentru Instagram și numele de utilizator; from.self_ig_scoped_id apare când contul comentează el însuși.
  • value.media.id și value.media.media_product_type: videoclipul live și tipul de suprafață pe care se află.
  • value.parent_id: în referință, pentru un comentariu care răspunde altui comentariu.

Cu ce se deosebește live_comments de comments?

Structura payload-ului este aceeași, dar regulile nu. Referințele Meta pentru comentarii tratează comentariile de la videoclipurile live ca pe un caz aparte, iar limitele de rată și regulile pentru răspunsurile private le acordă alte valori. Alăturat, cu câmpul comments în stânga:

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

Cum răspundeți unui comentariu din Live?

Printr-un răspuns privat, în timpul difuziunii. POST /<IG_ID>/messages cu recipient.comment_id setat la ID-ul comentariului trimite autorului un singur mesaj direct, care ajunge în căsuța de mesaje dacă urmărește contul, iar dacă nu, în cererile de mesaje. Referințele Meta exclud rutele publice la videoclipurile live: răspunsul, crearea, ascunderea și ștergerea comentariilor de acolo nu sunt acceptate. După încheierea difuzării, răspunsurile private la comentariile sale nu mai pot fi trimise.

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

Pot fi citite comentariile unui Live fără webhook?

Doar cât timp durează Live-ul. Referința Meta pentru comentarii spune că acestea pot fi citite de la videoclipurile live doar cât timp conținutul media este difuzat, iar referința pentru conținut media spune același lucru despre videoclipul live în sine. Muchia live_media, care listează Live-ul curent al contului, este documentată pentru Facebook Login pe graph.facebook.com. Meta nu păstrează un istoric al notificărilor pe care să îl interogați, deci stocați ce aveți nevoie din fiecare eveniment pe măsură ce sosește.

Ce are nevoie live_comments?

Cu Instagram Login, instagram_business_basic și instagram_business_manage_comments, aceeași pereche ca la comments, plus Advanced Access, pe care Meta o cere pentru notificările comments și live_comments. Un produs nou Instagram din App Dashboard pornește abonat la live_comments, iar fiecare cont se abonează prin POST /<IG_ID>/subscribed_apps. Contul care deține Live-ul trebuie să fie public.

easyCoexistence transmite comentariile din Live?

Nu. Aplicația easyCoexistence și fiecare cont conectat sunt abonate la comments, messages și mentions, nu la live_comments, deci comentariile făcute în timpul unui Live nu sunt transmise mai departe. Comentariile de la postări și Reel-uri sunt, iar reply_to_comment, hide_comment, regulile comment-to-DM și automatizările pot acționa asupra lor.

Greșeli frecvente

  • Așteptarea comentariilor din Live pe câmpul comments. Ele sosesc pe live_comments, cu câmpul setat la live_comments, și acest câmp trebuie selectat pentru aplicație.
  • Răspunsul public la un comentariu din Live. Meta nu acceptă răspunsuri, ascunderi sau ștergeri la comentariile de la videoclipurile live; ruta este răspunsul privat în timpul difuziunii.
  • Punerea în coadă a răspunsurilor private pentru după Live. Odată ce difuzarea se încheie, nu mai pot fi trimise, deci răspundeți cât timp este în aer.
  • Tratarea live_comments ca istoric. Notificările se opresc când se încheie difuzarea, iar Meta nu păstrează nimic de interogat, deci stocați ce aveți nevoie pe măsură ce sosește fiecare.
Faceți acest lucru cu EasyCoexistence

reply_to_comment răspunde public sau printr-un răspuns privat, iar regulile comment-to-DM rulează non-stop. De la US$ 9 până la US$ 0,75 per conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Webhook-ul de comentarii Instagram include comentariile din Live?

Nu. Comentariile făcute în timpul unei difuziuni Live sosesc pe câmpul separat live_comments, cu aceeași structură de valori.

Când a adăugat Meta webhook-ul live_comments?

Pe 9 noiembrie 2021, pentru comentariile de la videoclipurile live cât timp sunt difuzate.

De ce s-a oprit webhook-ul meu live_comments?

Cel mai probabil difuzarea s-a încheiat, ceea ce oprește notificările despre comentarii pentru conținutul media live. Dacă nu a pornit niciodată, verificați Advanced Access, abonamentul contului și faptul că acesta este public.

Cât de repede poate o aplicație să trimită răspunsuri private la comentariile din Instagram Live?

Până la 100 pe secundă per cont, rata Meta pentru răspunsurile private la comentariile dintr-un Live, față de 750 pe oră pentru comentariile de la postări și Reel-uri. Fiecare trebuie trimis înainte de încheierea difuzării.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la