API Graph de Instagram

Menciones de usuarios de IG

Este perímetro permite crear un comentario de IG sobre un comentario de IG o sobre un objeto multimedia de IG con texto en el que otro usuario de Instagram @mencionó a un usuario de IG.

Creación

En respuesta a un objeto multimedia de IG con texto

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

Crea un comentario de IG sobre un objeto multimedia de IG en el que se @mencionó a un usuario de IG en un texto.

Limitaciones

  • Las menciones en historias no son compatibles.
  • Los comentarios en fotos en las que te etiquetaron no son compatibles.
  • No se enviarán webhooks si el contenido multimedia en el que se aparece el comentario o la @mención fue creado por una cuenta configurada como privada.

Parámetros de cadena de la consulta

Los parámetros de cadena de la consulta son opcionales, a menos que se indique que son obligatorios.

  • {media_id} (obligatorio): el identificador de objetos multimedia que figura en la carga de la notificación del webhook
  • {message} (obligatorio): el texto a incluir en el comentario

Permisos

Un token de acceso de usuario de Facebook con los siguientes permisos:

  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

Si el token es de un usuario al que se le asignó un rol de página mediante el administrador comercial, también se requiere uno de los siguientes permisos:

  • ads_management
  • pages_read_engagement
  • business_management

Ejemplo de solicitud de 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"

Ejemplo de respuesta

{
  "id": "17846319838228163"
}

Responder a un comentario

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

Crea un comentario de IG sobre un comentario de IG en el que se @mencionó a un usuario de IG.

Limitaciones

  • Las menciones en historias no son compatibles.
  • Los comentarios en fotos en las que te etiquetaron no son compatibles.
  • No se enviarán webhooks si el contenido multimedia en el que se aparece el comentario o la @mención fue creado por una cuenta configurada como privada.

Parámetros de cadena de la consulta

Los parámetros de cadena de la consulta son opcionales, a menos que se indique que son obligatorios.

  • {comment_id} (obligatorio): el identificador del comentario que figura en la carga de la notificación del webhook
  • {media_id} (obligatorio): el identificador de objetos multimedia que figura en la carga de la notificación del webhook
  • {message} (obligatorio): el texto a incluir en el comentario

Permisos

Un token de acceso de usuario de Facebook con los siguientes permisos:

  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

Si el token es de un usuario al que se le asignó un rol de página mediante el administrador comercial, también se requiere uno de los siguientes permisos:

  • ads_management
  • pages_read_engagement
  • business_management

Parámetros

  • comment_id (obligatorio)
  • media_id (obligatorio)
  • message

Ejemplo de solicitud de 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"

Ejemplo de respuesta

{
  "id": "17846319838254687"
}

Lectura

No se admite esta operación.

Actualización

No se admite esta operación.

Eliminar

No se admite esta operación.