Ressources · Intégration n8n

Intégration Cockpit n8nAutomatiser Cockpit avec n8n.

Tes contenus Cockpit peuvent alimenter le reste de tes outils sans que personne ouvre l'admin. L'intégration Cockpit n8n expose 5 opérations sur 3 ressources : collections, formulaires et singletons. Cockpit n'a pas de nœud trigger, donc le workflow démarre ailleurs et appelle Cockpit au moment utile.

Tester l'intégration Cockpit sur n8nVoir les 5 opérations

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert l'intégration Cockpit n8n ?

L'intégration Cockpit n8n tient dans un nœud unique qui parle à l'API de Cockpit depuis un workflow. Il réunit 5 opérations sous 3 ressources : les collections (créer, lire, mettre à jour une entrée), les formulaires (enregistrer une soumission) et les singletons (en lire un). Tu choisis la ressource, puis l'opération, tu désignes la collection ou le singleton par son nom, et n8n signe l'appel avec le credential enregistré une fois pour toutes, c'est-à-dire l'identifiant stocké côté n8n.

Le premier réflexe, c'est souvent d'écrire dans Cockpit plutôt que d'en sortir. Un formulaire d'inscription valide une candidature, et collection.create crée l'entrée correspondante dans la collection des profils. Tu remplis Entry Data champ par champ, ou tu bascules JSON Data Fields pour envoyer l'objet complet d'un bloc quand les données arrivent déjà structurées d'un nœud précédent.

Deuxième cas, l'entrant. Une page publiée sur ton site poste vers un Webhook n8n, une URL que n8n publie pour qu'un service extérieur appelle le workflow. form.submit range ensuite les réponses dans le formulaire Cockpit du même nom, et l'accusé de réception part par SendGrid dans la foulée. Les réponses restent sur ton instance, pas chez un prestataire de formulaires.

Troisième cas, la lecture en masse. Un Schedule Trigger se déclenche chaque lundi, collection.getAll sort les entrées d'une collection produits et les pose dans Google Sheets pour l'équipe commerciale. Active Return All et n8n enchaîne les pages de l'API jusqu'à vider la collection. Laisse-le décoché, et Limit plafonne le nombre d'entrées renvoyées, ce qui est exactement ce qu'il faut pendant les tests.

Restent les deux opérations discrètes. singleton.get lit un contenu isolé, du genre bannière ou adresse de contact, que la suite du workflow consulte comme un réglage. Et collection.update modifie une entrée existante, à condition de lui passer l'identifiant de l'entrée : le titre ne suffit pas, Cockpit travaille sur l'ID.

Deux points à connaître avant de construire. Cockpit n'ayant pas de trigger, le déclencheur vient toujours d'un autre nœud. Et ce qui sort de ces 5 opérations du catalogue passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Cockpit en réutilisant le même credential. Pour te faire une idée plus large de la plateforme, l'Avis n8n fait le tour, et la Formation n8n reprend la construction de ce type de workflow pas à pas.

Connexion

Comment connecter Cockpit à n8n ?

  1. 01

    Générer le token d'API dans Cockpit

    Il te faut d'abord un compte Cockpit et une instance auto-hébergée de Cockpit en service. Depuis cette instance, crée un token d'API en suivant la documentation Cockpit sur la gestion des tokens. C'est la seule méthode d'authentification acceptée par le nœud : aucun écran OAuth à valider, aucune application tierce à déclarer au passage. Garde le token de côté, il part dans n8n à l'étape suivante.

  2. 02

    Enregistrer le credential Cockpit dans n8n

    Va dans le menu Credentials de n8n et crée un credential Cockpit. Deux valeurs à renseigner. Cockpit URL, c'est l'adresse par laquelle tu accèdes à ton instance Cockpit. Access Token, c'est le token d'API que tu viens de générer. Une fois enregistré, ce credential se propose dans la liste déroulante de tous les nœuds Cockpit, dans tous tes workflows.

  3. 03

    Choisir une ressource et tester le nœud seul

    Pose un nœud Cockpit dans un workflow et commence par la ressource : Collection, Form ou Singleton. La liste des opérations se réduit à ce que cette ressource sait faire. Sur une collection, Collection Name or ID charge les collections de ton instance, tu sélectionnes la bonne au lieu de la saisir. Exécute le nœud seul et regarde ce qu'il renvoie avant de brancher la suite.

Actions

Ce que le nœud Cockpit sait faire

Le nœud Cockpit expose 5 opérations sur 3 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
RessourceCreate an EntryGetGet Many EntriesUpdate an EntrySubmit a Form
Collection✓✓✓
Form✓
Singleton✓

Collection

3 opérations
01

Create a collection entry

collection.create

Ce que tu vois dans n8n

Notes & cas d'usage

Ajoute une entrée dans une collection Cockpit et renvoie l'enregistrement créé, que le nœud suivant peut réutiliser tel quel.

Paramètres clés

  • Collection Name or ID : la collection qui reçoit l'entrée. Tu la prends dans la liste que n8n charge depuis ton instance, ou tu passes un ID via une expression.
  • JSON Data Fields : détermine la façon de remplir l'entrée, par l'interface de paires clé-valeur ou en JSON brut.
  • Entry Data : le contenu lui-même, saisi champ par champ en version interface, ou collé d'un bloc en version JSON.
Cas d'usage
un nouvel événement publié sur le site dès qu'il est confirmé dans l'agenda, avec le titre et la date repris de l'item entrant.
02

Get many collection entries

collection.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Sort les entrées d'une collection et les renvoie en items séparés, un par entrée, prêts à boucler ou à expédier ailleurs.

