Mentions

Identifiez des légendes, des commentaires et des objets IG Media dans lesquels l’alias d’un compte Instagram Business ou Creator a été identifié ou @mentionné.

Limitations

Les mentions ne sont pas prises en charge dans les stories.
Il est impossible d’ajouter des commentaires aux photos dans lesquelles vous avez été identifié.
Les webhooks ne sont pas envoyés si le média dans lequel apparaît le commentaire ou la @mention a été créé par un compte défini comme privé.

Points de terminaison

L’API se compose des points de terminaison suivants :

GET /{ig-user-id}/tags : permet d’obtenir les objets médias dans lesquels un compte Business ou Creator a été identifié
GET /{ig-user-id}?fields=mentioned_comment : permet d’obtenir des données sur un commentaire dans lequel un compte Business ou Creator a été @mentionné
GET /{ig-user-id}?fields=mentioned_media : permet d’obtenir des données sur un objet média dans lequel un compte Business ou Creator a été @mentionné dans une légende
POST /{ig-user-id}/mentions : permet de répondre à un commentaire ou à une légende d’un objet média dans lequel un compte Business ou Creator a été @mentionné par un autre utilisateur Instagram

Pour obtenir des instructions d’utilisation, consultez la documentation de référence sur chaque point de terminaison.

Webhooks

Abonnez-vous au champ mentions pour recevoir les notifications relatives aux webhooks Instagram lorsqu’un utilisateur Instagram mentionne un compte Instagram Business ou Creator. Notez que nous ne stockons pas les données des notifications relatives aux webhooks. Si vous configurez un webhook qui écoute les mentions, vous devez stocker toutes les données reçues que vous souhaitez utiliser par la suite.

Exemples

Écouter les @mentions dans les commentaires et y répondre

Vous pouvez écouter les @mentions dans les commentaires et répondre à celles qui correspondent à vos critères :

Configurez un webhook Instagram abonné au champ mentions.
Configurez un script destiné à analyser les notifications relatives aux webhooks et à identifier les ID des commentaires.
Utilisez les ID pour interroger le point de terminaison GET /{ig-user-id}/mentioned_comment afin d’obtenir plus d’informations sur chaque commentaire.
Analysez les résultats renvoyés pour identifier les commentaires qui correspondent à vos critères.
Utilisez le point de terminaison POST /{ig-user-id}/mentions pour répondre à ces commentaires.

La réponse apparaîtra sous la forme d’un sous-fil du commentaire dans lequel le compte Business ou Creator a été mentionné.

Écouter les @mentions dans les légendes et y répondre

Vous pouvez écouter les @mentions dans les légendes et répondre à celles qui correspondent à vos critères :

Configurez un webhook Instagram abonné au champ mentions.
Configurez un script destiné à analyser les notifications relatives aux webhooks et à identifier les ID des médias.
Utilisez les ID pour interroger le point de terminaison GET /{ig-user-id}/mentioned_media afin d’obtenir plus d’informations sur chaque objet média.
Analysez les résultats renvoyés pour identifier les objets médias contenant les légendes qui correspondent à vos critères.
Utilisez le point de terminaison POST /{ig-user-id}/mentions pour ajouter des commentaires à ces objets médias.