API Graph pour Instagram

Mentions d’un utilisateur IG

Cette arête permet de créer un Commentaire IG sur un Commentaire IG ou un objet IG Media de légende dans lequel un Utilisateur IG a été @mentionné par un autre utilisateur Instagram.

Création

Réponse à un objet IG Media de légende

POST /{ig-user-id}/mentions?media_id={media_id}&message={message}

Crée un Commentaire IG sur un objet IG Media dans lequel un Utilisateur IG a été @mentionné dans une légende.

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 contenu multimédia dans lequel apparaît le commentaire ou la @mention a été créé par un compte défini comme privé.

Paramètres de chaîne de requête

Les paramètres de chaîne de requête sont facultatifs, sauf mention contraire.

  • {media_id} (obligatoire) : ID de média contenu dans la charge utile de la notification du Webhook
  • {message} (obligatoire) : texte à inclure dans le commentaire

Autorisations

Un token d’accès utilisateur Facebook avec les autorisations suivantes :

  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

Si le token émane d’un utilisateur ou une utilisatrice dont le rôle sur la Page a été attribué par le biais du compte Business Manager, l’une des autorisations suivantes est également requise :

  • ads_management
  • pages_read_engagement
  • business_management

Exemple de demande cURL

curl -i -X POST \
 -d "media_id=17920112008063024" \
 -d "message=Thanks%20for%20the%20dinosaur!" \
 -d "access_token=a-valid-access-token-goes-here" \
 "https://graph.facebook.com/17841405309211844/mentions"

Exemple de réponse

{
  "id": "17846319838228163"
}

Réponse à un commentaire

POST /{ig-user-id}/mentions?media_id={media_id}&comment_id={comment_id}&message={message}

Crée un Commentaire IG sur un Commentaire IG dans lequel un Utilisateur IG a été @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 contenu multimédia dans lequel apparaît le commentaire ou la @mention a été créé par un compte défini comme privé.

Paramètres de chaîne de requête

Les paramètres de chaîne de requête sont facultatifs, sauf mention contraire.

  • {comment_id} (obligatoire) : ID de commentaire contenu dans la charge utile de la notification du Webhook
  • {media_id} (obligatoire) : ID de média contenu dans la charge utile de la notification du Webhook
  • {message} (obligatoire) : texte à inclure dans le commentaire

Autorisations

Un token d’accès utilisateur Facebook avec les autorisations suivantes :

  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

Si le token émane d’un utilisateur ou une utilisatrice dont le rôle sur la Page a été attribué par le biais du compte Business Manager, l’une des autorisations suivantes est également requise :

  • ads_management
  • pages_read_engagement
  • business_management

Paramètres

  • comment_id (obligatoire)
  • media_id (obligatoire)
  • message

Exemple de demande cURL

curl -i -X POST \
 -d "media_id=17920112008063024" \
 -d "comment_id=17918718562020960" \
 -d "message=Hope%20you%20enjoy%20your%20new%20T-Rex!" \
 -d "access_token=a-valid-access-token-goes-here" \
 "https://graph.facebook.com/17841405309211844/mentions"

Exemple de réponse

{
  "id": "17846319838254687"
}

Affichage

Cette opération n’est pas prise en charge.

Mise à jour

Cette opération n’est pas prise en charge.

Suppression

Cette opération n’est pas prise en charge.