Saltar al contenido

Conectar n8n con una clave de API personal

El nodo de comunidad n8n-nodes-marcomm redacta notas de prensa, entradas de blog, eventos de prensa e invitaciones RSVP, los envía a aprobación y los publica. El paquete aún no está publicado.

  1. 1
    En Marcomm, ve a Configuración → Integraciones → n8n para ver el estado y los valores que necesitas.
    Configuración, Integraciones, n8n, con el estado, los pasos de conexión, los permisos que marcar y el estado del acceso a la API
    La página de n8n muestra el estado actual, los pasos, los valores que copiar y si el acceso a la API está aprobado para este espacio de trabajo.
  2. 2
    Abre Configuración → API. Si el espacio de trabajo aún no tiene acceso a la API, un propietario o administrador rellena Solicitar acceso a la API y selecciona Enviar solicitud.
  3. 3
    Tras la aprobación, abre Crear una clave, elige Clave personal, marca los Ámbitos que necesitas y selecciona Crear clave. Copia la clave en ese momento, porque solo se muestra una vez.
  4. 4
    En n8n Cloud, busca Marcomm AI en el panel de nodos (si no aparece, activa Verified Community Nodes en el panel de administración y reinicia la instancia). En un n8n autoalojado, abre Settings (Configuración), luego Community Nodes y luego Install (Instalar), y escribe n8n-nodes-marcomm.
  5. 5
    Crea una credencial Marcomm AI API, pega la clave en API Key (clave de API) y añade el nodo Marcomm AI o Marcomm AI Trigger a un workflow.

El nodo disparador necesita el ámbito Contenido y no envía nada en su primera comprobación, para no repetir elementos antiguos.

El nodo cubre notas de prensa, entradas de blog, eventos de prensa, invitaciones RSVP y aprobaciones, incluidos aprobar, rechazar y la lista de aprobaciones pendientes. El nodo disparador inicia un workflow cuando se crea, se envía a aprobación o se publica una nota de prensa, cuando se crea o se publica una entrada de blog, o cuando se crea un evento de prensa.

Los ámbitos deciden lo que puede hacer una clave. Contenido (content) lee notas de prensa, entradas de blog y eventos de prensa, Escribir contenido (content:write) crea y edita borradores, Publicar y enviar (distribution) publica y envía por correo, y Aprobaciones (approvals) cubre los pasos de aprobación. Los tres últimos solo funcionan con una Clave personal, porque la acción queda registrada a nombre de quien creó la clave. Una Clave del espacio de trabajo solo puede leer, y cada clave actúa con el rol y los permisos de quien la creó.

Publicar y enviar no se puede deshacer. La API solo lo ejecuta cuando la solicitud lleva confirm: true o un encabezado Idempotency-Key, y no publica nada y responde 409 mientras falte una aprobación o el contenido esté programado o bajo embargo. Un reintento con el mismo Idempotency-Key y la misma solicitud devuelve el primer resultado durante 24 horas en lugar de ejecutarse otra vez. El nodo envía una clave de idempotencia en cada escritura, creada a partir de la ejecución, el nodo y el elemento, y confirma por sí mismo las operaciones de publicar y enviar.

La API está disponible en el plan Team y superiores. El equipo de Marcomm AI revisa cada solicitud, y las claves solo funcionan tras la aprobación. Una clave solo puede usar los ámbitos aprobados para el espacio de trabajo, y cada persona puede tener hasta 10 claves. Por defecto, un espacio de trabajo puede hacer 60 solicitudes por minuto y 10.000 al día; por encima, la API responde 429 con un encabezado Retry-After. Para subir los límites, usa ¿Necesitas límites más altos? en Configuración → API. Para desconectar n8n, selecciona Revocar junto a la clave; los sistemas que la usan pierden el acceso al momento.

Preguntas frecuentes

Llama a GET https://marcomm.works/api/v1/me con el encabezado Authorization: Bearer seguido de tu clave. Funciona con cualquier clave aprobada, tenga los ámbitos que tenga, y devuelve el espacio de trabajo, el nombre de la clave y sus ámbitos.

Una clave no registra qué servicio la usa, así que Marcomm no marca la tarjeta de n8n como conectada. En Configuración → API ves cuándo se usó cada clave por última vez.

Sí, con el nodo integrado HTTP Request. Llama a https://marcomm.works/api/v1 con el encabezado Authorization: Bearer seguido de tu clave y añade un encabezado Idempotency-Key a cada escritura.

Integraciones