Mentions Instagram via l'API : trouver et répondre aux @mentions
L'API Instagram signale les @mentions d'un compte professionnel dans les commentaires et les légendes des médias publics, et permet au compte d'y répondre directement. Avec Instagram Login, les mentions arrivent sur le webhook des commentaires, et la réponse passe par POST /<IG_ID>/mentions avec l'ID du média, plus l'ID du commentaire pour un commentaire, publiée alors comme commentaire à cet endroit.
easyCoexistence transmet les commentaires, mentions et DM du compte Instagram à votre endpoint dès leur arrivée, signés avec un secret propre à ce compte, une fois celui-ci défini avec set_social_webhook_destination.
Notification webhook incluant les mentions, pour les applications utilisant Instagram Login.
Endpoint qui répond à un commentaire ou à une légende dans lequel un autre utilisateur Instagram a mentionné le compte.
Un média d'un compte privé ne déclenche aucun webhook pour un commentaire ou une @mention le concernant.
Permissions nécessaires aux mentions avec Instagram Login : instagram_business_basic et instagram_business_manage_comments.
Comment les mentions arrivent-elles ?
Par webhook, au fil de l'eau. Avec Instagram Login, Meta inclut les mentions dans la notification de commentaire au lieu d'envoyer un champ mentions séparé, si bien qu'un gestionnaire les lit dans les mêmes événements que les nouveaux commentaires. Meta ne conserve aucun historique des notifications passées : enregistrez donc ce dont vous avez besoin dès leur arrivée.
Quelles mentions l'API couvre-t-elle ?
L'API de mentions de Meta identifie les légendes, les commentaires et les médias dans lesquels un compte professionnel ou créateur a été @mentionné ou identifié :
- @mentions dans les commentaires.
- @mentions dans la légende d'une publication.
- Médias dans lesquels le compte est identifié, listés par GET /<
IG_ID>/tags ; commenter les photos où le compte est seulement identifié n'est pas pris en charge. - Pas les Stories : l'API de mentions ne les prend pas en charge, et une mention dans une Story arrive au compte sous forme de DM dont le type de pièce jointe est
story_mention. - Pas les comptes privés : les médias qu'ils possèdent n'envoient aucun webhook de mention.
Comment répondre à une mention ?
Avec POST /<IG_ID>/mentions. Pour une mention dans un commentaire, envoyez media_id et comment_id avec le message ; la réponse apparaît alors dans le fil de ce commentaire. Pour une mention dans une légende, envoyez media_id et le message ; elle est publiée comme commentaire sur le média. Les deux identifiants proviennent de la notification webhook.
POST https://graph.instagram.com/<IG_ID>/mentions
?media_id=<MEDIA_ID>
&comment_id=<COMMENT_ID>
&message=<REPLY_TEXT>De quelles permissions les mentions ont-elles besoin ?
Avec Instagram Login, les permissions instagram_business_basic et instagram_business_manage_comments, la même paire qu'utilise la modération des commentaires, les appels passant par graph.instagram.com. Pour servir des comptes professionnels que le développeur ne possède pas ou ne gère pas, l'application a aussi besoin de l'Advanced Access.
Erreurs courantes
- Attendre un événement de mention séparé avec Instagram Login. Meta livre les mentions à l'intérieur de la notification de commentaire.
- Répondre à une mention sur la publication d'un autre compte comme à un commentaire sur le sien. La route de Meta pour cela est POST /<IG_ID>/mentions, avec l'ID du média et, pour un commentaire, l'ID du commentaire.
- Espérer des mentions de Stories via l'API de mentions. Meta ne les prend pas en charge ; elles arrivent au compte sous forme de DM.
- Compter sur le webhook pour rejouer d'anciennes mentions. Meta ne conserve aucun historique de notifications : enregistrez chacune dès son arrivée.
Ses outils répondent aux commentaires de vos propres publications avec reply_to_comment ; répondre à une mention sur la publication de quelqu'un d'autre, qui passe par l'endpoint mentions de Meta, n'en fait pas partie. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours en essai gratuit.
Questions fréquemment posées
Puis-je commenter une photo où mon compte est identifié ?
Non. GET /<IG_ID>/tags liste les médias dans lesquels le compte est identifié, mais Meta ne prend pas en charge les commentaires sur les photos où le compte est seulement identifié.
Puis-je répondre à une mention sur la publication de quelqu'un d'autre ?
Oui. POST /<IG_ID>/mentions avec l'ID du média, et l'ID du commentaire lorsque la mention figure dans un commentaire, publie la réponse à cet endroit au nom du compte.
Les mentions de Stories sont-elles disponibles via l'API de mentions ?
Non. Une mention dans une Story arrive au compte sous forme de DM dont le type de pièce jointe est story_mention, et peut recevoir une réponse dans cette conversation.
Pourquoi une mention n'est-elle jamais arrivée ?
Le média peut appartenir à un compte privé, qui n'envoie aucune notification de mention, ou la mention peut figurer dans une Story, que l'API de mentions ne couvre pas.
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