Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Campos del webhook de Instagram: lista completa

Para una cuenta profesional con Instagram Login, la tabla de campos de webhook de Meta incluye comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover y standby, con las menciones entregadas dentro de comments; sus ejemplos añaden message_edit. Cada uno necesita instagram_business_basic más instagram_business_manage_comments o, para la mayoría de campos de mensajería, instagram_business_manage_messages. story_insights no se ofrece con Instagram Login.

easyCoexistence suscribe cada cuenta de Instagram conectada a comments, messages y mentions, y reenvía esos eventos a tu endpoint HTTPS a medida que llegan, firmados con el secreto de esa cuenta.

8

Campos con los que empieza suscrito un nuevo producto de Instagram en el App Dashboard, entre ellos comments, messages y message_reactions.

Per app

Los campos se seleccionan para la app, no por cuenta: una cuenta recibe los campos que la app seleccionó.

Advanced Access

Nivel de acceso que la guía de configuración de Meta indica para los webhooks de Instagram Login, y que exige para las notificaciones de comments y live_comments.

story_insights

Marcado como no disponible para Instagram Login en la tabla de campos de Meta, que lo ofrece con Facebook Login y Unified Login.

10 Sep 2025

Cuando Meta introdujo el webhook message_edit para Business Login for Instagram y Facebook Login for Business.

¿Qué campos de webhook ofrece Instagram Login?

Estos, según la tabla de campos de Meta, con lo que dispara cada uno tomado de sus ejemplos y de la referencia de webhooks. Cada campo también necesita instagram_business_basic además del permiso indicado, y Meta exige Advanced Access para las notificaciones de comments y live_comments.

commentsA comment or reply on the account's posts, Reels, Stories or ads, @mentions included. instagram_business_manage_comments.
live_commentsA comment on the account's Live while it is broadcast. instagram_business_manage_comments.
mentionsNo field of its own with Instagram Login: Meta includes mentions in the comments notification.
messagesA DM: text, attachments, shares, Story replies and mentions, quick replies, deletions, and echoes of the account's own messages. instagram_business_manage_messages.
message_echoesListed with instagram_business_manage_comments; the account's own messages arrive on messages with is_echo set to true.
message_reactionsA person reacts to a message or removes the reaction. instagram_business_manage_messages.
message_editA person edits a message, with mid, text and num_edit. In Meta's examples and changelog, not in its fields table.
messaging_postbacksA tap on an ice breaker, a template's postback button or a persistent menu item. instagram_business_manage_messages.
messaging_referralAn ig.me link with a ref parameter, opened in an existing conversation. instagram_business_manage_messages.
messaging_seenA person reads a message, reported as read.mid. instagram_business_manage_messages.
messaging_optinsListed with instagram_business_manage_messages; Meta's Instagram examples show no payload for it.
messaging_handoverThread control passed, taken or requested between apps under the handover protocol. instagram_business_manage_messages.
standbyA message that arrives while another app controls the conversation. instagram_business_manage_messages.

¿Qué campos no están disponibles con Instagram Login?

Tres filas de la tabla de campos de Meta no tienen permiso de Instagram Login, por lo que una app con Instagram Login no los recibe, y existe un campo más que solo aparece fuera de él:

  • story_insights: las métricas de una historia cuando expira, con Facebook Login o Unified Login e instagram_manage_insights. La referencia de insights de medios de Meta indica que el webhook de insights no es compatible con Instagram Login.
  • messaging_policy_enforcement y response_feedback: solo en la columna de la API de mensajería de Instagram de Meta.
  • mentions como campo propio: Facebook Login y Unified Login lo incluyen, con instagram_manage_comments, mientras que Instagram Login integra las menciones dentro de comments.

¿Cómo te suscribes a los campos?

En dos lugares. En el App Dashboard, en la configuración de webhook del producto Instagram, guarda la URL de callback y el verify token, lo que dispara la petición de verificación de Meta, y luego selecciona los campos; un nuevo producto de Instagram empieza suscrito a ocho de ellos. Después suscribe cada cuenta con POST /<IG_ID>/subscribed_apps en graph.instagram.com, con subscribed_fields con los campos seleccionados en el dashboard, separados por comas.

Subscribing one account to three fields
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
  ?subscribed_fields=comments,messages,message_reactions
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{ "success": true }

¿Puede cada cuenta recibir campos distintos?

