Recursos · Integración n8n

Integración Cockpit n8nAutomatiza Cockpit con n8n.

Tu contenido de Cockpit puede alimentar al resto de tus herramientas sin que nadie entre al panel. La integración Cockpit n8n reúne 5 operaciones sobre 3 recursos: colecciones, formularios y singletons. Cockpit no tiene nodo trigger, así que el flujo arranca en otro sitio y llama a Cockpit cuando toca.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué resuelve la integración Cockpit n8n?

La integración Cockpit n8n cabe en un solo nodo que habla con la API de Cockpit desde dentro de un flujo de trabajo. Agrupa 5 operaciones en 3 recursos: colecciones (crear, leer y actualizar entradas), formularios (guardar un envío) y singletons (leer uno). Eliges el recurso, luego la operación, señalas la colección o el singleton por su nombre y n8n firma la llamada con el credential guardado una sola vez, es decir, la credencial que n8n almacena y reutiliza.

Empecemos por lo que entra. Una página de tu web envía sus respuestas a un Webhook de n8n, o sea una URL que n8n publica para que un servicio externo llame al flujo, y form.submit guarda esas respuestas en el formulario de Cockpit que lleva ese nombre. El campo Form se escribe a mano, no se elige de una lista, y ahí conviene copiar el nombre exacto. Después, un aviso al equipo por Slack cierra la ejecución.

Hay un uso más silencioso que casi nadie cuenta: singleton.get. Lee un contenido suelto, esos que Cockpit guarda fuera de cualquier colección, como el aviso de portada o una dirección de contacto. El flujo lo consulta al principio y decide con ese dato si sigue o se detiene, igual que leería un ajuste de configuración.

Para mover volumen está collection.getAll. Un Schedule Trigger arranca el flujo a intervalo fijo, la operación saca las entradas de una colección y cada entrada sale como un elemento aparte. Con Return All activado, n8n va encadenando las páginas de la API hasta agotar la colección; si lo dejas apagado, Limit marca el techo, que es lo razonable mientras pruebas. Y si solo te interesan las fichas de una categoría, Filter Query deja ese filtrado del lado de Cockpit.

Escribir en la colección se reparte entre dos operaciones. collection.create añade la ficha nueva, por ejemplo cuando un contacto de ActiveCampaign se convierte en caso de éxito publicable. collection.update reescribe una ficha existente y necesita el identificador de la entrada, no su título, porque Cockpit trabaja sobre el ID.

Antes de montar nada, ten presente que Cockpit no trae trigger: el arranque siempre viene de otro nodo. Y lo que se salga de estas 5 operaciones del catálogo va por el nodo HTTP Request, que llama a cualquier endpoint de la API de Cockpit reutilizando el mismo credential. Si quieres ver la plataforma con algo más de perspectiva, la Reseña n8n entra en detalle y el Curso n8n monta flujos de este tipo paso a paso.

Conexión

¿Cómo se conecta Cockpit con n8n?

  1. 01

    Genera el token de API en Cockpit

    Antes de nada necesitas una cuenta de Cockpit y una instancia de Cockpit alojada por ti. Desde ahí, crea un token de API siguiendo la documentación de Cockpit sobre gestión de tokens. Es el único método de autenticación que acepta el nodo, así que no hay pantalla de OAuth que aprobar ni aplicación extra que registrar. Guarda el token a mano, porque lo pegas en n8n en el paso siguiente.

  2. 02

    Guarda el credential de Cockpit en n8n

    Entra en el menú Credentials de n8n y crea un credential de Cockpit con dos valores. Cockpit URL es la dirección con la que entras a tu propia instancia de Cockpit. Access Token es el token de API que acabas de generar. Guárdalo una vez y cualquier nodo Cockpit, en cualquier flujo, lo encuentra ya listo en su desplegable.

  3. 03

    Elige un recurso y prueba el nodo solo

    Coloca un nodo Cockpit en el flujo y empieza por el recurso: Collection, Form o Singleton. La lista de operaciones se reduce a lo que ese recurso admite. En una colección, Collection Name or ID carga las colecciones de tu instancia y la eliges en vez de escribirla. Ejecuta el nodo por su cuenta y mira la salida antes de enganchar nada detrás.

Acciones

Qué sabe hacer el nodo Cockpit

El nodo Cockpit expone 5 operaciones en 3 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreate an EntryGetGet Many EntriesUpdate an EntrySubmit a Form
Collection✓✓✓
Form✓
Singleton✓

Collection

3 operaciones
01

Create a collection entry

collection.create

Lo que ves en n8n

Notas y casos de uso

Añade una entrada nueva a una colección de Cockpit y devuelve el registro guardado, de modo que el nodo siguiente sigue trabajando con él.

Parámetros clave

  • Collection Name or ID: la colección donde cae la entrada. La eliges en la lista que n8n carga desde tu instancia o pasas un ID mediante una expresión.
  • JSON Data Fields: decide cómo rellenas la entrada, con la interfaz de pares clave-valor o en JSON.
  • Entry Data: el contenido en sí, escrito campo a campo en la versión de interfaz o pegado entero en la versión JSON.
Casos de uso
un evento nuevo publicado en la web en cuanto queda confirmado en el calendario, con el título y la fecha tomados del elemento entrante.
02

Get many collection entries

collection.getAll

Lo que ves en n8n

Notas y casos de uso

Saca entradas de una colección y las devuelve como elementos separados, uno por entrada, listos para recorrer o enviar a otro sitio.

