Saltar al contenido

Construí mi propio sistema de comentario a DM para Instagram

En la práctica/ 13 min de lectura

Un webhook firmado, un filtro de palabra clave y una respuesta privada: así funciona un sistema de comentario a DM en Instagram, con código probado.

  • IA
  • Claude Code
  • Node.js
En este artículo (7)
  1. Por qué lo construí
  2. El flujo en tres pasos: webhook, filtro y DM
  3. Lo difícil: la app de Meta y los permisos de Instagram
  4. Cómo lo construí con Claude Code
  5. Errores comunes
  6. Preguntas frecuentes
  7. Checklist

Para responder comentarios de Instagram con un DM automático necesitas tres piezas: un webhook que recibe cada comentario nuevo, un filtro que busca tu palabra clave y una respuesta privada que manda el mensaje con el ID del comentario. Así funciona Comenta, el sistema que construí. Lo difícil no es el código: es la app de Meta y sus permisos.

Aquí explico el flujo, lo que dice la documentación de Meta sobre webhooks, firmas y respuestas privadas, cómo se configura la app y cómo lo construí con Claude Code. El código de este artículo no es el de Comenta: es un ejemplo mínimo que sigue la documentación pública de Meta y que probé con node --test.

Por qué lo construí

Cada Reel de esta serie termina igual: comenta una palabra y te mando la guía. Para que eso funcione sin estar pegado al celular, algo tiene que leer los comentarios, reconocer la palabra y contestar por mensaje directo. Estas son las palabras de los Reels de noviembre y la guía que corresponde a cada una:

las palabras de los Reels y la guía de cada unapalabratemaguíaPARCHEparches de seguridad de Next.jsecomlabs.dev/g/parche-guiaRAMmemoria de Next.js en Railwayecomlabs.dev/g/ram-guiaRCENext.js 14 sin parcheecomlabs.dev/g/rce-guiaTRAMPAtests que el agente borróecomlabs.dev/g/trampa-guiaNODENode en Docker: parchesecomlabs.dev/g/node-guiaDIALOGmodal accesible con <dialog>ecomlabs.dev/g/dialog-guiaREWINDcheckpoints de Claude Codeecomlabs.dev/g/rewind-guiaHMACHMAC de webhooks de Shopifyecomlabs.dev/g/hmac-guiaCOLAScola de trabajos en Postgresecomlabs.dev/g/colas-guiaJSONJSON válido de un LLMecomlabs.dev/g/json-guiaPWAPWA o app nativaecomlabs.dev/g/pwa-guiaCOMENTAcomentario a DM en Instagramecomlabs.dev/g/comenta-guiauna palabra por Reel, una guía por palabraenlaces públicos /g/<palabra>-guia: los mismos que van en el texto de cada Reel

Desliza la figura para verla completa

Comenta (comenta.ecomlabs.dev) es el sistema de comentario a DM que construí: cuando alguien comenta tu palabra clave en una publicación, le llega tu enlace por mensaje directo. Su página explica que GUÍA, guia y Guía cuentan igual, y que un panel muestra los comentarios con tu palabra, los DMs enviados y los clics al enlace.

Este artículo no cuenta cómo está hecho Comenta por dentro: cuenta la arquitectura general, que es la misma para cualquier sistema de este tipo, y lo que Meta exige en cada paso. Dos límites condicionan todo el diseño: la respuesta privada se manda dentro de los 7 días siguientes al comentario, y solo se puede mandar un mensaje a quien comentó.

El flujo en tres pasos: webhook, filtro y DM

La guía de respuestas privadas de Meta describe el recorrido: alguien comenta en una publicación de una cuenta profesional, Meta manda a tu servidor un webhook con el ID del comentario, quién comentó y el texto, y tu app usa ese ID para mandarle una respuesta privada. En medio va tu filtro.