No. La guía de configuración de Meta dice que los campos no se pueden seleccionar por cuenta de un usuario de la app: una cuenta recibe los campos seleccionados para la app. subscribed_fields en la suscripción de la cuenta está pensado para listar los campos del dashboard, así que un manejador debe esperar cualquier campo que la app haya seleccionado y decidir según lo que contenga cada evento, no según lo que pidió para una cuenta.

¿Cómo distingues los campos en una notificación?

Por la forma de la entrada. Los campos de comentarios llegan en un array changes, y cada cambio indica su campo. Los campos de mensajería llegan en un array messaging sin nombre de campo, y la clave junto a sender, recipient y timestamp los distingue:

  • changes[].field: comments o live_comments, con el comentario en value.
  • message: messages, incluidos los ecos de los mensajes de la propia cuenta, que llevan is_echo en true.
  • reaction: message_reactions. postback: messaging_postbacks. read: messaging_seen. message_edit: message_edit.
  • referral junto a sender: messaging_referral. Un referral dentro de message pertenece a messages, de un hilo nuevo o de un anuncio Click-to-Direct.
  • pass_thread_control, take_thread_control o request_thread_control: messaging_handover, tal como las lista la referencia de webhooks de Meta.

¿Qué campos suscribe easyCoexistence?

comments, messages y mentions, la lista con la que se suscribe cada cuenta de Instagram al conectarse. Con Instagram Login las menciones llegan dentro de comments, así que la suscripción cubre comments y los mensajes directos, con los ecos, las respuestas a historias, las menciones en historias y los adjuntos entre los mensajes directos. Los demás campos de la tabla los entrega Meta a una app suscrita a ellos y no forman parte de la suscripción de una conexión. Una vez definido el endpoint con set_social_webhook_destination o con la Partner API, easyCoexistence verifica la firma de Meta, responde a Meta de inmediato y envía con POST cada entrada de la cuenta a él:

  • platform y external_id: instagram, y el ID de Instagram de la cuenta, igual a entry.id.
  • account_id: el ID de la conexión en easyCoexistence, el que usan las herramientas MCP.
  • entry: la entrada de Meta para la cuenta, sin cambios. El campo object de Meta y su cabecera X-Hub-Signature-256 no se reenvían.
  • X-EC-Signature: t=<unix>,v1=<hex>, un HMAC-SHA256 del timestamp, un punto y el cuerpo sin procesar, con la clave secreta propia de la cuenta.
  • Entrega: un intento de hasta 8 segundos, sin seguir redirecciones, sin guardar copia y sin reintentos.

Errores comunes

  • Esperar un campo mentions con Instagram Login. Meta integra las menciones en la notificación de comentarios, así que un manejador asociado al campo mentions nunca se ejecuta.
  • Suponer que una cuenta solo recibe los campos que nombró su propia suscripción. Meta entrega los campos seleccionados para la app, así que ramifica según lo que contenga cada evento.
  • Tratar message.referral y un referral de primer nivel como un solo evento. El primero va dentro de messages; el segundo es messaging_referral, para un enlace ig.me abierto en una conversación existente.
  • Esperar story_insights con Instagram Login. Meta lo marca como no disponible ahí, así que lee las métricas de una historia desde el endpoint de insights mientras esté activa.
Hacerlo con EasyCoexistence

Los eventos no se guardan por defecto; una cuenta con una automatización activada conserva sus DM y comentarios durante 7 días. Define el endpoint con set_social_webhook_destination desde Claude o ChatGPT, o con la Partner API. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que sumas conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Instagram Login tiene un campo de webhook para menciones?

No como campo separado. Meta incluye las menciones en la notificación de comments para Instagram Login; mentions es un campo propio con Facebook Login y Unified Login.

¿Está story_insights disponible con Instagram Login?

No. La tabla de campos de Meta lo marca como no disponible para Instagram Login, y su referencia de insights de medios dice que el webhook de insights no es compatible ahí.

¿Qué permisos necesita el webhook de mensajes de Instagram?

instagram_business_basic e instagram_business_manage_messages, con Advanced Access, que la guía de configuración de Meta indica para los webhooks de Instagram Login.

¿Cuándo añadió Meta el webhook message_edit para Instagram?

El 10 de septiembre de 2025, para Business Login for Instagram y Facebook Login for Business. Una edición llega en el array messaging bajo una clave message_edit.

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