Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

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.

parent_id

Présent lorsque le commentaire est une réponse, il contient l'ID du commentaire auquel il répond.

self_ig_scoped_id

Ajouté à from lorsque le compte commente ses propres médias, à côté de l'ID du compte.

live_comments

Champ distinct pour les commentaires pendant une diffusion Live ; ses notifications s'arrêtent à la fin de la diffusion.

Advanced Access

Requis pour les notifications comments et live_comments ; les médias de comptes privés ne déclenchent aucune notification.

7 days

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_type indiquant sur quelle surface se trouve le média.
  • Une réponse à un commentaire existant, qui porte parent_id avec 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 :

A comments notification, as Meta sends it
{
  "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_id que 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_comments pour 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_id apparaî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_title et original_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 renvoie list_social_accounts et 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é.
A forwarded comment, headers included
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.
Faire cela avec EasyCoexistence

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