Webhook des commentaires Instagram : le payload, champ par champ
Le webhook des commentaires Instagram prévient une application quand quelqu'un commente, ou répond à un commentaire, sur un média d'un compte professionnel, Reels compris. Meta envoie une modification dont le champ vaut comments et dont la valeur porte l'id et le texte du commentaire, l'ID propre à Instagram de l'auteur et son nom d'utilisateur dans from, l'id et le type de produit du média, ainsi que parent_id lorsque le commentaire est une réponse.
easyCoexistence abonne chaque compte Instagram connecté aux commentaires et transmet à votre endpoint HTTPS les événements comments que Meta envoie pour lui, dès leur arrivée, signés avec le secret de ce compte et sans copie conservée.
Présent lorsque le commentaire est une réponse, il contient l'ID du commentaire auquel il répond.
Ajouté à from lorsque le compte commente ses propres médias, à côté de l'ID du compte.
Champ distinct pour les commentaires pendant une diffusion Live ; ses notifications s'arrêtent à la fin de la diffusion.
Requis pour les notifications comments et live_comments ; les médias de comptes privés ne déclenchent aucune notification.
Délai restant pour envoyer au commentateur une seule réponse privée, adressée par l'ID du commentaire.
Quand le champ comments se déclenche-t-il ?
Lorsque quelqu'un commente un média appartenant au compte professionnel, ou mentionne le compte, une fois l'application et le compte tous deux abonnés au champ. Chaque commentaire correspond à une modification de la notification, et ces cas partagent la même forme :
- Un nouveau commentaire sur une publication, un Reel, une Story ou une publicité, avec media.
media_product_typeindiquant sur quelle surface se trouve le média. - Une réponse à un commentaire existant, qui porte
parent_idavec l'ID du commentaire auquel elle répond. - Un commentaire que le compte fait sur ses propres médias, réponses comprises : from.id est l'ID du compte lui-même, et from ajoute
self_ig_scoped_id. - Une @mention du compte : avec Instagram Login, Meta inclut les mentions dans la notification des commentaires plutôt que dans un champ à part.
- Un commentaire pendant une diffusion Live arrive sur un champ distinct,
live_comments, avec la même forme de valeur, et s'arrête à la fin de la diffusion.
À quoi ressemble une notification de commentaires ?
Un POST dont le JSON a object défini sur instagram et un tableau entry. Chaque entrée correspond à un compte professionnel : son ID, l'heure d'envoi de la notification par Meta, et un tableau changes contenant une modification par commentaire. Une réponse sous un Reel ressemble à ceci :
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}Que signifie chaque champ ?
Les champs que la référence webhook de Meta liste pour un commentaire, de l'extérieur vers l'intérieur :
- entry[].id : l'ID du compte professionnel, le
user_idque renvoie /me pour lui. Il indique à quel compte appartient le commentaire. - entry[].time : l'heure d'envoi de la notification par Meta, sous forme d'horodatage Unix. Ce n'est pas l'heure à laquelle le commentaire a été écrit.
- changes[].field : comments, ou
live_commentspour une diffusion Live. Vérifiez-le avant de lire value. - value.id : l'ID du commentaire, celui auquel répondre publiquement ou en privé, à masquer ou à supprimer.
- value.text : le texte du commentaire, inclus lorsque le commentaire contient du texte.
- value.from.id et value.from.username : l'ID propre à Instagram de l'auteur et son nom d'utilisateur. value.from.
self_ig_scoped_idapparaît lorsque le compte lui-même a écrit le commentaire. - value.media.id et value.media.
media_product_type: le média commenté et sa surface ; la référence média de Meta nomme AD, FEED, STORY et REELS. - value.
parent_id: sur une réponse, l'ID du commentaire auquel elle répond. Un commentaire de premier niveau n'en a pas. - value.media.
ad_id,ad_titleetoriginal_media_id: listés dans la référence pour les commentaires faits sur une publicité.
Que ne signale pas le champ comments ?
Certaines choses qu'un gestionnaire pourrait attendre sont absentes de l'événement ou jamais envoyées, selon le guide de configuration et les références de Meta :
- Les commentaires sur les médias d'un compte privé : Meta n'envoie aucune notification de commentaire ou de mention pour eux.
- Les ID d'albums : l'événement ne les inclut pas, et Meta indique de rechercher l'album à partir de l'ID du commentaire.
- Les ID de publicité pour les médias utilisés dans les publicités dynamiques.
- L'heure de création du commentaire : GET /<
COMMENT_ID>?fields=timestamp la renvoie au format ISO 8601. - Les commentaires Live après la fin de la diffusion, moment où les notifications des médias live s'arrêtent.
- Les mentions dans les Stories, que l'API de mentions de Meta ne prend pas en charge ; elles parviennent au compte sous forme de DM à la place.
- Les événements passés : Meta ne conserve aucun historique de notifications à interroger, donc stockez ce dont vous avez besoin à mesure que chacun arrive.
De quoi le champ comments a-t-il besoin ?
Avec Instagram Login, les permissions instagram_business_basic et instagram_business_manage_comments, et l'Advanced Access, que Meta exige pour les notifications comments et live_comments. L'application doit être Live et abonnée à comments dans le tableau de bord de l'application, et chaque compte doit être abonné via POST /<IG_ID>/subscribed_apps avec comments parmi ses subscribed_fields. Meta recommande fortement ce webhook plutôt que le polling pour les commentaires, car il épargne la limite de débit.
Comment répondre à un commentaire depuis l'événement ?
Avec les ID qu'il contient. POST /<COMMENT_ID>/replies avec un message publie une réponse publique sous le commentaire, en utilisant value.id. POST /<IG_ID>/messages avec recipient.comment_id défini sur value.id envoie à l'auteur une seule réponse privée, dans les 7 jours suivant le commentaire, ou pendant la durée de la diffusion en Live. from.id est un ID propre à Instagram, mais un DM envoyé directement à cet ID échoue tant que la personne n'a pas écrit au compte ; la réponse privée est donc le moyen de la joindre par DM.
Comment easyCoexistence transmet-il un commentaire ?
Au fil de leur arrivée, une fois qu'un endpoint est défini pour le compte avec set_social_webhook_destination depuis Claude ou ChatGPT, ou avec PUT /channels/:id/webhook sur la Partner API. easyCoexistence abonne chaque compte connecté aux champs qui portent ses commentaires, mentions et DM, vérifie la signature de Meta sur chaque envoi, répond immédiatement à Meta, et envoie en POST chaque entrée de ce compte à votre URL HTTPS, dans une enveloppe :
- platform et
external_id: instagram, et l'ID Instagram du compte, égal à entry.id. account_id: l'ID de la connexion dans easyCoexistence, celui que renvoielist_social_accountset qu'utilisent les outils MCP.- entry : l'entrée de Meta pour le compte, sans modification, si bien qu'un envoi groupé devient un POST par entrée. Le champ object de Meta et X-Hub-Signature-256 ne sont pas transmis.
- Envoi : une seule tentative, avec une attente de 8 secondes au maximum, sans suivre de redirections, vers une adresse HTTPS qui se résout en une IP publique. Aucune copie n'est conservée et rien n'est réessayé.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}Que font les règles commentaire vers DM avec le même événement ?
Elles le lisent en parallèle du transfert. Une règle s'applique lorsque le commentaire contient l'un de ses mots-clés, sans tenir compte de la casse, sur une publication choisie ou sur toutes, et envoie à l'auteur le DM de la règle comme réponse privée, plus une réponse publique si la règle en prévoit une. Les commentaires du compte lui-même sont ignorés, les automatisations démarrées sur un commentaire prennent ceux auxquels aucune règle n'a répondu, et un commentaire auquel une règle a répondu parvient tout de même à votre endpoint. La réponse publique de la règle peut revenir sous forme de nouvel événement comments émis par le compte lui-même.
Erreurs courantes
- Chercher comment_id. Avec Instagram Login, l'ID du commentaire se trouve dans value.id ; comment_id appartient aux payloads des autres configurations de connexion de Meta.
- Répondre aux commentaires du compte lui-même. Ses réponses reviennent comme des événements comments avec from.id égal à entry.id, et une automatisation qui y répond finit par se parler à elle-même.
- Lire entry.time comme l'heure du commentaire. Il indique quand Meta a envoyé la notification ; le champ d'horodatage propre au commentaire indique quand il a été écrit.
- Attendre les commentaires Live sur le champ comments. Ils arrivent sur live_comments, qui nécessite son propre abonnement et se tait à la fin de la diffusion.
Les règles et automatisations commentaire vers DM répondent aux mêmes commentaires à toute heure. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours gratuits.
Questions fréquemment posées
Le webhook des commentaires Instagram inclut-il les réponses aux commentaires ?
Oui. Une réponse arrive comme son propre événement comments, avec parent_id contenant l'ID du commentaire auquel elle répond.
Les commentaires sur les Reels déclenchent-ils le webhook des commentaires Instagram ?
Oui. Un commentaire sur un Reel arrive sur le champ comments comme un commentaire sur une publication, et media.media_product_type permet de les distinguer.
Pourquoi mon webhook des commentaires Instagram ne se déclenche-t-il pas ?
Le plus souvent, l'application n'est pas Live ou n'a pas l'Advanced Access, le compte n'a jamais été abonné via /subscribed_apps, le média appartient à un compte privé, ou le commentaire a été fait pendant un Live, qui utilise live_comments.
Le webhook des commentaires inclut-il le nom d'utilisateur de l'auteur ?
Oui. value.from contient le nom d'utilisateur de la personne à côté de son ID propre à Instagram, donc aucun appel supplémentaire n'est nécessaire pour savoir qui a commenté.
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