Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Webhook live_comments do Instagram: comentários durante uma transmissão em direto

O campo live_comments do webhook do Instagram notifica uma app dos comentários na transmissão em direto de uma conta profissional enquanto esta está no ar. Cada comentário chega como uma alteração com o campo definido como live_comments e a mesma forma de valor que o campo comments: o id e o texto do comentário, o ID com âmbito do Instagram e o nome de utilizador do autor em from, e o id do media. As notificações param quando a transmissão termina.

O easyCoexistence subscreve cada conta do Instagram ligada a comentários, mensagens e menções, e encaminha os comentários nas suas publicações e Reels para o seu endpoint HTTPS à medida que chegam, assinados com o segredo dessa conta.

Advanced Access

Necessária para as notificações live_comments, tal como para comments; o media de uma conta privada não envia nenhuma.

100/sec

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

Broadcast end

Quando as notificações de comentários de media em direto param.

During the Live

Quando se pode enviar uma resposta privada a um comentário numa Live; depois de a transmissão terminar, já não é possível.

9 Nov 2021

Quando a Meta introduziu o live_comments, para comentários em vídeos em direto enquanto são transmitidos.

Quando é que o live_comments dispara?

Quando alguém comenta o vídeo em direto de uma conta profissional enquanto está a ser transmitido, desde que a app e a conta estejam subscritas ao campo. É separado de comments: um comentário numa publicação, Reel, Story ou anúncio chega em comments, e um comentário durante uma Live chega em live_comments. As notificações de media em direto param quando a transmissão termina, e o media de uma conta privada não dispara nenhuma.

Qual é o aspeto de uma notificação live_comments?

O envelope de um comentário: object definido como instagram, uma entrada por conta e um array changes cujo campo indica live_comments. O exemplo de Instagram Login da Meta usa uma só forma de valor para comments e live_comments, por isso é o nome do campo que os distingue:

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 webhooks da Meta lista para live_comments, de fora para dentro:

  • entry[].id: a conta profissional. entry[].time: quando a Meta enviou a notificação, e não quando o comentário foi escrito.
  • changes[].field: live_comments. Verifique-o antes de ler value, já que a forma coincide com a de comments.
  • value.id: o ID do comentário, aquele a que se dirige uma resposta privada.
  • value.text: o texto do comentário.
  • value.from.id e value.from.username: o ID com âmbito do Instagram e o nome de utilizador do autor; from.self_ig_scoped_id aparece quando a própria conta comenta.
  • value.media.id e value.media.media_product_type: o vídeo em direto e o local onde se encontra.
  • value.parent_id: na referência, para um comentário que responde a outro comentário.

Em que se diferencia live_comments de comments?

A carga coincide, mas as regras não. As referências de comentários da Meta tratam os comentários em vídeos em direto como um caso à parte, e os seus limites de pedidos e as regras de respostas privadas 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 se responde a um comentário de 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 mensagem direta, que chega à caixa de entrada se ele seguir a conta e aos pedidos de mensagem se não a seguir. As referências da Meta excluem as vias públicas em vídeos em direto: responder, criar, ocultar e apagar comentários aí não é suportado. Quando a transmissão termina, já não se podem enviar respostas privadas aos 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>" }
}

Os comentários de uma Live podem ser lidos sem o webhook?

Só enquanto a Live durar. A referência de comentários da Meta diz que os comentários em vídeos em direto só podem ser lidos enquanto a media estiver a ser transmitida, e a referência de media diz o mesmo do próprio vídeo em direto. A aresta live_media, que lista a Live atual da conta, está documentada para o Facebook Login em graph.facebook.com. A Meta não guarda um histórico de notificações para consultar, por isso guarde o que precisa de cada evento à medida que chega.

Do que precisa o live_comments?

Com Instagram Login, instagram_business_basic e instagram_business_manage_comments, o mesmo par que comments, mais o Advanced Access, que a Meta exige para as notificações de comments e de live_comments. Um novo produto Instagram no painel da app começa subscrito a live_comments, e cada conta é subscrita através de POST /<IG_ID>/subscribed_apps. A conta que é dona da Live tem de ser pública.

O easyCoexistence reencaminha os comentários de Live?

Não. A app da easyCoexistence e cada conta ligada estão subscritas a comments, messages e mentions, e não a live_comments, pelo que os comentários feitos durante uma Live não são reencaminhados. Os comentários em publicações e Reels são, e reply_to_comment, hide_comment, as regras de comentário para DM e as automatizações podem atuar sobre eles.

Erros comuns

  • Esperar comentários de Live no campo comments. Chegam em live_comments, com o campo definido como live_comments, e é preciso selecioná-lo na app.
  • Responder publicamente a um comentário de Live. A Meta não suporta respostas, ocultações nem eliminações em comentários de vídeos em direto; o caminho é uma resposta privada durante a transmissão.
  • Deixar as respostas privadas para depois da Live. Quando a transmissão termina já não podem ser enviadas, por isso responda enquanto 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 consultar, por isso guarde o que precisa à medida que cada uma chega.
Fazer isto com a EasyCoexistence

reply_to_comment responde publicamente ou com uma resposta privada, e as regras de comentário para mensagem direta funcionam em permanência. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

O webhook de comentários do Instagram inclui os comentários de Live?

Não. Os comentários feitos durante uma transmissão em direto chegam no campo live_comments, separado, com a mesma forma de valor.

Quando é que a Meta adicionou o webhook live_comments?

Em 9 de novembro de 2021, para comentários em vídeos em direto enquanto são transmitidos.

Porque é que o meu webhook live_comments parou?

Muito provavelmente a transmissão terminou, o que interrompe as notificações de comentários de media em direto. Se nunca chegou a começar, verifique o Advanced Access, a subscrição da conta e se a conta é pública.

Com que rapidez pode uma app enviar respostas privadas a comentários de Live do Instagram?

Até 100 por segundo por conta, a taxa de respostas privadas da Meta para comentários numa Live, contra 750 por hora para comentários em publicações e Reels. Cada uma tem de sair antes de a transmissão terminar.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em