de un comentario de Instagram a un DMcomentarioalguien escribeCOMENTAen tu ReelwebhookPOST de Metafield: commentsX-Hub-Signature-256filtropalabra completasin acentosni mayúsculasDMrespuesta privadaPOST /messagesrecipient.comment_idfirma inválida:se descartasin la palabra orepetido: nadadentro de 7 díasun solo mensajeresponde 200 rápido y deduplica: Meta reintenta 36 hla firma se calcula sobre el cuerpo crudo, con el App Secret como clave

Desliza la figura para verla completa

1. El webhook: comprobar que el aviso viene de Meta

Según la guía para configurar los webhooks de Instagram, tu URL de callback, siempre HTTPS con un certificado válido, recibe dos tipos de petición:

  • Verificación. Al configurar el producto Webhooks, Meta manda un GET con hub.mode=subscribe, hub.challenge y hub.verify_token. Si el token es el que escribiste en el App Dashboard, respondes con el valor de hub.challenge.
  • Notificaciones. Cada evento llega como un POST con el encabezado X-Hub-Signature-256: sha256= y la firma. Meta la describe como una firma SHA256 hecha con el payload y el App Secret, y su ejemplo en Node para Messenger la calcula con crypto.createHmac("sha256", appSecret): un HMAC-SHA256.

Las dos comprobaciones, en webhook.mjs, sin dependencias:

import { createHmac, timingSafeEqual } from "node:crypto";

// GET: Meta calls your callback URL with hub.* parameters when you set up webhooks.
export function verifyChallenge(params, verifyToken) {
  if (params.get("hub.mode") !== "subscribe" || params.get("hub.verify_token") !== verifyToken) return null;
  return params.get("hub.challenge");
}

// POST: X-Hub-Signature-256 is "sha256=" + the HMAC-SHA256 of the raw body, keyed with the app secret.
export function isSignedByMeta(rawBody, header, appSecret) {
  if (typeof header !== "string" || !header.startsWith("sha256=")) return false;
  const expected = createHmac("sha256", appSecret).update(rawBody).digest();
  const received = Buffer.from(header.slice("sha256=".length), "hex");
  return received.length === expected.length && timingSafeEqual(received, expected);
}
  1. verifyChallenge recibe los parámetros de la URL y tu verify token. Si el modo es subscribe y el token coincide, devuelve hub.challenge para que tu servidor lo responda; si no, null.
  2. isSignedByMeta rechaza un encabezado ausente o que no empiece con sha256=.
  3. expected es el HMAC-SHA256 del cuerpo crudo, los bytes tal como llegaron, con el App Secret como clave; received convierte a bytes la parte hexadecimal del encabezado.
  4. timingSafeEqual compara en tiempo constante, como recomienda la documentación de Node para digests HMAC. Lanza un error si las longitudes son distintas, por eso se comparan antes.

Llama a isSignedByMeta antes de parsear el JSON. La guía pide además responder con éxito pronto y tolerar entregas duplicadas: si una entrega falla, Meta reintenta durante 36 horas. Su lista de diagnóstico lo resume así: responde con éxito antes de empezar el trabajo lento.

2. El filtro: la palabra completa, una sola vez

Según los ejemplos de notificaciones de webhook, un comentario llega en entry[].changes[], con field igual a comments y un value con el ID, quién comentó y el texto. El filtro resuelve tres cosas: que COMENTA y coménta cuenten igual, que comentario no cuente y que un reintento no se atienda dos veces. Con la respuesta privada, está en keyword.mjs:

// Lowercase and drop accents (é → e), but keep ñ: "año" and "ano" are different words.
const normalize = (s) => s.toLowerCase().normalize("NFD").replace(/(?!\u0303)\p{M}/gu, "").normalize("NFC");

