Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Webhook de comentarios de Instagram: el payload, campo por campo

El campo comments del webhook de Instagram notifica a una app cuando alguien comenta en los medios de una cuenta profesional, Reels incluidos, o responde a un comentario en ellos. Meta envía un cambio con field igual a comments, cuyo value incluye el id y el texto del comentario, el ID con alcance de Instagram y el username del autor en from, el id del medio y su tipo de producto, y parent_id cuando el comentario es una respuesta.

easyCoexistence suscribe cada cuenta de Instagram conectada a comments y reenvía a tu endpoint HTTPS los eventos comments que Meta entrega para ella en cuanto llegan, firmados con el secreto de esa cuenta y sin guardar copia.

parent_id

Presente cuando el comentario es una respuesta, con el ID del comentario al que responde.

self_ig_scoped_id

Se añade a from cuando la cuenta comenta en sus propios medios, junto al ID de la propia cuenta.

live_comments

Campo aparte para los comentarios durante una transmisión en vivo; sus notificaciones se detienen cuando termina la transmisión.

Advanced Access

Obligatorio para las notificaciones de comments y live_comments; los medios de cuentas privadas no generan ninguna.

7 days

Plazo que queda para enviar a quien comentó una única respuesta privada, dirigida mediante el ID del comentario.

¿Cuándo se activa el campo comments?

Cuando alguien comenta en un medio que pertenece a la cuenta profesional, o menciona a la cuenta, siempre que la app y la cuenta estén suscritas al campo. Cada comentario es un cambio dentro de la notificación, y todos estos casos tienen la misma estructura:

  • Un comentario nuevo en una publicación, un Reel, una Story o un anuncio, con media.media_product_type indicando en qué superficie está el medio.
  • Una respuesta a un comentario existente, que lleva parent_id con el ID del comentario al que responde.
  • Un comentario que hace la propia cuenta en sus medios, incluidas sus respuestas: from.id es el ID de la propia cuenta y from añade self_ig_scoped_id.
  • Una @mención de la cuenta: con Instagram Login, Meta incluye las menciones en la notificación de comments en lugar de en un campo propio.
  • Un comentario durante una transmisión en vivo llega por un campo aparte, live_comments, con la misma estructura de value, y deja de llegar cuando termina la transmisión.

¿Cómo es una notificación de comentarios?

Un POST cuyo JSON tiene object igual a instagram y un array entry. Cada entry corresponde a una cuenta profesional: su ID, la hora en que Meta envió la notificación y un array changes con un cambio por comentario. Así se ve una respuesta en un Reel:

A comments notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000,
      "changes": [
        {
          "field": "comments",
          "value": {
            "id": "<COMMENT_ID>",
            "parent_id": "<PARENT_COMMENT_ID>",
            "text": "<COMMENT_TEXT>",
            "from": {
              "id": "<INSTAGRAM_SCOPED_ID>",
              "username": "<USERNAME>"
            },
            "media": {
              "id": "<MEDIA_ID>",
              "media_product_type": "REELS"
            }
          }
        }
      ]
    }
  ]
}

¿Qué significa cada campo?

Los campos que la referencia del webhook de Meta indica para un comentario, de fuera hacia dentro:

  • entry[].id: el ID de la cuenta profesional, el user_id que devuelve /me para ella. Indica a qué cuenta pertenece el comentario.
  • entry[].time: cuándo envió Meta la notificación, como marca de tiempo Unix. No es cuándo se escribió el comentario.
  • changes[].field: comments, o live_comments para una transmisión en vivo. Compruébalo antes de leer value.
  • value.id: el ID del comentario, el que se usa para responderlo en público o en privado, ocultarlo o eliminarlo.
  • value.text: el texto del comentario, incluido cuando el comentario tiene texto.
  • value.from.id y value.from.username: el ID con alcance de Instagram y el username del autor. value.from.self_ig_scoped_id aparece cuando la propia cuenta escribió el comentario.
  • value.media.id y value.media.media_product_type: el medio comentado y su superficie; la referencia de medios de Meta indica AD, FEED, STORY y REELS.
  • value.parent_id: en una respuesta, el ID del comentario al que responde. Un comentario de primer nivel no lo tiene.
  • value.media.ad_id, ad_title y original_media_id: incluidos en la referencia para los comentarios hechos en un anuncio.

¿Qué no informa el campo comments?

Según la guía de configuración y las referencias de Meta, algunas cosas que un handler podría esperar quedan fuera del evento o nunca se envían:

  • Comentarios en medios de una cuenta privada: Meta no envía notificaciones de comentarios ni de menciones para ellos.
  • IDs de álbum: el evento no los incluye, y Meta indica consultar el álbum con el ID del comentario.
  • IDs de anuncio de los medios usados en anuncios dinámicos.
  • La hora de creación del comentario: GET /<COMMENT_ID>?fields=timestamp la devuelve en ISO 8601.
  • Comentarios en vivo después de que termine la transmisión, cuando se detienen las notificaciones de los medios en vivo.
  • Menciones en Stories, que la API de menciones de Meta no admite; llegan a la cuenta como DM.
  • Eventos pasados: Meta no conserva un historial de notificaciones que se pueda consultar, así que guarda lo que necesites a medida que llega cada una.

