EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

Advanced Access

Exigido para notificações de live_comments, como para comentários; mídia de conta privada não envia nenhuma.

100/sec

Respostas privadas por segundo que um app pode enviar por conta a comentários em uma Live do Instagram.

Broadcast end

Quando as notificações de comentários de mídia ao vivo param.

During the Live

Quando uma resposta privada a um comentário da Live pode ser enviada; depois que a transmissão termina, não pode mais.

9 Nov 2021

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:

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

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_id aparece 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:

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

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.

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

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.
Fazendo isso com o EasyCoexistence

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