Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Champs webhook Instagram : la liste complète

Pour un compte professionnel sur Instagram Login, la table des champs webhook de Meta liste comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover et standby, les mentions étant incluses dans comments ; ses exemples ajoutent message_edit. Chacun nécessite instagram_business_basic, ainsi que instagram_business_manage_comments ou, pour la plupart des champs de messagerie, instagram_business_manage_messages. story_insights n'est pas proposé avec Instagram Login.

easyCoexistence abonne chaque compte Instagram connecté à comments, messages et mentions, et transmet ces événements à votre endpoint HTTPS dès leur arrivée, signés avec le secret de ce compte.

8

Champs auxquels un nouveau produit Instagram du App Dashboard est abonné par défaut, notamment comments, messages et message_reactions.

Per app

Les champs sont sélectionnés pour l'application, non par compte : un compte reçoit les champs que l'application a sélectionnés.

Advanced Access

Niveau d'accès que le guide de configuration de Meta indique pour les webhooks Instagram Login, et exige pour les notifications comments et live_comments.

story_insights

Indiqué comme indisponible avec Instagram Login dans le tableau des champs de Meta, qui le propose avec Facebook Login et Unified Login.

10 Sep 2025

Date à laquelle Meta a introduit le webhook message_edit pour Business Login for Instagram et Facebook Login for Business.

Quels champs webhook Instagram Login propose-t-il ?

Voici ces champs, tirés du tableau des champs de Meta, avec ce qui déclenche chacun d'eux selon ses exemples et sa référence webhook. Chaque champ requiert aussi instagram_business_basic en plus de l'autorisation indiquée, et Meta exige l'Advanced Access pour les notifications comments et live_comments.

commentsA comment or reply on the account's posts, Reels, Stories or ads, @mentions included. instagram_business_manage_comments.
live_commentsA comment on the account's Live while it is broadcast. instagram_business_manage_comments.
mentionsNo field of its own with Instagram Login: Meta includes mentions in the comments notification.
messagesA DM: text, attachments, shares, Story replies and mentions, quick replies, deletions, and echoes of the account's own messages. instagram_business_manage_messages.
message_echoesListed with instagram_business_manage_comments; the account's own messages arrive on messages with is_echo set to true.
message_reactionsA person reacts to a message or removes the reaction. instagram_business_manage_messages.
message_editA person edits a message, with mid, text and num_edit. In Meta's examples and changelog, not in its fields table.
messaging_postbacksA tap on an ice breaker, a template's postback button or a persistent menu item. instagram_business_manage_messages.
messaging_referralAn ig.me link with a ref parameter, opened in an existing conversation. instagram_business_manage_messages.
messaging_seenA person reads a message, reported as read.mid. instagram_business_manage_messages.
messaging_optinsListed with instagram_business_manage_messages; Meta's Instagram examples show no payload for it.
messaging_handoverThread control passed, taken or requested between apps under the handover protocol. instagram_business_manage_messages.
standbyA message that arrives while another app controls the conversation. instagram_business_manage_messages.

Quels champs ne sont pas disponibles avec Instagram Login ?

Trois lignes du tableau des champs de Meta ne portent aucune autorisation Instagram Login, donc une application sur Instagram Login ne les reçoit pas, et un autre champ n'existe qu'en dehors de celle-ci :

  • story_insights : les métriques d'une story à son expiration, avec Facebook Login ou Unified Login et instagram_manage_insights. La référence des insights média de Meta indique que le webhook insights n'est pas pris en charge avec Instagram Login.
  • messaging_policy_enforcement et response_feedback : uniquement dans la colonne de l'API de messagerie Instagram de Meta.
  • mentions comme champ à part entière : Facebook Login et Unified Login le listent, avec instagram_manage_comments, alors qu'Instagram Login intègre les mentions dans comments.

Comment s'abonner aux champs ?

En deux endroits. Dans le dashboard App, sous les paramètres webhook du produit Instagram, enregistrez l'URL de rappel et le token de vérification, ce qui déclenche la requête de vérification de Meta, puis sélectionnez les champs ; un nouveau produit Instagram démarre abonné à huit d'entre eux. Ensuite, abonnez chaque compte avec POST /<IG_ID>/subscribed_apps sur graph.instagram.com, avec subscribed_fields défini sur les champs sélectionnés dans le dashboard, séparés par des virgules.

Subscribing one account to three fields
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
  ?subscribed_fields=comments,messages,message_reactions
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{ "success": true }

Chaque compte peut-il recevoir des champs différents ?

