Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Instagramin live_comments-webhook: kommentit Live-lähetyksen aikana

Instagramin live_comments-webhook ilmoittaa sovellukselle ammattimaisen tilin Live-lähetyksen kommenteista, kun lähetys on käynnissä. Jokainen kommentti saapuu muutoksena, jonka kenttä on live_comments ja jonka arvo on samanmuotoinen kuin comments-kentässä: kommentin id ja teksti, tekijän Instagram-kohtainen ID ja käyttäjänimi kohdassa from sekä median id. Ilmoitukset loppuvat, kun lähetys päättyy.

easyCoexistence tilaa jokaisen yhdistetyn Instagram-tilin kommentteihin, viesteihin ja maininkoihin ja välittää sen julkaisujen ja Reelien kommentit HTTPS-päätepisteeseesi heti, kun ne saapuvat, allekirjoitettuna kyseisen tilin salaisuudella.

Advanced Access

Vaaditaan live_comments-ilmoituksiin samoin kuin kommenttien ilmoituksiin; yksityisen tilin omistama media ei lähetä ilmoituksia.

100/sec

Yksityisvastausten määrä sekunnissa, jonka sovellus voi lähettää tiliä kohden Instagram Live -kommentteihin.

Broadcast end

Milloin live-median kommenttien ilmoitukset loppuvat.

During the Live

Milloin yksityisvastaus Live-kommenttiin voidaan lähettää; lähetyksen päätyttyä sitä ei enää voi.

9 Nov 2021

Milloin Meta otti käyttöön live_comments-webhookin live-videoiden kommenteille niiden lähetyksen aikana.

Milloin live_comments laukeaa?

Kun joku kommentoi ammattimaisen tilin Live-videota sen lähetyksen aikana, kunhan sovellus ja tili on tilattu kenttään. Se on erillinen comments-kentästä: julkaisun, Reelin, Storyn tai mainoksen kommentti saapuu kenttään comments, ja kommentti Live-lähetyksen aikana kenttään live_comments. Live-median ilmoitukset loppuvat, kun lähetys päättyy, eikä yksityisen tilin media laukaise yhtään ilmoitusta.

Miltä live_comments-ilmoitus näyttää?

Kommentin kuori: object-kentän arvo on instagram, yksi entry tilia kohden ja changes-taulukko, jonka kenttä on live_comments. Metan Instagram Login -esimerkki käyttää samaa arvon muotoa kommenteille ja live_comments-kentälle, joten kentän nimi erottaa ne toisistaan:

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

Mitä kukin kenttä tarkoittaa?

Kentät, jotka Metan webhook-viite listaa live_comments-webhookille, ulommasta kentästä sisimpään:

  • entry[].id: ammattimainen tili. entry[].time: milloin Meta lähetti ilmoituksen, ei milloin kommentti kirjoitettiin.
  • changes[].field: live_comments. Tarkista se ennen value-kentän lukemista, koska rakenne on sama kuin kommenteissa.
  • value.id: kommentin ID, johon yksityisvastaus osoitetaan.
  • value.text: kommentin teksti.
  • value.from.id ja value.from.username: tekijän Instagram-kohtainen ID ja käyttäjänimi; from.self_ig_scoped_id esiintyy, kun tili kommentoi itse.
  • value.media.id ja value.media.media_product_type: live-video ja pinta, jolla se on.
  • value.parent_id: viitteessä kommentille, joka vastaa toiseen kommenttiin.

Miten live_comments eroaa comments-kentästä?

Payload vastaa, mutta säännöt eivät. Metan kommenttiviitteet käsittelevät live-videon kommentteja omana tapauksenaan, ja sen nopeusrajat sekä yksityisvastausten säännöt antavat niille eri luvut. Vierekkäin, comments-kenttä vasemmalla:

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

Miten vastaat Live-kommenttiin?

Yksityisvastauksella lähetyksen aikana. POST /<IG_ID>/messages, jossa recipient.comment_id on kommentin ID, lähettää sen tekijälle yhden DM-viestin. Viesti päätyy tekijän saapuneisiin, jos tekijä seuraa tiliä, ja viestipyyntöihin, jos ei. Metan viitteet kieltävät julkiset reitit live-videolla: kommenttiin vastaaminen, luominen, piilottaminen ja poistaminen eivät ole siellä tuettuja. Kun lähetys päättyy, sen kommentteihin ei enää voi lähettää yksityisvastauksia.

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

