Menciones

Permiten identificar texto, comentarios y contenido multimedia en los que se etiqueta o se @menciona el alias de una cuenta de empresa o creador de Instagram.

Limitaciones

• Las menciones en historias no son compatibles.
• Los comentarios de las fotos en las que te etiquetaron no son compatibles.
• Los webhooks no se enviarán si el objeto multimedia en el que aparece el comentario o la @mención se creó con una cuenta que está configurada como privada.

Puntos de conexión

La API tiene los siguientes puntos de conexión:

• GET /{ig-user-id}/tags: para obtener los objetos multimedia en los que se etiquetó una cuenta de empresa o creador
• GET /{ig-user-id}?fields=mentioned_comment: para obtener datos sobre un comentario en el que se @mencionó una cuenta de empresa o creador
• GET /{ig-user-id}?fields=mentioned_media: para obtener datos sobre un objeto multimedia en el que se @mencionó en un texto una cuenta de empresa o creador
• POST /{ig-user-id}/mentions: para responder a un comentario o texto de objeto multimedia en el que otro usuario de Instagram haya @mencionado una cuenta de empresa o creador

Consulta los documentos de cada punto de conexión para hallar instrucciones de uso.

Webhooks

Suscríbete al campo mentions para recibir notificaciones de Webhooks de Instagram cuando un usuario de Instagram mencione una cuenta de empresa o creador de Instagram. Ten en cuenta que no almacenamos datos de notificaciones de Webhooks. Por ello, si configuras un Webhook que escuche menciones, debes almacenar los datos recibidos si planeas usarlos posteriormente.

Ejemplos

Escuchar menciones con arroba de comentarios y responder a ellas

Puedes escuchar menciones con arroba de comentarios y responder a las que cumplan con tus criterios:

1. Configura un webhook de Instagram que se suscriba al campo mentions.
2. Configura un script que pueda analizar las notificaciones de Webhooks y reconocer identificadores de comentarios.
3. Usa los identificadores para hacer consultas al punto de conexión GET /{ig-user-id}/mentioned_comment y obtener más información sobre cada comentario.
4. Analiza los resultados devueltos para identificar los comentarios que cumplan con tus criterios.
5. Usa el punto de conexión POST /{ig-user-id}/mentions para responder a los comentarios.

La respuesta aparecerá como un comentario de subproceso del comentario en el que se mencionó la cuenta de empresa o creador.

Escuchar menciones en textos y responder a ellas

Puedes escuchar menciones con arroba en textos y responder a las que cumplan con tus criterios:

1. Configura un Webhook de Instagram que se suscriba al campo mentions.
2. Configura un script que pueda analizar las notificaciones de Webhooks y reconocer identificadores de medios.
3. Usa los identificadores para hacer consultas al punto de conexión GET /{ig-user-id}/mentioned_media y obtener más información sobre cada objeto multimedia.
4. Analiza los resultados devueltos para identificar objetos multimedia con textos que se adapten a tus criterios.
5. Usa el punto de conexión POST /{ig-user-id}/mentions para hacer comentarios sobre los objetos multimedia.