// New comments whose text contains the keyword as a whole word.
export function matchingComments(payload, keyword, seen) {
  const word = normalize(keyword);
  const found = [];
  for (const entry of payload?.entry ?? []) {
    for (const change of entry.changes ?? []) {
      if (change.field !== "comments") continue;
      const id = change.value?.id ?? change.value?.comment_id;
      const words = normalize(change.value?.text ?? "").split(/[^\p{L}\p{N}]+/u);
      if (!id || seen.has(id) || !words.includes(word)) continue;
      seen.add(id);
      found.push({ accountId: entry.id, commentId: id });
    }
  }
  return found;
}

// Private reply: POST /<IG_ID>/messages with the comment ID as the recipient.
export async function sendPrivateReply({ accountId, commentId }, text, accessToken) {
  const res = await fetch(`https://graph.instagram.com/v26.0/${accountId}/messages`, {
    method: "POST",
    headers: { "content-type": "application/json", authorization: `Bearer ${accessToken}` },
    body: JSON.stringify({ recipient: { comment_id: commentId }, message: { text } }),
  });
  if (!res.ok) throw new Error(`private reply failed with ${res.status}`);
  return res.json();
}
  1. normalize pasa a minúsculas y borra los acentos, excepto la tilde de la ñ (\u0303): año y ano siguen siendo palabras distintas.
  2. matchingComments recorre cada entry y cada cambio, y salta lo que no sea del campo comments.
  3. El ID sale de value.id, como en el ejemplo de Business Login for Instagram; otro ejemplo de la misma página lo llama comment_id, así que acepta los dos.
  4. El texto se parte en palabras con todo lo que no sea letra o número como separador: #comenta coincide; comentario y comenta2, no.
  5. seen guarda los IDs atendidos. Aquí es un Set en memoria; en producción, guarda el ID en tu base de datos con una restricción única, para que ni un reintento ni un reinicio manden dos DMs.
  6. sendPrivateReply hace el POST documentado a /<IG_ID>/messages con recipient.comment_id y message.text, y lanza un error si la respuesta no es 2xx. graph.instagram.com es el host de Instagram Login; Unified Login y Facebook Login usan graph.facebook.com. v26.0 es la versión de los ejemplos actuales de Meta.

3. El DM: una respuesta privada, con reglas

La respuesta privada está atada al comentario. Las limitaciones que lista Meta:

  • «Solo se puede enviar un mensaje a quien hizo el comentario», dice la versión en español de la guía.
  • Se manda dentro de los 7 días siguientes al comentario; en un Live, solo durante la transmisión.
  • Los mensajes de seguimiento solo van si la persona responde, dentro de las 24 horas siguientes.
  • Llega a la bandeja de entrada si la persona sigue la cuenta, o a Solicitudes si no, con un enlace a la publicación comentada.

Las 11 pruebas de comment-to-dm.test.mjs pasaron con node --test en Node 22, con notificaciones falsas con la forma del ejemplo documentado: el challenge, firmas válidas, alteradas y mal formadas, mayúsculas, acentos y ñ, el rechazo de comentario, el reintento y la petición exacta de la respuesta privada, con fetch simulado. No llamé a la API real de Meta.

Lo difícil: la app de Meta y los permisos de Instagram

El código cabe en una pantalla; la configuración de la app no, y cada paso depende de cuál de las tres configuraciones de la API elijas. La vista general de la plataforma de Instagram (29 de octubre de 2026) recomienda Instagram API with Unified Login para integraciones nuevas: las funciones nuevas de la API solo salen para esa configuración.

la app de Meta para Instagram, paso por paso1 · crear la appapp de Meta de tipo negocioconectada a un negocio verificado2 · producto InstagramUnified, Instagram o Facebook LoginMeta recomienda Unified Login3 · permisosinstagram_manage_commentsinstagram_manage_messages4 · webhookscallback HTTPS + verify tokencampo comments + /subscribed_apps5 · App Review + Liveacceso avanzado por permisoscreencast y verificación del negociosin Live ni acceso avanzado: solo cuentas con rol en la apppermisos de Unified Login; con Instagram Login son instagram_business_*

