API y agentes

Tus flujos, pidiéndolos en una frase.

Conecta Claude o ChatGPT a CoreDM y pídele el flujo. Lo crea por la API, en borrador, con la misma revisión de seguridad que el editor antes de activarlo. También puedes usarla desde tu propio código.

Empezar

  1. 01

    Crea una clave

    En CoreDM, Ajustes → API y agentes. Elige la cuenta de Instagram, ponle un nombre y marca los permisos: consultar, crear y editar borradores, publicar y pausar, o borrar. La clave se muestra una sola vez; guárdala como un secreto.

  2. 02

    Una clave = una cuenta

    Cada clave ve y modifica solo la cuenta de Instagram que elegiste. Si gestionas varias cuentas, crea una clave por cuenta.

  3. 03

    Llama a la API

    Base: https://coredm.app/api/external/v1. Autenticación: cabecera Authorization: Bearer cdm_… Las respuestas son JSON.

curl https://coredm.app/api/external/v1/account \
  -H "Authorization: Bearer $COREDM_API_KEY"

Conectar Claude o ChatGPT

Como conector, sin copiar claves (recomendado)

  • Claude (web o escritorio): Ajustes → Conectores → Añadir conector personalizado → URL https://coredm.app/api/mcp → Conectar. Inicias sesión en CoreDM, eliges tu cuenta de Instagram y pulsas Permitir.
  • ChatGPT: Ajustes → Apps y conectores → activa el modo desarrollador → Crear → URL https://coredm.app/api/mcp con autenticación OAuth. Inicias sesión en CoreDM y pulsas Permitir.
  • Puedes quitar el acceso cuando quieras en CoreDM → Ajustes → API y agentes: aparece como «… (conector)».

Otras formas de conectarlo

Claude Code: un comando; la primera vez te pide iniciar sesión.

claude mcp add --transport http coredm https://coredm.app/api/mcp
# luego, dentro de Claude Code: /mcp → coredm → iniciar sesión

Claude Desktop con clave de API (alternativa): añade esto a claude_desktop_config.json (Ajustes → Desarrollador → Editar configuración) y reinicia Claude.

{
  "mcpServers": {
    "coredm": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://coredm.app/api/mcp",
               "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer cdm_TU_CLAVE" }
    }
  }
}

Necesita Node.js instalado. Usa el puente mcp-remote para conectar con el servidor de CoreDM.

ChatGPT con un GPT personalizado (alternativa): crea una Acción con la especificación OpenAPI.

  • En ChatGPT: Explorar GPT → Crear → Configurar → Crear nueva acción.
  • Importar desde URL: https://coredm.app/docs/api/openapi.json
  • Autenticación: Clave de API → tipo Bearer → pega tu clave cdm_…
  • En Instrucciones, pídele que muestre los avisos de seguridad antes de aceptarlos y que devuelva siempre el url_panel.
Prueba: «Monta un flujo que, cuando comenten GUÍA en mis reels, responda en público, espere un minuto y mande por DM el PDF https://… y pida el email. Déjalo en borrador y pásame el enlace para revisarlo.»

Ejemplos con curl

Listar tus flujos
curl "https://coredm.app/api/external/v1/flows?limit=20" \
  -H "Authorization: Bearer $COREDM_API_KEY"
Crear un flujo en borrador
curl -X POST https://coredm.app/api/external/v1/flows \
  -H "Authorization: Bearer $COREDM_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: guia-reel-001" \
  -d '{
    "name": "GUÍA en mis reels",
    "nodes": [
      { "id": "t1", "type": "trigger", "position": { "x": 0, "y": 0 },
        "data": { "triggerType": "comment_keyword",
                  "keywords": [{ "value": "GUIA", "matchType": "contains" }],
                  "replyText": "¡Te la mando por DM!",
                  "replyTextVariants": ["Mira tus mensajes 👀"] } },
      { "id": "d1", "type": "delay", "position": { "x": 0, "y": 150 },
        "data": { "duration": 1, "unit": "minutes" } },
      { "id": "m1", "type": "sendMessage", "position": { "x": 0, "y": 300 },
        "data": { "messages": [{ "text": "Aquí tienes la guía: https://tu-web.com/guia.pdf",
                                 "textVariants": ["Tu guía, como te prometí: https://tu-web.com/guia.pdf"] }] } }
    ],
    "edges": [
      { "id": "e1", "source": "t1", "target": "d1" },
      { "id": "e2", "source": "d1", "target": "m1" }
    ]
  }'

Variantes de texto y una espera antes de responder: así no salta la revisión de riesgo. Consulta GET /node-schemas para ver todos los tipos de nodo y sus campos.

Validar sin guardar
curl -X POST https://coredm.app/api/external/v1/flows/validate \
  -H "Authorization: Bearer $COREDM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "nodes": [...], "edges": [...] }'
# → { "valid": true, "review": [ { "code": "single_wording", "kind": "risk", ... } ] }
Publicar (con la revisión de seguridad)
# 1. Lee el flujo: su "etag" va en If-Match
curl https://coredm.app/api/external/v1/flows/$FLOW_ID -H "Authorization: Bearer $COREDM_API_KEY"

# 2. Publica
curl -X POST https://coredm.app/api/external/v1/flows/$FLOW_ID/publish \
  -H "Authorization: Bearer $COREDM_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: publicar-guia-001" \
  -H 'If-Match: "flow:<id>:<revision>"' \
  -d '{}'
# → 409 review_required: details.warnings explica cada aviso

# 3. Si la persona acepta los avisos, repite con sus códigos
  -d '{ "acknowledge_warnings": ["single_wording"] }'
Pausar
curl -X POST https://coredm.app/api/external/v1/flows/$FLOW_ID/pause \
  -H "Authorization: Bearer $COREDM_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pausar-guia-001" \
  -H 'If-Match: "flow:<id>:<revision>"' \
  -d '{}'

Reglas de la API

  • Toda escritura lleva Idempotency-Key. Si reintentas con la misma, no se duplica nada.
  • Editar, publicar, pausar o borrar un flujo lleva If-Match con su etag. Si alguien lo cambió en el editor mientras tanto, recibes 412: vuelve a leerlo.
  • Publicar aplica la revisión del editor: un único texto para todos, responder sin espera o una palabra clave demasiado amplia pueden hacer que Instagram limite la cuenta. Con avisos, la API responde 409 review_required; enséñaselos a la persona y, si los acepta, repite con acknowledge_warnings.
  • Los flujos se crean en borrador. Nada se envía hasta que lo publicas.
  • Límite: 120 peticiones por minuto por cuenta.
  • Errores: { error: { code, message, request_id, details, retryable } }.

OpenAPI y llms.txt