InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Instagram live_comments-webhook: reacties tijdens een livestream

Het live_comments-veld van Instagram's webhook meldt een app de reacties op de livestream van een professioneel account terwijl die live uitzendt. Elke reactie komt binnen als item in changes met field gelijk aan live_comments en dezelfde value-structuur als het veld comments: de id en tekst van de reactie, de Instagram-scoped ID en gebruikersnaam van de auteur in from, en de id van de media. Meldingen stoppen zodra de uitzending eindigt.

easyCoexistence abonneert elk verbonden Instagram-account op comments, messages en mentions, en stuurt reacties op de posts en Reels door naar je HTTPS-endpoint zodra ze binnenkomen, ondertekend met het geheim van dat account.

Advanced Access

Vereist voor live_comments-meldingen, net als voor comments; media van een privéaccount stuurt er geen.

100/sec

Privéreacties per seconde die een app per account mag sturen naar reacties op een Instagram-livestream.

Broadcast end

Wanneer meldingen over reacties op live media stoppen.

During the Live

Wanneer een privéreactie op een reactie tijdens een livestream verstuurd kan worden; na het einde van de uitzending kan dat niet meer.

9 Nov 2021

Wanneer Meta live_comments introduceerde, voor reacties op live video's terwijl ze worden uitgezonden.

Wanneer wordt live_comments verstuurd?

Wanneer iemand een reactie plaatst op de livevideo van het professionele account terwijl die wordt uitgezonden, zodra de app en het account zijn geabonneerd op het veld. Het staat los van comments: een reactie op een post, Reel, Story of advertentie komt binnen via comments, en een reactie tijdens een livestream via live_comments. Meldingen voor live media stoppen wanneer de uitzending eindigt, en media van een privéaccount triggert er geen.

Hoe ziet een live_comments-melding eruit?

De envelop van een reactie: object gelijk aan instagram, één entry per account, en een array changes waarvan field live_comments is. Meta's Instagram Login-voorbeeld geeft één value-structuur voor comments en live_comments, dus de veldnaam is wat ze van elkaar onderscheidt:

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

Wat betekent elk veld?

De velden die Meta's webhook-referentie voor live_comments vermeldt, van buiten naar binnen:

  • entry[].id: het professionele account. entry[].time: wanneer Meta de melding verstuurde, niet wanneer de reactie is geschreven.
  • changes[].field: live_comments. Controleer dit voordat je value leest, want de structuur lijkt op die van comments.
  • value.id: het ID van de reactie, het ID waarnaar een privéreactie wordt gericht.
  • value.text: de tekst van de reactie.
  • value.from.id en value.from.username: de Instagram-scoped ID en gebruikersnaam van de auteur; from.self_ig_scoped_id verschijnt wanneer het account zelf reageert.
  • value.media.id en value.media.media_product_type: de livevideo en het producttype waarop die staat.
  • value.parent_id: in de referentie voor een reactie die op een andere reactie antwoordt.

Waarin verschilt live_comments van comments?

De payload komt overeen, maar de regels niet. Meta's referenties voor reacties behandelen reacties op livevideo als een eigen geval, en de rate limits en regels voor privéreacties geven ze andere waarden. Naast elkaar, met het veld comments links:

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

Hoe reageer je op een reactie tijdens een livestream?

Met een privéreactie, tijdens de uitzending. POST /<IG_ID>/messages met recipient.comment_id gelijk aan het ID van de reactie stuurt de auteur één DM, die in zijn inbox terechtkomt als hij het account volgt en in berichtverzoeken als niet. Meta's referenties sluiten de openbare routes op livevideo uit: reageren op, aanmaken, verbergen en verwijderen van reacties worden daar niet ondersteund. Zodra de uitzending eindigt, kunnen er geen privéreacties meer op de reacties worden verstuurd.

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

Kunnen de reacties van een livestream ook zonder de webhook worden gelezen?

Alleen zolang de livestream duurt. Meta's referentie voor reacties zegt dat reacties op livevideo alleen gelezen kunnen worden zolang de media wordt uitgezonden, en de mediareferentie zegt hetzelfde over de livevideo zelf. De edge live_media, die de huidige livestream van het account weergeeft, is gedocumenteerd voor Facebook Login op graph.facebook.com. Meta bewaart geen meldingsgeschiedenis om op te vragen, dus sla op wat je nodig hebt uit elk event zodra het binnenkomt.

Wat heeft live_comments nodig?

Met Instagram Login instagram_business_basic en instagram_business_manage_comments, hetzelfde paar als voor comments, plus Advanced Access, dat Meta vereist voor meldingen over comments en live_comments. Een nieuw Instagram-product in het App Dashboard start geabonneerd op live_comments, en elk account wordt geabonneerd via POST /<IG_ID>/subscribed_apps. Het account dat de livestream bezit moet openbaar zijn.

Stuurt easyCoexistence livestreamreacties door?

Nee. De app van easyCoexistence en elk verbonden account zijn geabonneerd op comments, messages en mentions, niet op live_comments, dus reacties tijdens een Live worden niet doorgestuurd. Reacties op posts en Reels wel, en reply_to_comment, hide_comment, comment-naar-DM-regels en automatiseringen kunnen daarop reageren.

Veelgemaakte fouten

  • Wachten op livereacties in het veld comments. Ze komen binnen op live_comments, met field gelijk aan live_comments, en dat veld moet voor de app zijn geselecteerd.
  • Openbaar reageren op een livereactie. Meta ondersteunt geen antwoorden, verbergen of verwijderen van reacties op livevideo; een privéreactie tijdens de uitzending is de route.
  • Privéreacties voor na de livestream in de wachtrij zetten. Zodra de uitzending eindigt, kunnen ze niet meer verstuurd worden, dus reageer terwijl hij live is.
  • live_comments behandelen als geschiedenis. Meldingen stoppen wanneer de uitzending eindigt en Meta bewaart er geen om op te vragen, dus sla op wat je nodig hebt zodra elke melding binnenkomt.
Dit doen met EasyCoexistence

reply_to_comment antwoordt openbaar of met een privéreactie, en comment-naar-DM-regels draaien dag en nacht. Van US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Bevat de webhook voor Instagram-reacties ook livestreamreacties?

Nee. Reacties die tijdens een livestream worden geplaatst, komen binnen op het aparte veld live_comments, met dezelfde value-structuur.

Wanneer heeft Meta de live_comments-webhook toegevoegd?

Op 9 november 2021, voor reacties op livevideo's terwijl ze worden uitgezonden.

Waarom is mijn live_comments-webhook gestopt?

Waarschijnlijk is de uitzending geëindigd, wat meldingen over reacties op live media stopt. Als hij nooit is gestart, controleer dan Advanced Access, het abonnement van het account en of het account openbaar is.

Hoe snel kan een app privéreacties sturen naar Instagram-livereacties?

Tot 100 per seconde per account, Meta's privéreactiesnelheid voor reacties op een livestream, tegenover 750 per uur voor reacties op posts en Reels. Elk moet verstuurd zijn voordat de uitzending eindigt.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op