Graph API do Instagram

Menções a usuários do IG

Esta borda permite que você crie um comentário do IG em um objeto de comentário do IG ou de mídia do IG com legenda em que um usuário do IG tenha sido @mencionado por outro usuário.

Como criar

Como responder a um objeto de mídia do IG com legenda

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

Cria um comentário do IG em um objeto de mídia do IG em que um usuário do IG foi @mencionado na legenda.

Limitações

  • As menções não são compatíveis com stories.
  • Não há suporte para comentários em fotos em que você foi marcado.
  • Os Webhooks não serão enviados se a mídia em que o comentário ou a @menção aparece tiver sido criada por uma conta definida como privada.

Parâmetros da cadeia de caracteres de consulta

Os parâmetros da cadeia de caracteres de consulta serão opcionais, a menos que sejam indicados como obrigatórios.

  • {media_id} (obrigatório): o ID da mídia incluída no conteúdo da notificação do Webhook
  • {message} (obrigatório): o texto a ser incluído no comentário.

Permissões

Um token de acesso do usuário do Facebook com as seguintes permissões:

  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

Se o token for de um usuário cuja função na Página foi concedida por meio do Gerenciador de Negócios, uma das seguintes permissões também será necessária:

  • ads_management
  • pages_read_engagement
  • business_management

Exemplo de solicitação 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"

Exemplo de resposta

{
  "id": "17846319838228163"
}

Como responder a um comentário

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

Cria um comentário do IG em um comentário do IG no qual um usuário do IG foi @mencionado.

Limitações

  • As menções não são compatíveis com stories.
  • Não há suporte para comentários em fotos em que você foi marcado.
  • Os Webhooks não serão enviados se a mídia em que o comentário ou a @menção aparece tiver sido criada por uma conta definida como privada.

Parâmetros da cadeia de caracteres de consulta

Os parâmetros da cadeia de caracteres de consulta serão opcionais, a menos que sejam indicados como obrigatórios.

  • {comment_id} (obrigatório): o ID do comentário incluído no conteúdo da notificação do Webhook
  • {media_id} (obrigatório): o ID da mídia incluída no conteúdo da notificação do Webhook
  • {message} (obrigatório): o texto a ser incluído no comentário.

Permissões

Um token de acesso do usuário do Facebook com as seguintes permissões:

  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

Se o token for de um usuário cuja função na Página foi concedida por meio do Gerenciador de Negócios, uma das seguintes permissões também será necessária:

  • ads_management
  • pages_read_engagement
  • business_management

Parâmetros

  • comment_id (obrigatório)
  • media_id (obrigatório)
  • message

Exemplo de solicitação 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"

Exemplo de resposta

{
  "id": "17846319838254687"
}

Leitura

Esta operação não é compatível.

Atualização

Esta operação não é compatível.

Exclusão

Esta operação não é compatível.