¿Qué necesita el campo comments?

Con Instagram Login, los permisos instagram_business_basic e instagram_business_manage_comments, y Advanced Access, que Meta exige para las notificaciones de comments y live_comments. La app tiene que estar en modo Live y suscrita a comments en el App Dashboard, y cada cuenta tiene que suscribirse mediante POST /<IG_ID>/subscribed_apps con comments entre sus subscribed_fields. Meta recomienda encarecidamente usar este webhook en lugar de consultar los comentarios periódicamente (polling), ya que así no se consume el límite de tasa.

¿Cómo se responde a un comentario desde el evento?

Con los IDs que incluye. POST /<COMMENT_ID>/replies con un message publica una respuesta visible bajo el comentario, usando value.id. POST /<IG_ID>/messages con recipient.comment_id igual a value.id envía al autor una única respuesta privada, dentro de los 7 días siguientes al comentario o, en una transmisión en vivo, mientras dure la transmisión. from.id es un ID con alcance de Instagram, pero un DM enviado directamente a él falla hasta que la persona haya escrito a la cuenta, así que la respuesta privada es la forma de llegar a ella por DM.

¿Cómo reenvía easyCoexistence un comentario?

En cuanto llega, una vez configurado un endpoint para la cuenta con set_social_webhook_destination desde Claude o ChatGPT, o con PUT /channels/:id/webhook en la Partner API. easyCoexistence suscribe cada cuenta conectada a los campos que transportan sus comentarios, menciones y DMs (comments, messages y mentions), comprueba la firma de Meta en cada entrega, responde a Meta de inmediato y envía mediante POST cada entry de esa cuenta a tu URL HTTPS, dentro de un sobre:

  • 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 devuelve list_social_accounts y el que reciben las herramientas MCP.
  • entry: el entry de Meta para la cuenta, sin cambios, así que una entrega por lotes se convierte en un POST por cada entry. El campo object de Meta y X-Hub-Signature-256 no se reenvían.
  • Entrega: un solo intento, con una espera de hasta 8 segundos y sin seguir redirecciones, a una dirección HTTPS que resuelva a una IP pública. No se guarda ninguna copia y no se reintenta nada.
A forwarded comment, headers included
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>

{
  "platform": "instagram",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<IG_ID>",
  "entry": {
    "id": "<IG_ID>",
    "time": 1793448000,
    "changes": [
      {
        "field": "comments",
        "value": {
          "id": "<COMMENT_ID>",
          "text": "<COMMENT_TEXT>",
          "from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
          "media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
        }
      }
    ]
  }
}

¿Qué hacen las reglas de comentario a DM con el mismo evento?

Lo leen en paralelo al reenvío. Una regla se activa cuando el comentario contiene una de sus palabras clave, sin distinguir mayúsculas de minúsculas, en una publicación elegida o en todas, y envía al autor el DM de la regla como respuesta privada, además de una respuesta pública si la regla la tiene. Los comentarios de la propia cuenta se ignoran; las automatizaciones que se inician con un comentario se encargan de los que ninguna regla respondió, y un comentario respondido por una regla llega igualmente a tu endpoint. La respuesta pública de la regla puede volver como un nuevo evento comments de la propia cuenta.

Errores comunes

  • Buscar comment_id. Con Instagram Login, el ID del comentario está en value.id; comment_id pertenece a los payloads de las otras modalidades de inicio de sesión de Meta.
  • Responder a los comentarios de la propia cuenta. Sus respuestas vuelven como eventos comments con from.id igual a entry.id, y una automatización que las responde acaba hablando consigo misma.
  • Tomar entry.time como la hora del comentario. Registra cuándo envió Meta la notificación; el campo timestamp del propio comentario indica cuándo se escribió.
  • Esperar los comentarios de transmisiones en vivo en el campo comments. Llegan por live_comments, que necesita su propia suscripción y deja de enviar notificaciones cuando termina la transmisión.
Hacerlo con EasyCoexistence

Las reglas de comentario a DM y las automatizaciones responden a esos mismos comentarios las 24 horas. De US$ 9 a US$ 0.75 por conexión al mes, un precio que baja a medida que sumas conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿El webhook de comentarios de Instagram incluye las respuestas a comentarios?

Sí. Cada respuesta llega como un evento comments propio, en el que parent_id contiene el ID del comentario al que responde.

¿Los comentarios en Reels activan el webhook de comentarios de Instagram?

Sí. Un comentario en un Reel llega por el campo comments igual que uno en una publicación, y media.media_product_type permite distinguirlos.

¿Por qué no se activa mi webhook de comentarios de Instagram?

Lo más habitual es que la app no esté en modo Live o no tenga Advanced Access, que la cuenta nunca se haya suscrito mediante /subscribed_apps, que el medio pertenezca a una cuenta privada o que el comentario se hiciera durante una transmisión en vivo, que usa live_comments.

¿El webhook de comentarios incluye el username de quien comenta?

Sí. value.from incluye el username de la persona junto a su ID con alcance de Instagram, así que no hace falta ninguna llamada adicional para saber quién comentó.

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