Desliza la figura para verla completa

Para responder comentarios con un DM, la guía de respuestas privadas pide esto en cada configuración:

TemaUnified LoginInstagram LoginFacebook Login
Token de accesoBusiness Integration System UserInstagram UserPágina de Facebook
Hostgraph.facebook.comgraph.instagram.comgraph.facebook.com
Inicio de sesiónFacebook Login for BusinessBusiness Login for InstagramFacebook Login for Business
Permisosinstagram_basic, instagram_manage_comments y instagram_manage_messagesinstagram_business_basic e instagram_business_manage_commentsinstagram_basic, instagram_manage_comments y pages_read_engagement
Página de FacebookNo hace faltaNo hace faltaObligatoria
Campos de webhookcomments, live_commentscomments, live_commentscomments, live_comments

Lo que no cambia entre configuraciones:

  • Cuenta profesional y pública. Hace falta una cuenta profesional de Instagram, de empresa o de creador, y pública: las cuentas privadas no reciben notificaciones de comentarios.
  • Suscripción por cuenta. Configurar el webhook en el dashboard no basta: cada cuenta conectada se suscribe con un POST a su /subscribed_apps, con los mismos campos para todas.
  • Acceso estándar y avanzado. El acceso estándar solo sirve para probar con personas que tienen un rol en la app. Para cualquier otra cuenta necesitas acceso avanzado a cada permiso, que exige App Review y la verificación del negocio, y la app en modo Live: según la guía de webhooks, sin eso no llegan las notificaciones de tus usuarios.
  • Una cuenta real para probar. La guía de primeros pasos de Unified Login pide una cuenta profesional real, invitada como Instagram Tester: no acepta usuarios de prueba.

Después viene App Review. Meta pide que la app se pueda probar desde fuera, instrucciones para sus revisores, un screencast por permiso, un ícono de 1024×1024, tu aviso de privacidad y, para algunos permisos, al menos una llamada exitosa a la API. Si pides permisos que no usas, no se aprueba.

Ojo: dos páginas de Meta no dicen lo mismo. La de App Review indica que una app solo para tu propio negocio funciona con acceso estándar y sin revisión; la guía de webhooks pone el acceso avanzado como requisito de las notificaciones comments. Si dependes del webhook de comentarios, cuenta con pasar por App Review.

Cómo lo construí con Claude Code

Comenta lo construí con Claude Code, y las reglas de trabajo viven en el CLAUDE.md del proyecto. Estas son las que importan para un sistema así:

  • Terminado significa verificado. Antes de decir «listo», la verificación de tipos, el linter y las pruebas tienen que pasar, con la salida real a la vista.
  • Prueba primero donde no se puede fallar. La firma del webhook y la coincidencia de palabras clave van con TDD: primero la prueba, después el código.
  • Nada de inventar la API de Meta. El agente no puede inventar campos, permisos, endpoints ni versiones: solo usa lo que está en unas notas verificadas contra la documentación. Si falta algo, toma el camino seguro y lo anota como pendiente.
  • Toda entrada externa se valida, empezando por los webhooks de Meta, y los logs no llevan tokens, secretos ni datos personales, como usuarios o el texto de los comentarios.
  • Trabajo por bloques de un plan. Cada bloque cierra con las pruebas en verde, una revisión del código, la actualización de un archivo de progreso y un commit pequeño. Al retomar, lo primero que se lee es ese archivo.

Es la versión larga de mi flujo de 4 pasos con Claude Code: decidir antes de construir y dejar todo listo para la siguiente sesión. Para un bloque grande, empieza con plan mode en Claude Code; si un cambio del agente se tuerce, regresar a un checkpoint con /rewind cuesta menos que corregir encima. La regla de las notas verificadas tiene una razón: instagram_business_manage_comments e instagram_manage_comments se parecen, pero Meta advierte que host, token, ID de cuenta y campos no son intercambiables entre configuraciones.