Paramètres clés

  • Return All : coché, n8n parcourt les pages de l'API jusqu'à la dernière entrée ; décoché, Limit fixe le plafond.
  • Filter Query : une requête au format Mongolite, par exemple {"name": "Jim"}, pour que le tri se fasse dans Cockpit et pas dans un nœud d'après.
  • Fields : une liste séparée par des virgules, du type _id,name, quand deux colonnes suffisent sur une entrée lourde.
  • Populate : résout les éléments liés depuis d'autres collections au lieu d'en laisser les références brutes.
Cas d'usage
l'export hebdomadaire du catalogue, ordonné avec Sort Query et paginé avec Skip quand la collection s'allonge.
03

Update a collection entry

collection.update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifie une entrée déjà présente. L'entrée garde son identité, seuls les champs que tu envoies sont réécrits.

Paramètres clés

  • Entry ID : l'identifiant de l'enregistrement à modifier, le plus souvent récupéré par une expression depuis une lecture précédente plutôt que tapé à la main. Un titre ne fonctionne pas, Cockpit se cale sur l'ID.
  • Collection Name or ID : la collection qui contient l'entrée.
  • Entry Data et JSON Data Fields : les nouvelles valeurs, et le mode de saisie, paires clé-valeur ou JSON.
Cas d'usage
faire passer un article de brouillon à publié dès qu'un relecteur valide dans Slack.

Form

1 opération
04

Submit a form

form.submit

Ce que tu vois dans n8n

Notes & cas d'usage

Enregistre une soumission dans Cockpit, comme si le visiteur avait rempli le formulaire directement sur ton site. La soumission est classée sous le formulaire que tu désignes.

Paramètres clés

  • Form : le nom du formulaire auquel rattacher les données. Il se saisit, il ne se choisit pas dans une liste, donc l'orthographe doit correspondre à celle du formulaire dans Cockpit.
  • Form Data : les réponses, mappées champ par champ ou envoyées en un seul objet JSON.
  • JSON Data Fields : bascule entre ces deux modes de remplissage.
Cas d'usage
une conversation avec un agent conversationnel qui finit en demande de devis, déposée dans le formulaire Cockpit que l'équipe dépouille chaque matin.

Singleton

1 opération
05

Get a singleton

singleton.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère un singleton, ce contenu autonome que Cockpit conserve en dehors des collections, et le renvoie en un item unique.

Paramètres clés

  • Singleton Name or ID : le singleton à lire, sélectionné dans la liste que n8n charge depuis ton instance ou transmis par son ID via une expression.
Cas d'usage
lire la bannière d'annonce du site en début de workflow, puis laisser un nœud IF décider si la campagne tourne encore avant d'exécuter la suite.
Besoin d'aide

Besoin d'aide pour automatiser Cockpit avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions qu'on se pose ensuite

01L'intégration Cockpit n8n est-elle gratuite ?
Oui, côté n8n. Le nœud Cockpit est livré avec n8n : rien à installer, rien à payer en plus pour s'en servir. C'est vrai sur n8n Cloud, l'offre hébergée par n8n, comme sur une instance que tu héberges toi-même avec Docker ou npm, en Community Edition sous licence Sustainable Use. Le workflow se comporte de la même façon dans les deux cas. Ce que te coûte Cockpit lui-même est une autre question, liée à la façon dont tu fais tourner ton instance, et cette page ne la traite pas.
02Quels identifiants faut-il pour connecter Cockpit ?
Un seul credential, par token d'accès à l'API. Il contient deux valeurs : la Cockpit URL, c'est-à-dire l'adresse par laquelle tu joins ton instance Cockpit, et un Access Token, qui est le token d'API créé dans Cockpit en suivant sa documentation sur la gestion des tokens. Il te faut donc un compte Cockpit et une instance auto-hébergée avant de pouvoir générer ce token. Une fois le credential enregistré dans le menu Credentials de n8n, il se réutilise : chaque nœud Cockpit le retrouve dans sa liste déroulante, sans redemander le token.
03Quelles sont les limites du nœud Cockpit ?
Le nœud couvre 5 opérations sur 3 ressources : collections, formulaires et singletons. Sur les collections longues, la pagination mérite attention. Return All enchaîne les pages de l'API jusqu'au bout, Limit arrête la lecture plus tôt, et le bloc Options de Get many collection entries ajoute 7 champs de plus, dont Skip, Sort Query et RAW Data. Ce qui sort de ces opérations du catalogue passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Cockpit en réutilisant le credential déjà en place.
04Existe-t-il un trigger Cockpit dans n8n ?
Non. Cockpit n'a pas de nœud trigger dans n8n, donc un workflow le concernant démarre toujours avec autre chose. Les deux options habituelles sont le Schedule Trigger, qui lance le workflow à intervalle fixe, et le Webhook n8n, une URL publiée par n8n pour qu'un service extérieur appelle le workflow dès qu'un événement survient de son côté. Le trigger d'un autre outil fait tout aussi bien l'affaire. Une fois le workflow lancé, le nœud Cockpit lit ou écrit là où tu l'as placé dans la chaîne.
05n8n ou Make pour Cockpit ?
Ça dépend de l'endroit où tes données doivent vivre et du modèle de coût qui te convient. Make est une plateforme d'automatisation hébergée, sans option d'auto-hébergement, facturée à l'opération. n8n tourne sur n8n Cloud ou sur ton propre serveur. Comme Cockpit s'héberge déjà chez toi, garder l'automatisation à côté évite que les contenus sortent des machines que tu maîtrises, et c'est souvent l'argument qui tranche ici. Make convient aux équipes qui ne veulent aucun serveur à surveiller. Les deux se construisent visuellement, le choix se joue rarement sur l'éditeur.
Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations