Menções

Identifique legendas, comentários e mídias em que o alias de uma conta comercial ou de criador de conteúdo do Instagram foi marcado ou @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.

Pontos de extremidade

A API consiste nos pontos de extremidade a seguir.

GET /{ig-user-id}/tags, para obter os objetos de mídia nos quais uma conta comercial ou de criador de conteúdo do Instagram foi marcada
GET /{ig-user-id}?fields=mentioned_comment, para obter dados sobre um comentário no qual uma conta comercial ou de criador de conteúdo do Instagram foi @mencionada
GET /{ig-user-id}?fields=mentioned_media, para obter dados sobre um objeto de mídia no qual uma conta comercial ou de criador de conteúdo do Instagram foi @mencionada na legenda
POST /{ig-user-id}/mentions, para responder a um comentário ou a uma legenda de objeto de mídia na qual uma conta comercial ou de criador de conteúdo foi @mencionada por outro usuário do Instagram

Consulte o documento de referência de cada ponto de extremidade para ver instruções de uso.

Webhooks

Assine o campo mentions para receber notificações dos Webhooks do Instagram toda vez que um usuário do IG mencionar uma conta comercial ou de criador de conteúdo do Instagram. Observe que não armazenamos dados de notificações dos Webhooks. Portanto, se você configurar um Webhook para acompanhar menções, será necessário armazenar quaisquer dados recebidos para uso posterior.

Exemplos

Como ouvir e responder a @menções em comentários

Você pode ouvir @menções em comentários e responder às que atendem aos seus critérios:

Configure um Webhook do Instagram que assina o campo mentions.
Configure um script capaz de analisar as notificações dos Webhooks e identificar os IDs dos comentários.
Use os IDs para consultar o ponto de extremidade GET /{ig-user-id}/mentioned_comment e obter mais informações sobre cada comentário.
Analise os resultados para identificar comentários que atendam aos seus critérios.
Use o ponto de extremidade POST /{ig-user-id}/mentions para responder aos comentários em questão.

A resposta aparecerá como um comentário na conversa secundária no comentário no qual a conta comercial ou de criador de conteúdo do Instagram foi mencionada.

Como ouvir e responder a @menções em legendas

É possível ouvir @menções em legendas e responder àquelas que atendam aos seus critérios:

Configure um Webhook do Instagram que assina o campo mentions.
Configure um script capaz de analisar notificações dos Webhooks e identificar os IDs das mídias.
Use os IDs para consultar o ponto de extremidade GET /{ig-user-id}/mentioned_media e obter mais informações sobre cada objeto de mídia.
Analise os resultados para identificar objetos de mídia com as legendas que atenderem aos seus critérios.
Use o ponto de extremidade POST /{ig-user-id}/mentions para comentar nos objetos de mídia.