Webhook live_comments di Instagram: i commenti durante una diretta Live
Il campo webhook live_comments di Instagram avvisa un'app dei commenti alla diretta Live di un account professionale mentre è in onda. Ogni commento arriva come una modifica con field impostato su live_comments e la stessa struttura di valore del campo comments: l'id e il testo del commento, l'ID con ambito Instagram e lo username dell'autore in from, e l'id del media. Le notifiche si interrompono quando la diretta termina.
easyCoexistence iscrive ogni account Instagram collegato a comments, messages e mentions e inoltra i commenti ai suoi post e Reel al tuo endpoint HTTPS appena arrivano, firmati con il segreto di quell'account.
Necessario per le notifiche live_comments, come per i commenti; i media di un account privato non inviano nulla.
Risposte private al secondo che un'app può inviare per account verso i commenti a una diretta Live di Instagram.
Quando le notifiche dei commenti sui media in diretta si interrompono.
Quando si può inviare una risposta privata a un commento della Live; terminata la diretta, non è più possibile.
Quando Meta ha introdotto live_comments, per i commenti ai video in diretta mentre vengono trasmessi.
Quando si attiva live_comments?
Quando qualcuno commenta il video Live dell'account professionale mentre viene trasmesso, una volta che l'app e l'account sono iscritti al campo. È separato da comments: un commento a un post, a un Reel, a una Storia o a un annuncio arriva su comments, mentre un commento durante una Live arriva su live_comments. Le notifiche per i media in diretta si interrompono al termine della trasmissione, e i media di un account privato non ne generano alcuna.
Com'è fatta una notifica live_comments?
La busta di un commento: object impostato su instagram, una voce per account e un array changes il cui campo legge live_comments. L'esempio di Instagram Login di Meta usa una sola struttura di valore per commenti e live_comments, quindi è il nome del campo a distinguerli:
{
"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>"
}
}
}
]
}
]
}Cosa significa ciascun campo?
I campi che il riferimento del webhook di Meta elenca per live_comments, dall'esterno verso l'interno:
- entry[].id: l'account professionale. entry[].time: quando Meta ha inviato la notifica, non quando è stato scritto il commento.
- changes[].field:
live_comments. Controllalo prima di leggere value, perché la struttura coincide con quella dei commenti. - value.id: l'ID del commento, quello a cui è indirizzata una risposta privata.
- value.text: il testo del commento.
- value.from.id e value.from.username: l'ID con ambito Instagram e lo username dell'autore; from.
self_ig_scoped_idcompare quando l'account commenta se stesso. - value.media.id e value.media.
media_product_type: il video in diretta e il formato in cui si trova. - value.
parent_id: nel riferimento, per un commento che risponde a un altro commento.
In cosa live_comments si differenzia da comments?
Il payload coincide, ma le regole no. I riferimenti di Meta sui commenti trattano i commenti ai video in diretta come un caso a sé, e i suoi limiti di frequenza e le regole sulle risposte private gli assegnano valori diversi. Affiancati, con il campo comments a sinistra:
| 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 |
Come si risponde a un commento della Live?
Con una risposta privata, durante la diretta. POST /<IG_ID>/messages con recipient.comment_id impostato sull'ID del commento invia al suo autore un solo DM, che arriva nella casella se segue l'account e tra le richieste di messaggio in caso contrario. I riferimenti di Meta escludono le vie pubbliche sul video in diretta: rispondere, creare, nascondere ed eliminare commenti non sono supportati. Terminata la diretta, non si possono più inviare risposte private ai suoi commenti.
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>" }
}I commenti di una Live si possono leggere senza il webhook?
Solo mentre la Live è in corso. Il riferimento sui commenti di Meta dice che i commenti ai video in diretta si possono leggere soltanto mentre il media viene trasmesso, e il riferimento sui media dice lo stesso del video in diretta. Il suo edge live_media, che elenca la Live attuale dell'account, è documentato per Facebook Login su graph.facebook.com. Meta non conserva una cronologia delle notifiche da interrogare, quindi salva ciò che ti serve da ogni evento appena arriva.
Di cosa ha bisogno live_comments?
Con Instagram Login, instagram_business_basic e instagram_business_manage_comments, la stessa coppia dei commenti, più Advanced Access, che Meta richiede per le notifiche di commenti e live_comments. Un nuovo prodotto Instagram nella App Dashboard parte iscritto a live_comments, e ogni account si iscrive tramite POST /<IG_ID>/subscribed_apps. L'account che possiede la Live deve essere pubblico.
easyCoexistence inoltra i commenti delle Live?
No. L'app di easyCoexistence e ogni account connesso sono sottoscritti a comments, messages e mentions, non a live_comments, quindi i commenti fatti durante una Live non vengono inoltrati. Quelli sui post e sui Reel sì, e reply_to_comment, hide_comment, le regole da commento a DM e le automazioni possono agire su di essi.
Errori comuni
- Aspettarsi i commenti della Live sul campo comments. Arrivano su live_comments, con field impostato su live_comments, e quel campo va selezionato per l'app.
- Rispondere pubblicamente a un commento della Live. Meta non supporta risposte, nascondimenti o eliminazioni dei commenti sul video in diretta; la via è una risposta privata durante la trasmissione.
- Mettere in coda le risposte private per dopo la Live. Terminata la diretta non possono più essere inviate, quindi rispondi mentre è in onda.
- Trattare live_comments come una cronologia. Le notifiche si interrompono al termine della diretta e Meta non ne conserva alcuna da interrogare, quindi salva ciò che ti serve man mano che ne arriva una.
reply_to_comment risponde pubblicamente o con una risposta privata, e le regole da commento a DM funzionano h24. Da US$ 9 a US$ 0.75 per connessione al mese, in calo man mano che aggiungi connessioni, con i primi 3 giorni gratuiti.
Domande frequenti
Il webhook dei commenti di Instagram include i commenti delle Live?
No. I commenti scritti durante una diretta Live arrivano sul campo separato live_comments, con la stessa struttura di valore.
Quando Meta ha aggiunto il webhook live_comments?
Il 9 novembre 2021, per i commenti ai video in diretta mentre vengono trasmessi.
Perché il mio webhook live_comments si è fermato?
Molto probabilmente la diretta è terminata, il che interrompe le notifiche dei commenti sui media in diretta. Se non è mai partito, controlla Advanced Access, l'iscrizione dell'account e che l'account sia pubblico.
Quanto velocemente un'app può inviare risposte private ai commenti di una Instagram Live?
Fino a 100 al secondo per account, il limite di Meta per le risposte private ai commenti di una Live, contro 750 all'ora per i commenti a post e Reel. Ognuna deve partire prima della fine della diretta.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il