Webhook live_comments de Instagram: comentarios durante una transmisión en vivo
El campo webhook live_comments de Instagram avisa a una app de los comentarios en la transmisión en vivo de una cuenta profesional mientras está en el aire. Cada comentario llega como un elemento de changes con field igual a live_comments y la misma forma de value que el campo comments: el id y el text del comentario, el ID con alcance de Instagram y el username del autor en from, y el id del media. Las notificaciones se detienen cuando termina la transmisión.
easyCoexistence suscribe cada cuenta de Instagram conectada a comments, messages y mentions, y reenvía los comentarios de sus publicaciones y Reels a tu endpoint HTTPS en cuanto llegan, firmados con el secreto de esa cuenta.
Requerido para las notificaciones de live_comments, igual que para comments; el contenido de una cuenta privada no envía ninguna.
Respuestas privadas por segundo que una app puede enviar por cuenta a comentarios de una transmisión en vivo de Instagram.
Cuándo dejan de llegar las notificaciones de comentarios del contenido en vivo.
Cuándo se puede enviar una respuesta privada a un comentario de una transmisión en vivo; terminada la transmisión, ya no se puede.
Cuándo Meta introdujo live_comments, para comentarios en videos en vivo mientras se transmiten.
¿Cuándo se activa live_comments?
Cuando alguien comenta el video en vivo de la cuenta profesional mientras se transmite, una vez que la app y la cuenta están suscritas al campo. Es distinto de comments: un comentario en una publicación, Reel, historia o anuncio llega por comments, y uno durante una transmisión en vivo llega por live_comments. Las notificaciones del contenido en vivo se detienen cuando termina la transmisión, y el contenido de una cuenta privada no activa ninguna.
¿Cómo se ve una notificación de live_comments?
El sobre de un comentario: object con el valor instagram, una entrada por cuenta y un arreglo changes cuyo field dice live_comments. El ejemplo de Instagram Login de Meta usa una sola forma de value para comments y live_comments, así que el nombre del campo es lo que los distingue:
{
"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>"
}
}
}
]
}
]
}¿Qué significa cada campo?
Los campos que la referencia de webhooks de Meta lista para live_comments, de fuera hacia dentro:
- entry[].id: la cuenta profesional. entry[].time: cuándo envió Meta la notificación, no cuándo se escribió el comentario.
- changes[].field:
live_comments. Revísalo antes de leer value, porque la forma coincide con comments. - value.id: el ID del comentario, al que se dirige una respuesta privada.
- value.text: el texto del comentario.
- value.from.id y value.from.username: el ID con alcance de Instagram y el nombre de usuario del autor; from.
self_ig_scoped_idaparece cuando la cuenta comenta en sí misma. - value.media.id y value.media.
media_product_type: el video en vivo y la superficie en la que está. - value.
parent_id: en la referencia, para un comentario que responde a otro comentario.
¿En qué se diferencia live_comments de comments?
La forma del payload coincide, pero las reglas no. Las referencias de comentarios de Meta tratan los comentarios en video en vivo como un caso aparte, y sus límites de tasa y las reglas de respuesta privada les asignan cifras distintas. Lado a lado, con el campo comments a la izquierda:
| 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 |
¿Cómo se responde a un comentario de una transmisión en vivo?
Con una respuesta privada, durante la transmisión. POST /<IG_ID>/messages con recipient.comment_id igual al ID del comentario envía a su autor un DM, que llega a su bandeja si sigue la cuenta y a solicitudes de mensajes si no. Las referencias de Meta descartan las vías públicas en video en vivo: responder, crear, ocultar y eliminar comentarios allí no está soportado. Cuando termina la transmisión, ya no se pueden enviar respuestas privadas a sus comentarios.
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>" }
}¿Se pueden leer los comentarios de una transmisión sin el webhook?
Solo mientras dura la transmisión. La referencia de comentarios de Meta dice que los comentarios en video en vivo solo se pueden leer mientras el contenido se transmite, y su referencia de media dice lo mismo del propio video en vivo. Su edge live_media, que lista la transmisión actual de la cuenta, está documentado para Facebook Login en graph.facebook.com. Meta no guarda historial de notificaciones para consultar, así que guarda lo que necesites de cada evento en cuanto llegue.
¿Qué necesita live_comments?
Con Instagram Login, instagram_business_basic e instagram_business_manage_comments, el mismo par que comments, más Advanced Access, que Meta exige para las notificaciones de comments y live_comments. Un nuevo producto de Instagram en el App Dashboard empieza suscrito a live_comments, y cada cuenta se suscribe con POST /<IG_ID>/subscribed_apps. La cuenta dueña de la transmisión tiene que ser pública.
¿easyCoexistence reenvía los comentarios en vivo?
No. La app de easyCoexistence y cada cuenta conectada están suscritas a comments, messages y mentions, no a live_comments, así que los comentarios hechos durante un Live no se reenvían. Sí se reenvían los comentarios en publicaciones y Reels, y reply_to_comment, hide_comment, las reglas de comentario a DM y las automatizaciones pueden actuar sobre ellos.
Errores comunes
- Esperar los comentarios en vivo en el campo comments. Llegan por live_comments, con field igual a live_comments, y hay que seleccionar ese campo en la app.
- Responder en público a un comentario en vivo. Meta no admite respuestas, ocultar ni eliminar comentarios en video en vivo; la vía es una respuesta privada durante la transmisión.
- Dejar las respuestas privadas para después de la transmisión. Una vez que termina ya no se pueden enviar, así que responde mientras está en el aire.
- Tratar live_comments como un historial. Las notificaciones se detienen al terminar la transmisión y Meta no guarda ninguna para consultar, así que guarda lo que necesites a medida que llega cada una.
reply_to_comment responde en público o con una respuesta privada, y las reglas de comentario a DM funcionan las 24 horas. De US$ 9 a US$ 0.75 por conexión al mes, con descuento al añadir conexiones, y los primeros 3 días gratis.
Preguntas frecuentes
¿El webhook de comentarios de Instagram incluye los comentarios en vivo?
No. Los comentarios hechos durante una transmisión en vivo llegan por el campo live_comments aparte, con la misma forma de value.
¿Cuándo añadió Meta el webhook live_comments?
El 9 de noviembre de 2021, para comentarios en videos en vivo mientras se transmiten.
¿Por qué dejó de funcionar mi webhook live_comments?
Lo más probable es que la transmisión terminara, lo que detiene las notificaciones de comentarios del contenido en vivo. Si nunca empezó, revisa Advanced Access, la suscripción de la cuenta y que la cuenta sea pública.
¿Con qué rapidez puede una app enviar respuestas privadas a los comentarios de transmisiones en vivo de Instagram?
Hasta 100 por segundo por cuenta, la tasa de respuestas privadas de Meta para comentarios de una transmisión en vivo, frente a 750 por hora para comentarios en publicaciones y Reels. Cada una tiene que salir antes de que termine la transmisión.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el