Webhook live_comments do Instagram: comentários durante uma transmissão ao vivo
O campo live_comments do webhook do Instagram avisa um app sobre comentários na transmissão ao vivo de uma conta profissional enquanto ela está no ar. Cada comentário chega como um elemento de changes com field igual a live_comments e o mesmo formato de value do campo comments: o id e o texto do comentário, o ID com escopo do Instagram e o username do autor em from, e o id da mídia. As notificações param quando a transmissão termina.
O easyCoexistence inscreve cada conta do Instagram conectada em comments, messages e mentions e encaminha os comentários dos seus posts e Reels ao seu endpoint HTTPS assim que chegam, assinados com o segredo daquela conta.
Exigido para notificações de live_comments, como para comentários; mídia de conta privada não envia nenhuma.
Respostas privadas por segundo que um app pode enviar por conta a comentários em uma Live do Instagram.
Quando as notificações de comentários de mídia ao vivo param.
Quando uma resposta privada a um comentário da Live pode ser enviada; depois que a transmissão termina, não pode mais.
Quando a Meta introduziu live_comments, para comentários em vídeos ao vivo enquanto são transmitidos.
Quando o live_comments é disparado?
Quando alguém comenta no vídeo ao vivo da conta profissional enquanto ele está sendo transmitido, desde que o app e a conta estejam inscritos no campo. Ele é separado de comments: um comentário em post, Reel, Story ou anúncio chega em comments, e um comentário durante uma Live chega em live_comments. As notificações de mídia ao vivo param quando a transmissão termina, e mídia de conta privada não dispara nenhuma.
Como é uma notificação de live_comments?
O envelope de um comentário: object igual a instagram, uma entrada por conta e um array changes cujo field é live_comments. O exemplo de Instagram Login da Meta usa um único formato de value para comments e live_comments, então o nome do campo é o que os diferencia:
{
"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>"
}
}
}
]
}
]
}O que significa cada campo?
Os campos que a referência de webhook da Meta lista para live_comments, de fora para dentro:
- entry[].id: a conta profissional. entry[].time: quando a Meta enviou a notificação, não quando o comentário foi escrito.
- changes[].field:
live_comments. Verifique antes de ler value, já que o formato é igual ao de comments. - value.id: o ID do comentário, aquele para o qual uma resposta privada é endereçada.
- value.text: o texto do comentário.
- value.from.id e value.from.username: o ID com escopo do Instagram e o username do autor; from.
self_ig_scoped_idaparece quando a conta comenta em si mesma. - value.media.id e value.media.
media_product_type: o vídeo ao vivo e a superfície em que ele está. - value.
parent_id: na referência, para um comentário que responde a outro comentário.
Em que live_comments difere de comments?
O formato do payload é igual, mas as regras não são. As referências de comentários da Meta tratam comentários em vídeos ao vivo como um caso próprio, e seus limites de taxa e regras de resposta privada têm números diferentes. Lado a lado, com o campo comments à esquerda:
| 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 |
Como responder a um comentário da Live?
Com uma resposta privada, durante a transmissão. POST /<IG_ID>/messages com recipient.comment_id definido como o ID do comentário envia ao autor uma DM, que cai na caixa de entrada se ele seguir a conta e em solicitações de mensagem se não seguir. As referências da Meta descartam as rotas públicas em vídeo ao vivo: responder, criar, ocultar e excluir comentários ali não são suportados. Depois que a transmissão termina, não é mais possível enviar respostas privadas a seus comentários.
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>" }
}Dá para ler os comentários de uma Live sem o webhook?
Só enquanto a Live durar. A referência de comentários da Meta diz que comentários em vídeos ao vivo só podem ser lidos enquanto a mídia está sendo transmitida, e sua referência de mídia diz o mesmo do próprio vídeo ao vivo. A edge live_media, que lista a Live atual da conta, está documentada para Facebook Login em graph.facebook.com. A Meta não mantém histórico de notificações para consultar, então armazene o que você precisa de cada evento assim que ele chegar.
O que live_comments exige?
Com Instagram Login, instagram_business_basic e instagram_business_manage_comments, o mesmo par de comments, mais Advanced Access, que a Meta exige para notificações de comments e live_comments. Um novo produto do Instagram no App Dashboard começa inscrito em live_comments, e cada conta é inscrita por POST /<IG_ID>/subscribed_apps. A conta dona da Live precisa ser pública.
O easyCoexistence repassa comentários de Live?
Não. O app do easyCoexistence e cada conta conectada são inscritos em comments, messages e mentions, não em live_comments, então comentários feitos durante uma Live não são encaminhados. Comentários em posts e Reels são, e reply_to_comment, hide_comment, regras de comentário para DM e automações podem agir sobre eles.
Erros comuns
- Esperar comentários de Live no campo comments. Eles chegam em live_comments, com field igual a live_comments, e esse campo precisa estar selecionado para o app.
- Responder publicamente a um comentário da Live. A Meta não suporta respostas, ocultações nem exclusões em comentários de vídeo ao vivo; a rota é uma resposta privada durante a transmissão.
- Deixar respostas privadas para depois da Live. Quando a transmissão termina, elas não podem mais ser enviadas, então responda enquanto ela está no ar.
- Tratar live_comments como histórico. As notificações param quando a transmissão termina e a Meta não guarda nenhuma para consulta, então armazene o que precisa conforme cada uma chega.
reply_to_comment responde publicamente ou com resposta privada, e as regras de comentário para DM rodam 24 horas por dia. De US$ 9 até US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
O webhook de comentários do Instagram inclui comentários de Live?
Não. Comentários feitos durante uma transmissão ao vivo chegam no campo live_comments separado, com o mesmo formato de value.
Quando a Meta adicionou o webhook live_comments?
Em 9 de novembro de 2021, para comentários em vídeos ao vivo enquanto estão sendo transmitidos.
Por que meu webhook live_comments parou?
Provavelmente a transmissão terminou, o que para as notificações de comentários de mídia ao vivo. Se nunca começou, verifique o Advanced Access, a inscrição da conta e se a conta é pública.
Com que rapidez um app pode enviar respostas privadas a comentários de Live do Instagram?
Até 100 por segundo por conta, a taxa de resposta privada da Meta para comentários em uma Live, contra 750 por hora para comentários em posts e Reels. Cada uma precisa sair antes do fim da transmissão.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em