Menciones

Identifica texto, comentarios y contenido multimedia de Instagram en que se haya etiquetado o @mencionado el alias de una cuenta empresarial o de creador 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.

Extremos

La API consta de los extremos siguientes:

• GET /{ig-user-id}/tags: para obtener los objetos multimedia en que se ha etiquetado una cuenta empresarial o de creador.
• GET /{ig-user-id}?fields=mentioned_comment: para obtener datos acerca de un comentario en que se haya @mencionado una cuenta empresarial o de creador.
• GET /{ig-user-id}?fields=mentioned_media: para obtener datos acerca de un objeto de contenido multimedia en que se haya @mencionado una cuenta empresarial o de creador en un texto.
• POST /{ig-user-id}/mentions: para responder a un comentario o texto de un objeto de contenido multimedia en que otro usuario de Instagram haya @mencionado una cuenta empresarial o de creador.

Consulta las instrucciones de uso en cada documento de referencia de los extremos.

Webhooks

Suscríbete al campo mentions para recibir notificaciones de los webhooks de Instagram cuando un usuario de la plataforma mencione una cuenta empresarial o de creador. Ten en cuenta que no almacenamos los datos de notificación de los webhooks, de modo que, si configuras un webhook que escucha las menciones, deberás almacenar los datos que recibas si tienes previsto usarlos más tarde.

Ejemplos

Escuchar @menciones de los comentarios y responder a ellas

Puedes escuchar las @menciones de los comentarios y responder a las que cumplan tus criterios:

1. Configura un webhook de Instagram suscrito al campo mentions.
2. Configura un script que pueda analizar las notificaciones de los webhooks y reconocer los identificadores de los comentarios.
3. Utiliza los identificadores para consultar el extremo GET /{ig-user-id}/mentioned_comment a fin de obtener más información acerca de cada comentario.
4. Analiza los resultados devueltos para identificar cualquier comentario que cumpla tus criterios.
5. Utiliza el extremo POST /{ig-user-id}/mentions para responder a esos comentarios.

La respuesta aparecerá como un comentario de una subconversación en el comentario en que se mencionó la cuenta empresarial o de creador.

Escuchar @menciones del texto y responder a ellas

Puedes escuchar las @menciones del texto y responder a las que cumplan tus criterios:

1. Configura un webhook de Instagram suscrito al campo mentions.
2. Configura un script que pueda analizar las notificaciones de los webhooks y reconocer los identificadores del contenido multimedia.
3. Utiliza los identificadores para consultar el extremo GET /{ig-user-id}/mentioned_media a fin de obtener más información acerca de cada objeto de contenido multimedia.
4. Analiza los resultados devueltos para identificar objetos de contenido multimedia con texto que cumpla tus criterios.
5. Utiliza el extremo POST /{ig-user-id}/mentions para comentar estos objetos de contenido multimedia.