Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Menciones de Instagram a través de la API: encontrar y responder a las @menciones

La API de Instagram informa de las @menciones de una cuenta profesional en comentarios y descripciones de contenido público, y permite que la cuenta responda en el mismo lugar. Con Instagram Login, las menciones llegan al webhook de comentarios, y la respuesta se envía a POST /<IG_ID>/mentions con el ID del medio y, en el caso de un comentario, el ID del comentario, publicándose como comentario allí.

easyCoexistence reenvía a tu endpoint los comentarios, menciones y DM de la cuenta de Instagram conforme llegan, firmados con un secreto de esa cuenta, una vez que lo configures con set_social_webhook_destination.

comments

Notificación de webhook que incluye menciones para apps que usan Instagram Login.

POST /mentions

Endpoint que responde a un comentario o a una descripción en la que otro usuario de Instagram ha @mencionado la cuenta.

Private

El contenido de una cuenta privada no activa ningún webhook por un comentario o @mención en él.

2

Permisos que necesitan las menciones con Instagram Login: instagram_business_basic e instagram_business_manage_comments.

¿Cómo llegan las menciones?

Por webhook, en cuanto ocurren. Con Instagram Login, Meta incluye las menciones en la notificación de comentarios en lugar de enviar un campo de menciones aparte, así que un manejador las lee de los mismos eventos que los comentarios nuevos. Meta no guarda historial de notificaciones pasadas, así que guarda lo que necesites de cada una en cuanto llegue.

¿Qué menciones cubre la API?

La API de menciones de Meta identifica descripciones, comentarios y contenido en los que una cuenta de empresa o de creador ha sido @mencionada o etiquetada:

  • @menciones en comentarios.
  • @menciones en la descripción de una publicación.
  • Contenido en el que la cuenta está etiquetada, listado con GET /<IG_ID>/tags; no se admite comentar en fotos en las que la cuenta solo está etiquetada.
  • Las historias no: la API de menciones no las admite, y una mención en una historia llega a la cuenta como DM cuyo tipo de adjunto es story_mention.
  • Las cuentas privadas no: el contenido que son propietarias no envía webhooks de menciones.

¿Cómo se responde a una mención?

Con POST /<IG_ID>/mentions. Para una mención en un comentario, envía media_id y comment_id con el mensaje, y la respuesta aparece en el hilo de ese comentario; para una mención en una descripción, envía media_id y el mensaje, y se publica como comentario en el contenido. Ambos IDs vienen de la notificación del webhook.

Replying to a mention in a comment
POST https://graph.instagram.com/<IG_ID>/mentions
  ?media_id=<MEDIA_ID>
  &comment_id=<COMMENT_ID>
  &message=<REPLY_TEXT>

¿Qué necesitan las menciones?

Con Instagram Login, los permisos instagram_business_basic e instagram_business_manage_comments, el mismo par que usa la moderación de comentarios, con las llamadas dirigidas a graph.instagram.com. Para atender cuentas profesionales que el desarrollador no posee ni administra, la app también necesita acceso avanzado.

Errores comunes

  • Esperar un evento de menciones aparte con Instagram Login. Meta entrega las menciones dentro de la notificación de comentarios.
  • Responder a una mención en la publicación de otra cuenta como si fuera un comentario en la tuya. La ruta de Meta para eso es POST /<IG_ID>/mentions, con el ID del medio y, en el caso de un comentario, el ID del comentario.
  • Esperar menciones de historias desde la API de menciones. Meta no las admite ahí; llegan a la cuenta como DM.
  • Contar con que el webhook reenvíe menciones antiguas. Meta no guarda historial de notificaciones, así que guarda cada una en cuanto llegue.
Hacerlo con EasyCoexistence

Sus herramientas responden a los comentarios de tus propias publicaciones con reply_to_comment; responder a una mención en la publicación de otra persona, que usa el endpoint de menciones de Meta, no está entre ellas. Desde US$ 9 hasta US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Puedo comentar en una foto en la que mi cuenta está etiquetada?

No. GET /<IG_ID>/tags lista el contenido en el que la cuenta está etiquetada, pero Meta no admite comentar en fotos en las que la cuenta solo está etiquetada.

¿Puedo responder a una mención en la publicación de otra persona?

Sí. POST /<IG_ID>/mentions con el ID del medio, y el ID del comentario cuando la mención está en un comentario, publica la respuesta allí como la cuenta.

¿Las menciones en historias están disponibles en la API de menciones?

No. Una mención en una historia llega a la cuenta como DM cuyo tipo de adjunto es story_mention, y puede recibir respuesta en esa conversación.

¿Por qué nunca llegó una mención?

El contenido puede pertenecer a una cuenta privada, que no envía notificaciones de menciones, o la mención puede estar en una historia, que la API de menciones no cubre.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el