API Graph de Instagram

Menciones a usuarios de Instagram

Este perímetro te permite crear un comentario de Instagram en un comentario de Instagram u objeto de contenido multimedia de Instagram con texto en que un usuario de Instagram haya sido @mencionado por otro.

Creación

Responder a un objeto de contenido multimedia de Instagram con texto

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

Crea un comentario de Instagram en un objeto de contenido multimedia de Instagram en que se haya @mencionado a un usuario de Instagram en un texto.

Limitaciones

  • No se admiten las menciones en Stories.
  • No se admiten los comentarios en las fotos en las que te hayan etiquetado.
  • No se enviarán webhooks si el contenido multimedia en el que aparece el comentario o la @mención se creó desde una cuenta definida como privada.

Parámetros de la cadena de consulta

Los parámetros de la cadena de consulta son opcionales a menos que se indiquen según sea necesario.

  • {media_id} (obligatorio): el identificador de contenido multimedia incluido en la carga de notificación del webhook.
  • {message} (obligatorio): texto que se incluirá en el comentario.

Permisos

Identificador de acceso de un usuario de Facebook con los siguientes permisos:

  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

Si el identificador es de un usuario cuyo rol de página se ha concedido mediante Business Manager, también se necesita uno de los permisos siguientes:

  • ads_management
  • pages_read_engagement
  • business_management

Solicitud cURL de ejemplo

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"
}

Respuesta a un comentario

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

Crea un comentario de Instagram en un comentario de Instagram en que se ha @mencionado a un usuario de Instagram.

Limitaciones

  • No se admiten las menciones en Stories.
  • No se admiten los comentarios en las fotos en las que te hayan etiquetado.
  • No se enviarán webhooks si el contenido multimedia en el que aparece el comentario o la @mención se creó desde una cuenta definida como privada.

Parámetros de la cadena de consulta

Los parámetros de la cadena de consulta son opcionales a menos que se indiquen según sea necesario.

  • {comment_id} (obligatorio): el identificador de comentario incluido en la carga de notificación del webhook.
  • {media_id} (obligatorio): el identificador de contenido multimedia incluido en la carga de notificación del webhook.
  • {message} (obligatorio): texto que se incluirá en el comentario.

Permisos

Identificador de acceso de un usuario de Facebook con los siguientes permisos:

  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

Si el identificador es de un usuario cuyo rol de página se ha concedido mediante Business Manager, también se necesita uno de los permisos siguientes:

  • ads_management
  • pages_read_engagement
  • business_management

Parámetros

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

Solicitud cURL de ejemplo

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

Esta operación no es compatible.

Actualización

Esta operación no es compatible.

Eliminar

Esta operación no es compatible.