Parámetros clave

  • Return All: activado, n8n recorre las páginas de la API hasta la última entrada; apagado, Limit pone el tope.
  • Filter Query: una consulta en formato Mongolite, por ejemplo {"name": "Jim"}, para que el filtrado ocurra en Cockpit y no en un nodo posterior.
  • Fields: una lista separada por comas del tipo _id,name cuando de una entrada pesada solo quieres dos columnas.
  • Populate: resuelve los elementos enlazados desde otras colecciones en vez de dejar la referencia en crudo.
Casos de uso
la exportación semanal del catálogo, ordenada con Sort Query y paginada con Skip.
03

Update a collection entry

collection.update

Lo que ves en n8n

Notas y casos de uso

Cambia una entrada que ya existe. La entrada conserva su identidad y solo se reescriben los campos que envías.

Parámetros clave

  • Entry ID: el identificador del registro a modificar, normalmente tomado con una expresión desde una lectura anterior en lugar de escribirlo a mano. Un título no sirve, Cockpit se guía por el ID.
  • Collection Name or ID: la colección que contiene esa entrada.
  • Entry Data y JSON Data Fields: los valores nuevos y la forma de introducirlos, pares clave-valor o JSON.
Casos de uso
pasar un artículo de borrador a publicado en cuanto alguien del equipo editorial da el visto bueno.

Form

1 operación
04

Submit a form

form.submit

Lo que ves en n8n

Notas y casos de uso

Guarda un envío de formulario en Cockpit, como si el visitante lo hubiera rellenado en tu propia web. El envío queda archivado bajo el formulario que indiques.

Parámetros clave

  • Form: el nombre del formulario al que pertenecen los datos. Se escribe, no se elige de una lista, así que la grafía tiene que coincidir con la del formulario en Cockpit.
  • Form Data: las respuestas, mapeadas campo a campo o enviadas como un único objeto JSON.
  • JSON Data Fields: alterna entre esas dos maneras de rellenar los datos.
Casos de uso
una conversación con un asistente que termina en petición de presupuesto y aterriza en el formulario de Cockpit que el equipo revisa cada mañana.

Singleton

1 operación
05

Get a singleton

singleton.get

Lo que ves en n8n

Notas y casos de uso

Recupera un singleton, ese contenido independiente que Cockpit guarda fuera de las colecciones, y lo devuelve como un único elemento.

Parámetros clave

  • Singleton Name or ID: qué singleton leer, elegido en la lista que n8n trae de tu instancia o pasado por su ID mediante una expresión.
Casos de uso
leer el aviso general del sitio al principio del flujo y dejar que un nodo IF decida si la campaña sigue viva antes de continuar con el resto.
Necesitas ayuda

¿Necesitas ayuda para automatizar Cockpit con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Lo que se suele preguntar después

01¿La integración Cockpit n8n es gratis?
Sí, por el lado de n8n. El nodo Cockpit viene incluido con n8n, así que no hay nada que instalar ni ningún coste añadido por usarlo. Vale tanto en n8n Cloud, la oferta alojada por n8n, como en una instancia que alojes tú con Docker o npm, en Community Edition con licencia Sustainable Use. El flujo se comporta igual en los dos casos. Lo que te cueste Cockpit en sí es otra cuestión, ligada a cómo mantienes tu propia instancia, y esta página no entra en ello.
02¿Qué credenciales pide el nodo Cockpit?
Un solo credential, con token de acceso a la API. Guarda dos valores: la Cockpit URL, es decir la dirección con la que llegas a tu instancia de Cockpit, y un Access Token, que es el token de API creado en Cockpit siguiendo su documentación de gestión de tokens. Necesitas una cuenta de Cockpit y una instancia alojada por ti para poder generarlo. Una vez guardado en el menú Credentials de n8n, el credential se reutiliza: cada nodo Cockpit lo encuentra en su desplegable sin volver a pedirte el token.
03¿Qué límites tiene el nodo Cockpit?
El nodo cubre 5 operaciones repartidas en 3 recursos: colecciones, formularios y singletons. Con colecciones largas, vigila la paginación. Return All encadena las páginas de la API hasta terminar, Limit corta la lectura antes y el bloque Options de Get many collection entries suma 7 campos más, entre ellos Skip, Sort Query y RAW Data. Lo que quede fuera de esas operaciones del catálogo se hace con el nodo HTTP Request, que llama a cualquier endpoint de la API de Cockpit reutilizando el credential que ya tienes configurado.
04¿Hay un trigger de Cockpit en n8n?
No. Cockpit no tiene nodo trigger en n8n, así que un flujo suyo siempre arranca con otra cosa. Lo habitual es un Schedule Trigger, que lanza el flujo a intervalo fijo, o un Webhook de n8n, una URL que n8n publica para que un servicio externo llame al flujo en cuanto ocurre algo de su lado. El trigger de otra herramienta también sirve. Una vez el flujo está en marcha, el nodo Cockpit lee o escribe en el punto de la cadena donde lo hayas colocado.
05¿n8n o Make para Cockpit?
Depende de dónde quieras que vivan tus datos y de cómo prefieras pagar. Make es una plataforma de automatización alojada, sin opción de autoalojamiento, facturada por operación. n8n funciona en n8n Cloud o en tu propio servidor. Como Cockpit ya vive en tu máquina, tener la automatización al lado evita que el contenido salga de servidores que controlas, y ese suele ser el argumento que decide aquí. Make encaja con equipos que no quieren mantener ningún servidor. Los dos se construyen visualmente, así que la elección rara vez se juega en el editor.