Errores comunes

  • Calcular la firma sobre el JSON ya parseado. La guía de webhooks de Messenger aclara que Meta firma el payload con Unicode escapado (äöå como \u00e4\u00f6\u00e5). Con JSON.stringify(JSON.parse(body)) cambian los bytes y la firma deja de coincidir, como comprueba una de las pruebas.
  • Comparar firmas con ===. Usa timingSafeEqual, que compara en tiempo constante.
  • Buscar la palabra como subcadena. "buen comentario".includes("comenta") da true. Compara palabras completas.
  • No deduplicar. Meta reintenta durante 36 horas, y su guía pide confirmar que una notificación duplicada no repita la acción.
  • Probar con una cuenta privada o sin suscribirla. Ninguna de las dos recibe notificaciones de comentarios.
  • Pedir permisos de más. App Review no aprueba una solicitud con permisos que tu app no usa.
  • Olvidar el acceso a los mensajes. Si la cuenta tiene apagada la opción «Allow access to messages» en su app de Instagram, la API de mensajes responde con el error (#200), según la página de elegibilidad de Unified Login.
  • Dejar tokens en los logs. Meta pide no incluir tokens, el App Secret ni credenciales en logs ni en solicitudes de soporte.

Preguntas frecuentes

¿Necesito una cuenta profesional de Instagram?

Sí. La plataforma de Instagram solo trabaja con cuentas profesionales, de empresa o de creador. Además, la cuenta dueña de la publicación tiene que ser pública para que lleguen las notificaciones de comentarios.

¿Cuánto tiempo tengo para mandar el DM?

Siete días desde que se creó el comentario. En un Live, solo mientras dura la transmisión: cuando termina, ya no se pueden mandar respuestas privadas a esos comentarios.

¿Puedo mandar más de un mensaje a quien comentó?

Con la respuesta privada, solo uno. Si la persona contesta, puedes mandarle mensajes de seguimiento dentro de las 24 horas siguientes a su respuesta. La API de mensajes de Instagram tiene además una ventana de 7 días para respuestas de agentes humanos, con su etiqueta.

¿A dónde le llega el mensaje?

A su bandeja de entrada si sigue tu cuenta, o a la carpeta de Solicitudes si no la sigue. El mensaje incluye un enlace a la publicación que comentó.

Checklist

  • La cuenta es profesional (empresa o creador) y pública.
  • Elegiste una configuración de la API (Meta recomienda Unified Login para integraciones nuevas) y pides solo sus permisos.
  • Tu callback responde al GET de verificación con hub.challenge si el verify token coincide.
  • Cada POST se valida con X-Hub-Signature-256 sobre el cuerpo crudo, con timingSafeEqual.
  • El filtro compara palabras completas, sin distinguir mayúsculas ni acentos.
  • Guardas el ID de cada comentario atendido para no mandar dos DMs.
  • La respuesta privada sale dentro de los 7 días, con recipient.comment_id, y cada cuenta está suscrita con /subscribed_apps.
  • Tienes acceso avanzado por App Review, el negocio verificado y la app en Live.
  • Ningún log lleva tokens, el App Secret ni datos personales.

La firma de Meta es la misma idea que la de Shopify: un HMAC-SHA256 del cuerpo crudo con un secreto que solo conocen tú y la plataforma. La explico paso a paso en cómo verificar el HMAC de los webhooks de Shopify. Y si vas a construir algo así con un agente, empieza con mi flujo de trabajo con Claude Code y ten a mano los checkpoints y /rewind de Claude Code.

¿Viste esto en Instagram? Comenta COMENTA en el Reel y te mando la guía.

Escrito por

Luis Morales

Luis Morales

Desarrollador frontend y Shopify, EcomLabs

@luismoralesdev en Instagram

Publicado el 3 de noviembre de 2026

← Blog