Non. Le guide de configuration de Meta indique qu'on ne peut pas sélectionner les champs compte par compte : un compte reçoit les champs sélectionnés pour l'application. subscribed_fields sur l'abonnement du compte doit reprendre les champs du dashboard ; un gestionnaire doit donc s'attendre à tout champ sélectionné par l'application et décider selon le contenu de chaque événement, et non selon ce qu'il a demandé pour un compte.

Comment distinguer les champs dans une notification ?

Par la forme de l'entrée. Les champs de commentaires arrivent dans un tableau changes, chaque change nommant son champ. Les champs de messagerie arrivent dans un tableau messaging sans nom de champ, et la clé à côté de sender, recipient et timestamp permet de les distinguer :

  • changes[].field : comments ou live_comments, avec le commentaire dans value.
  • message : messages, y compris les échos des messages du compte, qui portent is_echo à true.
  • reaction : message_reactions. postback : messaging_postbacks. read : messaging_seen. message_edit : message_edit.
  • referral à côté de sender : messaging_referral. Un referral dans message relève de messages, à partir d'un nouveau fil ou d'une annonce Click-to-Direct.
  • pass_thread_control, take_thread_control ou request_thread_control : messaging_handover, tels que les listent la référence webhook de Meta.

À quels champs easyCoexistence s'abonne-t-il ?

comments, messages et mentions, la liste à laquelle chaque compte Instagram est abonné à sa connexion. Avec Instagram Login, les mentions sont incluses dans comments, donc l'abonnement couvre les commentaires et les DM, avec les échos, les réponses aux stories, les mentions dans les stories et les pièces jointes parmi les DM. Les autres champs du tableau sont livrés par Meta à une application qui y est abonnée et ne font pas partie de l'abonnement d'une connexion. Une fois un endpoint défini avec set_social_webhook_destination ou l'API Partner, easyCoexistence vérifie la signature de Meta, répond immédiatement à Meta et envoie chaque entrée du compte à celui-ci en POST :

  • platform et external_id : instagram, et l'ID Instagram du compte, égal à entry.id.
  • account_id : l'ID de la connexion dans easyCoexistence, celui qu'utilisent les outils MCP.
  • entry : l'entrée de Meta pour le compte, inchangée. Le champ object de Meta et son en-tête X-Hub-Signature-256 ne sont pas transmis.
  • X-EC-Signature : t=<unix>,v1=<hex>, un HMAC-SHA256 du timestamp, d'un point et du corps brut, avec le secret propre au compte comme clé.
  • Livraison : une tentative d'au plus 8 secondes, sans suivre les redirections, sans copie conservée et sans nouvelle tentative.

Erreurs courantes

  • Attendre un champ mentions avec Instagram Login. Meta intègre les mentions dans la notification comments, donc un gestionnaire lié au champ mentions ne s'exécute jamais.
  • Supposer qu'un compte ne reçoit que les champs nommés par son propre abonnement. Meta livre les champs sélectionnés pour l'application ; il faut donc se baser sur le contenu de chaque événement.
  • Traiter message.referral et un referral de premier niveau comme un seul événement. Le premier passe par messages ; le second est messaging_referral, pour un lien ig.me ouvert dans une conversation existante.
  • Attendre story_insights avec Instagram Login. Meta l'indique comme indisponible là-bas ; lisez donc les métriques d'une story via l'endpoint des insights pendant qu'elle est active.
Faire cela avec EasyCoexistence

Les événements ne sont pas stockés par défaut ; un compte dont une automatisation est activée conserve ses DM et ses commentaires pendant 7 jours. Définissez l'endpoint avec set_social_webhook_destination depuis Claude ou ChatGPT, ou avec l'API Partner. 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

Instagram Login dispose-t-il d'un champ webhook mentions ?

Pas de champ distinct. Meta inclut les mentions dans la notification comments pour Instagram Login ; mentions est un champ à part entière avec Facebook Login et Unified Login.

story_insights est-il disponible avec Instagram Login ?

Non. Le tableau des champs de Meta l'indique comme indisponible pour Instagram Login, et sa référence des insights média précise que le webhook insights n'y est pas pris en charge.

Quelles autorisations le webhook de messagerie Instagram requiert-il ?

instagram_business_basic et instagram_business_manage_messages, avec Advanced Access, que le guide de configuration de Meta indique pour les webhooks Instagram Login.

Quand Meta a-t-il ajouté le webhook message_edit pour Instagram ?

Le 10 septembre 2025, pour Business Login for Instagram et Facebook Login for Business. Une modification arrive dans le tableau messaging sous une clé message_edit.

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