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.
Necessária para as notificações live_comments, tal como para comments; o media de uma conta privada não envia nenhuma.
Respostas privadas por segundo que uma app pode enviar, por conta, a comentários numa Live do Instagram.
Quando as notificações de comentários de media em direto param.
Quando se pode enviar uma resposta privada a um comentário numa Live; depois de a transmissão terminar, já não é possível.
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:
{
"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_idaparece 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:
| 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 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.
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.
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