Automatiza el comentario a DM de Instagram vía API
CommentKeyword convierte los comentarios de Instagram en conversaciones DM automatizadas. La API REST te permite crear disparadores de palabras clave, definir el texto de respuesta y conectar agentes de IA por programación, de modo que tus herramientas, flujos de trabajo y agentes de IA lo gestionen todo sin tocar el panel.
// 1. Find your live AI agent
const agentsResponse = await ck.get("/api/agents");
const agent = agentsResponse.data.find((item) => item.status === "live");
if (!agent) throw new Error("No live agent found");
// 2. Create the keyword trigger
const keywordResponse = await ck.post("/api/keywords", {
keyword: "GUIDE",
matchMode: "contains",
scope: "global",
commentReplies: ["Sent it to you, {{namefirst}}!"],
dmMessages: ["Hey {{namefirst}}, here's your free guide."],
delaySec: 20,
aiAgentId: agent.id
});
// 3. Go live.
console.log("Live:", keywordResponse.data.id);Todo lo que puedes controlar vía API
Un solo token PAT da a tu código control total sobre los disparadores de palabras clave, el texto de respuesta y las conexiones de agentes de IA.
Crea y gestiona palabras clave
Crea un nuevo disparador de palabra clave en una sola solicitud POST. Configura el modo de coincidencia (exacta o contiene), el alcance (global o específico por publicación) y las variantes de mensaje sin tocar el panel.
POST /api/keywords
{
"keyword": "GUIDE",
"matchMode": "contains",
"scope": "global"
}Define respuestas a comentarios y DMs
Incluye commentReplies y dmMessages en la misma llamada de creación o actualización. Usa marcadores como {{handle}}, {{name}} y {{namefirst}} para personalizar el texto al momento del envío.
{
"commentReplies": ["Sent it to you, {{namefirst}}!"],
"dmMessages": ["Hey {{namefirst}}, here's the guide."],
"delaySec": 20
}Conecta un agente de IA por su ID
Si tienes un agente de IA activo en el espacio de trabajo, vincúlalo a cualquier palabra clave pasando su ID público. El agente toma el control de las conversaciones DM automáticamente después de lanzarse la pregunta gancho.
PATCH /api/keywords/{id}
{
"aiAgentId": "a6be1900-8f4f-4ae6-8f4e-48f8b28f0f17"
}Deja que tu agente de IA se configure solo
Si estás creando un sistema de IA —un GPT personalizado, un agente de n8n, un flujo de trabajo de Claude o tu propio backend— puedes darle un token de la API de CommentKeyword y dejar que gestione toda la configuración de automatización de Instagram.
El agente puede leer tus agentes activos existentes, crear el disparador de palabra clave con el texto de respuesta adecuado, conectar el agente de IA correcto y activar todo, sin ninguna interacción manual con el panel.
- No hace falta iniciar sesión en el panel una vez configurado el token
- Los IDs de los agentes de IA se pueden consultar vía GET /api/agents
- Las palabras clave se pueden crear en una sola solicitud POST
- Las actualizaciones PATCH parciales permiten cambiar textos o agentes sin recrearlos
- Desactiva palabras clave al terminar una campaña mediante PATCH
Ejemplo: lanzamiento de campaña dirigido por un agente
1. Se activa el disparador de la campaña
Se publica una nueva publicación de producto. Tu flujo de trabajo de n8n o tu agente de IA recibe el evento.
2. El agente obtiene los agentes de IA disponibles
Llama a GET /api/agents para encontrar el agente activo adecuado para este tipo de campaña.
3. El agente crea la palabra clave
Envía la palabra clave, la respuesta al comentario, el texto del DM y el aiAgentId en una sola llamada. Establece delaySec en 20.
4. Activo en segundos
CommentKeyword empieza a monitorizar los comentarios en busca de esa palabra clave de inmediato. Sin humanos en el bucle.
Quién usa la API
Cualquier flujo de trabajo que necesite crear o actualizar automatizaciones de palabras clave de Instagram sin trabajo manual en el panel.
Agentes de IA que se configuran solos
Dale a tu sistema de IA un PAT y podrá crear la palabra clave, escribir la respuesta e integrarse él mismo como agente de la conversación, sin ningún trabajo manual en el panel.
Flujos de n8n, Make y Zapier
Activa la creación o actualización de palabras clave desde plataformas de automatización cuando arranca una campaña, se lanza un producto o se publica un lead magnet.
Paneles personalizados y herramientas para agencias
Construye tu propia interfaz de gestión sobre la API. Crea y actualiza palabras clave para varios clientes sin iniciar sesión en cada espacio de trabajo por separado.
Creación de campañas mediante scripts
Escribe un script que configure toda una campaña de Instagram: crea la palabra clave, define el texto del DM y actualízala o desactívala según un calendario, todo desde un único script.
Servidor MCP — próximamente
Un servidor de Model Context Protocol expondría las acciones de CommentKeyword como herramientas nativas para Claude, GPT y cualquier sistema de IA compatible con MCP. En lugar de escribir llamadas HTTP, tu agente llamaría directamente a herramientas como create_keyword o attach_agent.
Si estás creando un flujo de trabajo de IA que se beneficiaría de una integración MCP, escríbenos: nos ayuda a priorizar.
// Uso futuro de MCP
await agent.use("commentkeyword");
await create_keyword({
keyword: "LAUNCH",
aiAgentId: agentId,
});
Empieza en minutos
Regístrate, genera un token PAT desde la configuración de tu espacio de trabajo y empieza a enviar solicitudes.
1. Genera un token PAT
Desde la configuración de tu espacio de trabajo, crea un Personal Access Token y elige los permieres que necesita tu integración: keywords:read, keywords:write o agents:read.
2. Haz tu primera solicitud
curl -H "Authorization: Bearer TOKEN" \
https://commentkeyword.com/api/keywords3. Construye tu flujo de trabajo
Crea palabras clave, conecta agentes, define el texto de respuesta y gestiona campañas desde tu código, tu plataforma de automatización o tu sistema de IA. Consulta la referencia completa en /api-docs o usa la especificación OpenAPI legible por máquinas.
Preguntas frecuentes
¿Qué puedo hacer con la API de CommentKeyword?
Puedes listar, crear, leer, actualizar y eliminar disparadores de palabras clave. Cada palabra clave puede incluir respuestas a comentarios, mensajes DM, ajustes de coincidencia y la conexión opcional de un agente de IA. La API también expone un endpoint de lectura de tus agentes de IA para que puedas consultar los IDs de los agentes por programación.
¿Cómo funciona la autenticación?
Usa un Personal Access Token (PAT) generado desde la configuración de tu espacio de trabajo. Pásalo en la cabecera Authorization como token Bearer. Los tokens tienen el alcance del espacio de trabajo y no caducan automáticamente.
¿Puedo conectar un agente de IA a una palabra clave vía API?
Sí. Incluye el campo aiAgentId en una solicitud POST o PATCH. El valor debe ser el ID público de un agente activo en el mismo espacio de trabajo. Puedes obtener todos los IDs de agentes desde el endpoint GET /api/agents.
¿Hay un servidor MCP disponible?
Todavía no, pero está en la hoja de ruta. Un servidor MCP permitiría a los agentes de IA interactuar con CommentKeyword directamente a través del Model Context Protocol, sin escribir llamadas HTTP sin procesar. Si estás creando un sistema de IA y esto es importante para tu flujo de trabajo, escríbenos: nos ayuda a priorizar.
¿Necesito un plan de pago para usar la API?
La API está disponible en todos los planes, incluido el gratuito. Las cuentas gratuitas incluyen 300 DMs automatizados al mes. Los planes de pago desbloquean mayores volúmenes, agentes de IA y funciones adicionales que también se pueden gestionar vía API.
¿Hay un límite de solicitudes?
La API de CommentKeyword tiene un límite de solicitudes por token de espacio de trabajo. La entrega en Instagram se pone en cola por separado para cada cuenta profesional conectada y respeta los límites específicos de cada endpoint de Meta. Si Meta limita una solicitud, los mensajes y respuestas aptos se retrasan y se reintenta su envío automáticamente.
Construye una vez. Deja que la API haga el resto.
CommentKeyword da a tu código —y a tus agentes de IA— control total sobre los disparadores de palabras clave, el texto de respuesta y el enrutamiento de las conversaciones de IA. Empieza gratis y añade el token de la API desde la configuración de tu espacio de trabajo.