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)
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:
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.
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
GETconhub.mode=subscribe,hub.challengeyhub.verify_token. Si el token es el que escribiste en el App Dashboard, respondes con el valor dehub.challenge. - Notificaciones. Cada evento llega como un
POSTcon el encabezadoX-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 concrypto.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);
}
verifyChallengerecibe los parámetros de la URL y tu verify token. Si el modo essubscribey el token coincide, devuelvehub.challengepara que tu servidor lo responda; si no,null.isSignedByMetarechaza un encabezado ausente o que no empiece consha256=.expectedes el HMAC-SHA256 del cuerpo crudo, los bytes tal como llegaron, con el App Secret como clave;receivedconvierte a bytes la parte hexadecimal del encabezado.timingSafeEqualcompara 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();
}
normalizepasa a minúsculas y borra los acentos, excepto la tilde de la ñ (\u0303): año y ano siguen siendo palabras distintas.matchingCommentsrecorre cadaentryy cada cambio, y salta lo que no sea del campocomments.- El ID sale de
value.id, como en el ejemplo de Business Login for Instagram; otro ejemplo de la misma página lo llamacomment_id, así que acepta los dos. - El texto se parte en palabras con todo lo que no sea letra o número como separador:
#comentacoincide;comentarioycomenta2, no. seenguarda los IDs atendidos. Aquí es unSeten 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.sendPrivateReplyhace elPOSTdocumentado a/<IG_ID>/messagesconrecipient.comment_idymessage.text, y lanza un error si la respuesta no es2xx.graph.instagram.comes el host de Instagram Login; Unified Login y Facebook Login usangraph.facebook.com.v26.0es 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.
Desliza la figura para verla completa
Para responder comentarios con un DM, la guía de respuestas privadas pide esto en cada configuración:
| Tema | Unified Login | Instagram Login | Facebook Login |
|---|---|---|---|
| Token de acceso | Business Integration System User | Instagram User | Página de Facebook |
| Host | graph.facebook.com | graph.instagram.com | graph.facebook.com |
| Inicio de sesión | Facebook Login for Business | Business Login for Instagram | Facebook Login for Business |
| Permisos | instagram_basic, instagram_manage_comments y instagram_manage_messages | instagram_business_basic e instagram_business_manage_comments | instagram_basic, instagram_manage_comments y pages_read_engagement |
| Página de Facebook | No hace falta | No hace falta | Obligatoria |
| Campos de webhook | comments, live_comments | comments, live_comments | comments, 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
POSTa 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). ConJSON.stringify(JSON.parse(body))cambian los bytes y la firma deja de coincidir, como comprueba una de las pruebas. - Comparar firmas con
===. UsatimingSafeEqual, que compara en tiempo constante. - Buscar la palabra como subcadena.
"buen comentario".includes("comenta")datrue. 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
GETde verificación conhub.challengesi el verify token coincide. - Cada
POSTse valida conX-Hub-Signature-256sobre el cuerpo crudo, contimingSafeEqual. - 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

Publicado el 3 de noviembre de 2026