Intégration Blue n8nAutomatiser Blue avec n8n.
Un tableau Blue peut-il se tenir à jour tout seul ? L'intégration Blue n8n ouvre l'API GraphQL de l'outil en 10 opérations : créer un projet depuis un modèle, écrire une carte, poser des tags, lancer une requête libre. Aucun trigger Blue, le workflow démarre ailleurs.
Nœud communautaire Ce nœud n'est pas livré avec n8n : c'est un paquet communautaire (n8n-nodes-blue) à installer depuis Settings › Community nodes sur une instance auto-hébergée. npm
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
Que permet l'intégration Blue n8n ?
L'intégration Blue n8n dialogue avec Blue Project Management via son API GraphQL. Une fois installé sur une instance auto-hébergée, il donne au workflow 10 opérations sur une seule ressource : les projets, les records (les cartes et tâches d'un tableau), les champs personnalisés, les tags et les invitations d'utilisateurs.
Premier scénario, la boîte mail qui alimente le tableau. Une demande arrive dans Gmail, n8n lit l'objet et le corps, puis default.createRecord crée la carte dans la bonne liste avec une date d'échéance et un responsable déjà posés. Personne ne retape la demande à la main.
Deuxième scénario, l'entretien des tags. Une lecture planifiée passe par default.getRecords, un test simple repère les cartes qui traînent, et default.tagRecord leur colle l'étiquette qui va bien. Les cartes concernées remontent d'elles-mêmes dans les filtres du tableau.
Troisième scénario, l'inventaire d'un espace de travail. default.getProjects liste les projets d'une entreprise, default.listCustomFields récupère les champs personnalisés de chacun, et le workflow compare les tableaux entre eux avant qu'un nouveau projet parte de travers.
Dix opérations couvrent le terrain courant, pas tout le schéma GraphQL. Deux sorties de secours. default.customQuery envoie la requête que tu écris, variables comprises, avec le même credential (l'identifiant de connexion enregistré une fois dans n8n). Et pour tout ce qui vit hors de Blue, le nœud HTTP Request appelle n'importe quel endpoint en réutilisant l'authentification prédéfinie.
Les limites, dites franchement. Blue n'a pas de nœud trigger : rien ne pousse d'événement vers n8n, donc le workflow démarre sur un Schedule Trigger à intervalle fixe ou sur un Webhook n8n appelé par un service tiers. Le nœud est un paquet communautaire, donc une instance auto-hébergée, puisque n8n Cloud n'accepte que les nœuds communautaires vérifiés. Les lectures se paginent, avec Limit et Skip pour les records, Take et Skip pour les champs. Pour situer la plateforme autour du nœud, l'Avis n8n fait le tour, et la Formation n8n prend le relais quand il faut construire seul.
Comment connecter Blue à n8n ?
- 01
Installer le paquet communautaire
Blue n'est pas livré avec n8n. Sur une instance auto-hébergée, en Docker comme en npm, ouvre Settings, puis Community nodes, et installe le paquet npm
n8n-nodes-blue(version0.1.8). n8n Cloud n'accepte que les nœuds communautaires vérifiés : sur un espace Cloud, l'installation peut ne pas être proposée du tout. Une fois l'opération terminée, Blue apparaît dans le panneau des nœuds comme n'importe quelle application. - 02
Créer le credential Blue une fois
Passe par le menu Credentials de n8n plutôt que par un workflow isolé. Un credential créé là se réutilise dans tous les workflows de l'instance, et le nœud le propose ensuite dans sa liste déroulante. Le nœud n'a pas de sélecteur d'authentification : il y a une seule porte d'entrée, donc rien à arbitrer. Donne-lui un nom explicite si plusieurs comptes Blue cohabitent sur la même instance.
- 03
Choisir une entreprise et lancer le nœud
Pose le nœud Blue sur le canvas et choisis une opération. La plupart commencent par Company, un resource locator : n8n liste les entreprises accessibles au credential au lieu de réclamer un identifiant. Project vient souvent juste après. Lance List Companies avant de construire quoi que ce soit : si les entreprises remontent, l'installation et la connexion tiennent.
Ce que le nœud Blue sait faire
Le nœud Blue expose 10 opérations. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
Create a new project from a template
createProjectCe que tu vois dans n8n
Notes & cas d'usage
Cette opération duplique un modèle pour créer un projet dans une entreprise. Le tableau arrive structuré, pas vide, ce qui évite la demi-heure de mise en forme habituelle.
Paramètres clés
- Company : l'entreprise qui va héberger le projet, prise dans la liste accessible au credential.
- Project Name : le nom du nouveau projet, souvent
{{ $json.account }}quand il vient d'une fiche CRM. - Template Name or ID : le modèle à copier, choisi dans une liste.
Create a new record todo task with custom fields
createRecordCe que tu vois dans n8n
Notes & cas d'usage
Un record, c'est une carte ou une tâche sur un tableau Blue. L'opération en écrit une dans la liste choisie et remplit ses champs personnalisés dans le même appel.
Paramètres clés
- Todo List : la liste d'accueil de la carte, requise, donc le nœud s'arrête si elle reste vide.
- Title : le texte affiché sur la carte.
- Due Date : facultative, mais un tableau sans échéances se trie mal au bout de trois semaines.
- Assignee Names or IDs : les personnes à assigner, prises dans la liste ou passées en identifiants via une expression.
Execute a custom graph ql query
customQueryCe que tu vois dans n8n
Notes & cas d'usage
Quand l'opération manque, celle-ci envoie à Blue la requête GraphQL que tu écris et renvoie la réponse de l'API telle quelle. Aucune mise à jour du nœud à attendre.
Paramètres clés
- GraphQL Query : le texte de la requête, collé directement dans le champ.
- Variables (JSON) : un objet JSON passé à cette requête, pratique pour un identifiant qui change à chaque exécution.
Get records with advanced filtering
getRecordsCe que tu vois dans n8n
Notes & cas d'usage
Côté lecture, elle ramène les records d'une entreprise en les restreignant par projet et par texte. Le workflow travaille sur une tranche, jamais sur tout l'historique du tableau.
Paramètres clés
- Company : requise ici, alors que Project reste facultatif, ce qui autorise une recherche sur toute l'entreprise.
- Search Term : le texte que la carte doit contenir pour remonter.
- Show Completed : décide si les cartes terminées rejoignent le résultat.
- Limit : le plafond de résultats, à combiner avec Skip pour parcourir un tableau chargé page après page.
Invite a user to a project
inviteUserCe que tu vois dans n8n
Notes & cas d'usage
Elle envoie une invitation par email et attribue un rôle sur le projet, ce qui supprime l'aller-retour manuel pour ajouter un collaborateur une fois le tableau créé.
Paramètres clés
- Email : l'adresse de la personne à inviter, au format
user@example.com. - Role : Owner, Admin, Member, Client, Comment Only, View Only ou Custom Role, de l'accès complet à la lecture seule.
- Custom Role Name or ID : le rôle personnalisé défini dans le projet, que le nœud demande à côté de Role.
List all companies you have access to
getCompaniesCe que tu vois dans n8n
Notes & cas d'usage
Elle renvoie toutes les entreprises accessibles au credential. C'est l'appel à faire en premier quand le workflow ne sait pas encore sur quel tableau il va écrire.
Paramètres clés
- Timeout (Ms) : le délai d'attente de la requête en millisecondes, à monter sur une instance lente.
- Return Full Response : renvoie la réponse GraphQL complète, erreurs et extensions comprises, au lieu du résultat nettoyé.
List custom fields in a project with detailed information
listCustomFieldsCe que tu vois dans n8n
Notes & cas d'usage
Les champs personnalisés portent ce qu'une équipe a de particulier. Cette opération les liste pour un projet avec leur détail, identifiants inclus.
Paramètres clés
- Sort Order : par date de création, par nom ou par position, dans un sens ou dans l'autre.
- Take : le nombre de champs renvoyés, entre
1et100. - Skip : le nombre de champs sautés, l'autre moitié du couple de pagination.
List projects from a company
getProjectsCe que tu vois dans n8n
Notes & cas d'usage
Elle liste les projets rattachés à une entreprise, rien de plus. Courte, elle sert surtout à transformer un nom de projet en identifiant, celui que les autres opérations réclament.
Paramètres clés
- Company : requise, et c'est le seul champ demandé par l'opération.
- Return Full Response : à laisser décoché, sauf pour lire une erreur GraphQL dans le journal d'exécution.
Add tags to a record todo task
tagRecordCe que tu vois dans n8n
Notes & cas d'usage
Elle ajoute un ou plusieurs tags à un record existant. Une automatisation peut donc classer une carte après coup, sans toucher ni à son titre ni à sa description.
Paramètres clés
- Record ID : la carte à étiqueter, au format
record-123, en général{{ $json.id }}depuis la lecture qui précède. - Tag Names or IDs : les tags à poser, choisis dans la liste ou passés en identifiants via une expression.
Update a record todo task with custom fields
updateRecordCe que tu vois dans n8n
Notes & cas d'usage
Elle modifie une carte existante : titre, dates, position, couleur, personnes, tags et champs personnalisés en un seul appel, déplacement de liste compris.
Paramètres clés
- Record ID : la carte à modifier, requise à côté de Company.
- Todo List : à renseigner pour déplacer la carte vers une autre liste, à laisser vide pour ne pas y toucher.
- Color : un code couleur du type
#FF5733pour les cartes qui doivent sauter aux yeux. - Add Custom Field to Update : associe un champ personnalisé à sa valeur, une devise écrite
100 USD, une case à cocher en True ou False.
Besoin d'aide pour automatiser Blue avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