Voiko Live-kommentit lukea ilman webhookia?

Vain Live-lähetyksen aikana. Metan kommenttiviitteen mukaan live-videon kommentteja voi lukea vain, kun media lähetetään, ja median viite sanoo saman itse live-videosta. Sen live_media-reuna, joka listaa tilin nykyisen Live-lähetyksen, on dokumentoitu Facebook Login -kirjautumiselle osoitteessa graph.facebook.com. Meta ei säilytä ilmoitushistoriaa, jota voisi kysellä, joten tallenna jokaisesta tapahtumasta tarvitsemasi heti, kun se saapuu.

Mitä live_comments vaatii?

Instagram Loginilla instagram_business_basic ja instagram_business_manage_comments, sama pari kuin kommenteissa, sekä Advanced Access, jonka Meta vaatii kommenttien ja live_comments-ilmoitusten osalta. Uusi Instagram-tuote App Dashboardissa tilautuu live_comments-kenttään automaattisesti, ja jokainen tili tilataan POST /<IG_ID>/subscribed_apps -pyynnöllä. Live-lähetyksen omistavan tilin on oltava julkinen.

Välittääkö easyCoexistence Live-kommentit?

Ei. easyCoexistencen sovellus ja jokainen yhdistetty tili on tilattu kommentteihin, viesteihin ja mainintoihin, ei live_comments-kenttään, joten Live-lähetyksen aikana tehtyjä kommentteja ei välitetä. Julkaisujen ja Reelien kommentit välitetään, ja reply_to_comment-, hide_comment-, kommentista DM:ään -säännöt ja automaatiot voivat toimia niiden kanssa.

Yleiset virheet

  • Live-kommenttien odottaminen comments-kentästä. Ne saapuvat kenttään live_comments, joka pitää valita sovellukselle.
  • Julkinen vastaaminen Live-kommenttiin. Meta ei tue vastauksia, piilotuksia tai poistoja live-videon kommenteissa; yksityisvastaus lähetyksen aikana on reitti.
  • Yksityisvastausten jonottaminen Live-lähetyksen jälkeen. Lähetyksen päätyttyä niitä ei enää voi lähettää, joten vastaa, kun lähetys on käynnissä.
  • live_comments-kentän käsittely historiana. Ilmoitukset loppuvat, kun lähetys päättyy, eikä Meta säilytä niitä kysyttäväksi, joten tallenna tarvitsemasi, kun jokainen saapuu.
Näin teet tämän EasyCoexistencen avulla

reply_to_comment vastaa julkisesti tai yksityisvastauksella, ja kommentista DM:ään -säännöt toimivat ympäri vuorokauden. US$ 9:stä US$ 0.75:een yhteyttä kohden kuukaudessa, ja hinta laskee yhteyksien lisääntyessä. Ensimmäiset 3 päivää ovat ilmaisessa kokeilussa.

Usein kysytyt kysymykset

Sisältääkö Instagramin kommenttien webhook Live-kommentit?

Ei. Live-lähetyksen aikana tehdyt kommentit saapuvat erilliseen kenttään live_comments, jolla on sama arvon rakenne.

Milloin Meta lisäsi live_comments-webhookin?

9. marraskuuta 2021, live-videoiden kommenteille niiden lähetyksen aikana.

Miksi live_comments-webhookini lakkasi?

Todennäköisimmin lähetys päättyi, mikä lopettaa kommenttien ilmoitukset live-medialle. Jos se ei koskaan alkanut, tarkista Advanced Access, tilin tilaus ja se, että tili on julkinen.

Kuinka nopeasti sovellus voi lähettää yksityisvastauksia Instagram Live -kommentteihin?

Jopa 100 sekunnissa tiliä kohden, Metan yksityisvastausnopeus Live-kommenteille, kun postausten ja Reelien kommenteille raja on 750 tunnissa. Jokaisen on lähdettävä ennen lähetyksen päättymistä.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu