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.
Champs auxquels un nouveau produit Instagram du App Dashboard est abonné par défaut, notamment comments, messages et message_reactions.
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.
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.
Indiqué comme indisponible avec Instagram Login dans le tableau des champs de Meta, qui le propose avec Facebook Login et Unified Login.
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.
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 etinstagram_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_enforcementetresponse_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.
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_controlourequest_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.
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