Webhook live_comments d'Instagram : commentaires pendant une diffusion Live
Le champ live_comments du webhook d'Instagram signale à une application les commentaires posés sur la diffusion Live d'un compte professionnel pendant qu'elle est en cours. Chaque commentaire arrive sous la forme d'un élément de changes dont field vaut live_comments, avec la même structure de valeur que le champ comments : l'id et le texte du commentaire, l'ID à portée Instagram et le nom d'utilisateur de l'auteur dans from, et l'id du média. Les notifications s'arrêtent à la fin de la diffusion.
easyCoexistence abonne chaque compte Instagram connecté aux commentaires, messages et mentions, et transmet à votre endpoint HTTPS les commentaires sur ses publications et Reels dès leur arrivée, signés avec le secret de ce compte.
Requis pour les notifications live_comments, comme pour comments ; un média d'un compte privé n'en envoie aucune.
Réponses privées par seconde qu'une application peut envoyer par compte aux commentaires d'un Live Instagram.
Moment où les notifications de commentaires d'un média en direct s'arrêtent.
Moment où une réponse privée à un commentaire de Live peut être envoyée ; une fois la diffusion terminée, ce n'est plus possible.
Date à laquelle Meta a introduit live_comments, pour les commentaires sur les vidéos en direct pendant leur diffusion.
Quand live_comments se déclenche-t-il ?
Lorsqu'une personne commente la vidéo Live du compte professionnel pendant sa diffusion, une fois l'application et le compte abonnés au champ. Il est distinct de comments : un commentaire sur une publication, un Reel, une story ou une annonce arrive sur comments, et un commentaire pendant un Live arrive sur live_comments. Les notifications des médias en direct s'arrêtent à la fin de la diffusion, et un média d'un compte privé ne déclenche rien.
À quoi ressemble une notification live_comments ?
L'enveloppe d'un commentaire : object à instagram, une entrée par compte et un tableau changes dont le champ vaut live_comments. L'exemple de connexion Instagram de Meta donne une seule structure de valeur pour comments et live_comments, donc c'est le nom du champ qui les 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>"
}
}
}
]
}
]
}Que signifie chaque champ ?
Les champs que la référence des webhooks de Meta liste pour live_comments, de l'extérieur vers l'intérieur :
- entry[].id : le compte professionnel. entry[].time : le moment où Meta a envoyé la notification, et non celui où le commentaire a été écrit.
- changes[].field :
live_comments. Vérifiez-le avant de lire value, car la structure est la même que pour comments. - value.id : l'ID du commentaire, celui auquel une réponse privée est adressée.
- value.text : le texte du commentaire.
- value.from.id et value.from.username : l'ID à portée Instagram et le nom d'utilisateur de l'auteur ; from.
self_ig_scoped_idapparaît lorsque le compte commente lui-même. - value.media.id et value.media.
media_product_type: la vidéo Live et le support sur lequel elle se trouve. - value.
parent_id: dans la référence, pour un commentaire qui répond à un autre commentaire.
En quoi live_comments diffère-t-il de comments ?
La structure du payload est la même, mais les règles ne le sont pas. Les références des commentaires de Meta traitent les commentaires sur les vidéos en direct à part, et ses limites de débit et ses règles de réponse privée leur donnent d'autres valeurs. Côte à côte, le champ comments à gauche :
| 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 |
Comment répondre à un commentaire de Live ?
Par une réponse privée, pendant la diffusion. POST /<IG_ID>/messages avec recipient.comment_id défini sur l'ID du commentaire envoie à son auteur un DM, qui arrive dans sa boîte de réception s'il suit le compte, et dans les demandes de messages sinon. Les références de Meta excluent les voies publiques sur les vidéos en direct : répondre, créer, masquer et supprimer des commentaires n'y sont pas pris en charge. Une fois la diffusion terminée, les réponses privées à ses commentaires ne peuvent plus être envoyées.
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>" }
}Peut-on lire les commentaires d'un Live sans le webhook ?
Seulement pendant la durée du Live. La référence des commentaires de Meta indique que ceux d'une vidéo en direct ne peuvent être lus que pendant la diffusion du média, et sa référence des médias dit la même chose de la vidéo Live elle-même. Son edge live_media, qui liste le Live en cours du compte, est documenté pour Facebook Login sur graph.facebook.com. Meta ne conserve aucun historique de notifications à interroger : enregistrez donc ce dont vous avez besoin à chaque événement dès sa réception.
Que faut-il pour live_comments ?
Avec Instagram Login, instagram_business_basic et instagram_business_manage_comments, soit la même paire que pour comments, ainsi que Advanced Access, que Meta exige pour les notifications comments et live_comments. Un nouveau produit Instagram dans l'App Dashboard est abonné d'emblée à live_comments, et chaque compte s'abonne via POST /<IG_ID>/subscribed_apps. Le compte qui possède le Live doit être public.
easyCoexistence transmet-il les commentaires de Live ?
Non. L'app d'easyCoexistence et chaque compte connecté sont abonnés aux commentaires, messages et mentions, et non à live_comments : les commentaires faits pendant un Live ne sont donc pas transmis. Ceux sur les publications et les Reels le sont, et reply_to_comment, hide_comment, les règles commentaire-vers-DM et les automatisations peuvent agir dessus.
Erreurs courantes
- Attendre les commentaires de Live sur le champ comments. Ils arrivent sur live_comments, avec field à live_comments, et ce champ doit être sélectionné pour l'application.
- Répondre publiquement à un commentaire de Live. Meta ne prend pas en charge les réponses, masquages ni suppressions sur les commentaires de vidéos en direct ; la réponse privée pendant la diffusion est la voie à suivre.
- Mettre les réponses privées en file d'attente pour après le Live. Une fois la diffusion terminée, elles ne peuvent plus être envoyées : répondez pendant qu'elle est en cours.
- Traiter live_comments comme un historique. Les notifications s'arrêtent à la fin de la diffusion et Meta n'en conserve aucune à interroger : enregistrez ce dont vous avez besoin à mesure que chacune arrive.
reply_to_comment répond publiquement ou par réponse privée, et les règles commentaire-vers-DM fonctionnent en permanence. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Le webhook de commentaires Instagram inclut-il les commentaires de Live ?
Non. Les commentaires posés pendant une diffusion Live arrivent sur le champ distinct live_comments, avec la même structure de valeur.
Quand Meta a-t-il ajouté le webhook live_comments ?
Le 9 novembre 2021, pour les commentaires sur les vidéos en direct pendant leur diffusion.
Pourquoi mon webhook live_comments s'est-il arrêté ?
Très probablement parce que la diffusion s'est terminée, ce qui arrête les notifications de commentaires des médias en direct. Si elle n'a jamais démarré, vérifiez Advanced Access, l'abonnement du compte et que le compte est public.
Quelle est la vitesse d'envoi des réponses privées aux commentaires de Live Instagram ?
Jusqu'à 100 par seconde et par compte, la limite de réponses privées de Meta pour les commentaires d'un Live, contre 750 par heure pour les commentaires sur les publications et Reels. Chacune doit partir avant la fin de la diffusion.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le