Recursos · Integración n8n

Integración Blue n8nAutomatiza Blue con n8n.

¿Se puede llevar un tablero de Blue desde un workflow? Sí. La integración Blue n8n abre la API GraphQL de la herramienta en 10 operaciones: crear un proyecto desde una plantilla, escribir tarjetas, etiquetarlas o lanzar una consulta libre. No hay trigger de Blue.

Nodo comunitario Este nodo no viene con n8n: es un paquete comunitario (n8n-nodes-blue) que instalas desde Settings › Community nodes en una instancia autoalojada. npm

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

Por qué automatizar

¿Para qué sirve la integración Blue n8n?

La integración Blue n8n habla con Blue Project Management a través de su API GraphQL. Instalado en una instancia autoalojada, entrega al workflow 10 operaciones sobre un único recurso: proyectos, records (las tarjetas y tareas de un tablero), campos personalizados, etiquetas e invitaciones de usuarios.

Primer caso, el alta de un proyecto. Cuando se cierra un trato, default.createProject copia una plantilla dentro de la empresa correspondiente, default.inviteUser suma al contacto con el rol Client y el nombre del tablero sale por Slack para que el equipo sepa dónde mirar.

Segundo caso, los vencimientos que nadie revisa. Una lectura programada con default.getRecords saca lo que sigue abierto en un proyecto, y default.updateRecord mueve la tarjeta de lista o le cambia la fecha antes de que el retraso se note en la reunión del lunes.

Tercer caso, clasificación asistida. El texto de una tarjeta pasa por un AI Agent que devuelve una categoría, y default.tagRecord la convierte en etiqueta sobre el record. El tablero queda ordenado sin que nadie arrastre tarjetas a mano.

Diez operaciones cubren el terreno habitual, no el esquema GraphQL entero. Hay dos salidas. default.customQuery envía la consulta que tú escribes, con sus variables, usando el mismo credential (la credencial que se guarda una vez en n8n). Y para lo que vive fuera de Blue, el nodo HTTP Request llama a cualquier endpoint reutilizando la autenticación predefinida.

Los límites, sin rodeos. Blue no tiene nodo trigger, así que nada empuja eventos hacia n8n: el workflow arranca con un Schedule Trigger a intervalo fijo o con un Webhook de n8n al que llama otro servicio. El nodo es un paquete comunitario, o sea instancia autoalojada, porque n8n Cloud solo acepta nodos comunitarios verificados. Las lecturas se paginan, con Limit y Skip para los records y Take y Skip para los campos. Si la plataforma todavía te resulta nueva, la Reseña n8n explica qué hace bien y qué no.

Conexión

¿Cómo se conecta Blue con n8n?

  1. 01

    Instalar el paquete comunitario

    Blue no viene con n8n. En una instancia autoalojada, tanto en Docker como en npm, entra en Settings, luego en Community nodes, e instala el paquete npm n8n-nodes-blue (versión 0.1.8). n8n Cloud solo acepta nodos comunitarios verificados, así que en un espacio Cloud puede que la instalación ni siquiera aparezca. Terminado el proceso, Blue sale en el panel de nodos como cualquier otra aplicación.

  2. 02

    Crear el credential de Blue una sola vez

    Usa el menú Credentials de n8n en lugar de crearlo dentro de un workflow suelto. Una credencial guardada ahí se reutiliza en todos los workflows de la instancia y el nodo la ofrece en su lista desplegable, sin copiar nada dos veces. El nodo no tiene selector de autenticación: hay una sola vía de entrada, nada que elegir. Ponle un nombre claro si conviven varias cuentas de Blue en la misma instancia.

  3. 03

    Elegir empresa y probar el nodo

    Coloca el nodo Blue en el lienzo y elige una operación. Casi todas empiezan por Company, un resource locator: n8n enumera las empresas a las que llega el credential en vez de pedirte un identificador. Project suele venir justo después. Lanza List Companies antes de montar nada más; si las empresas aparecen, la instalación y la conexión están bien.

Acciones

Qué sabe hacer el nodo Blue

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

01

Create a new project from a template

createProject

Lo que ves en n8n

Notas y casos de uso

Copia una plantilla y crea con ella un proyecto dentro de una empresa, de modo que el tablero nace ya estructurado en lugar de aparecer vacío.

Parámetros clave

  • Company: la empresa que aloja el proyecto, elegida entre las que alcanza el credential.
  • Project Name: el nombre del proyecto nuevo, a menudo {{ $json.account }} cuando llega desde una ficha del CRM.
  • Template Name or ID: la plantilla que se copia, también un resource locator, así que no hay identificadores que recordar.
Casos de uso
un contrato firmado abre el tablero de entrega de ese cliente con la misma estructura siempre.
02

Create a new record todo task with custom fields

createRecord

Lo que ves en n8n

Notas y casos de uso

Un record es una tarjeta o tarea del tablero. Esta operación escribe una nueva en la lista que elijas y rellena sus campos personalizados en la misma llamada.

Parámetros clave

  • Todo List: la lista donde aterriza la tarjeta; es obligatoria, así que vacía detiene el nodo.
  • Title: el texto visible en la tarjeta.
  • Due Date: opcional, aunque un tablero sin fechas se ordena mal a las pocas semanas.
  • Assignee Names or IDs: las personas asignadas, tomadas de la lista o pasadas como identificadores con una expresión.
Casos de uso
una incidencia enviada desde un formulario se convierte en tarjeta de triaje, con fecha y responsable puestos.
03

Execute a custom graph ql query

customQuery

Lo que ves en n8n

Notas y casos de uso

Cuando falta la operación, esta manda a Blue la consulta GraphQL que escribes y devuelve lo que responde la API, sin esperar a ninguna actualización del nodo.

Parámetros clave

  • GraphQL Query: el texto de la consulta, pegado en el campo.
  • Variables (JSON): un objeto JSON que se pasa a esa consulta, cómodo para un identificador que cambia en cada ejecución.
Casos de uso
leer un dato que ninguna operación dedicada expone, o juntar varias lecturas en una sola llamada antes de que el workflow se bifurque.
04

Get records with advanced filtering

getRecords

Lo que ves en n8n

Notas y casos de uso

Es el lado de lectura: devuelve los records de una empresa acotados por proyecto y por texto, para que el workflow trabaje sobre una porción y no sobre el tablero entero.

Parámetros clave

  • Company: obligatoria aquí, mientras que Project sigue siendo opcional, lo que permite buscar en toda la empresa.
  • Search Term: el texto que la tarjeta debe contener para aparecer.
  • Show Completed: decide si las tarjetas terminadas entran en el resultado.
  • Limit: el tope de resultados, combinado con Skip para recorrer un tablero largo por páginas.
Casos de uso
cada lunes, sacar lo que sigue abierto en un proyecto de cliente y convertirlo en un resumen corto.
05

Invite a user to a project

inviteUser

Lo que ves en n8n

Notas y casos de uso

Manda una invitación por correo y asigna un rol dentro del proyecto, lo que evita volver a entrar a mano para añadir a alguien una vez creado el tablero.

Parámetros clave

  • Email: la dirección de la persona invitada, con la forma user@example.com.
  • Role: Owner, Admin, Member, Client, Comment Only, View Only o Custom Role, del acceso total a la sola lectura.
  • Custom Role Name or ID: el rol personalizado definido en el proyecto, que el nodo pide junto a Role.
Casos de uso
entra un cliente nuevo, el workflow monta el tablero e invita a su contacto con el rol Client.
06

List all companies you have access to

getCompanies

Lo que ves en n8n

Notas y casos de uso

Devuelve todas las empresas a las que llega el credential. Es la llamada que conviene hacer primero cuando el workflow aún no sabe sobre qué tablero va a escribir.

Parámetros clave

  • Timeout (Ms): el tiempo de espera de la petición en milisegundos, útil de subir en una instancia lenta.
  • Return Full Response: devuelve la respuesta GraphQL completa, con errores y extensiones, en vez del resultado limpio.
Casos de uso
una ejecución de puesta en marcha que registra qué empresas ve de verdad un credential recién creado, antes de escribir nada.
07

List custom fields in a project with detailed information

listCustomFields

Lo que ves en n8n

Notas y casos de uso

Los campos personalizados guardan lo que cada equipo tiene de propio. Esta operación los enumera para un proyecto con su detalle, identificadores incluidos.

Parámetros clave

  • Sort Order: por fecha de creación, por nombre o por posición, en cualquiera de los dos sentidos.
  • Take: cuántos campos vuelven, un número entre 1 y 100.
  • Skip: cuántos se saltan, la otra mitad de la paginación.
Casos de uso
conseguir el identificador del campo que un Create Record tendrá que rellenar después, sin abrir Blue para copiarlo a mano.
08

List projects from a company

getProjects

Lo que ves en n8n

Notas y casos de uso

Enumera los proyectos de una empresa y nada más. Pese a lo breve que es, sirve sobre todo para traducir un nombre de proyecto al identificador que piden las demás operaciones.

Parámetros clave

  • Company: obligatoria, y el único campo que la operación pide.
  • Return Full Response: mejor desactivado, salvo que haga falta leer un error de GraphQL en el registro de ejecución.
Casos de uso
un workflow nocturno recorre todos los proyectos de una empresa y luego cuenta las tarjetas abiertas en cada uno.
09

Add tags to a record todo task

tagRecord

Lo que ves en n8n

Notas y casos de uso

Añade una o varias etiquetas a un record que ya existe, de manera que una automatización clasifica la tarjeta después, sin tocar su título ni su descripción.

Parámetros clave

  • Record ID: la tarjeta que se etiqueta, con la forma record-123, casi siempre {{ $json.id }} desde la lectura anterior.
  • Tag Names or IDs: las etiquetas que se añaden, elegidas de la lista o pasadas como identificadores con una expresión.
Casos de uso
un paso de puntuación etiqueta las tarjetas que pasan de cierto umbral y el tablero se ordena antes de que alguien lo abra.
10

Update a record todo task with custom fields

updateRecord

Lo que ves en n8n

Notas y casos de uso

Modifica una tarjeta existente: título, fechas, posición, color, personas, etiquetas y campos personalizados en una sola llamada, con cambio de lista incluido si hace falta.

Parámetros clave

  • Record ID: qué tarjeta se cambia, obligatoria junto a Company.
  • Todo List: se rellena para mover la tarjeta a otra lista y se deja vacía para dejarla donde está.
  • Color: un código de color como #FF5733 para las tarjetas que deben destacar.
  • Add Custom Field to Update: empareja un campo personalizado con su valor, una moneda escrita 100 USD, una casilla como True o False.
Casos de uso
un trato cambia de etapa en el CRM y la tarjeta asociada pasa a la lista siguiente con otra fecha de entrega.
Necesitas ayuda

¿Necesitas ayuda para automatizar Blue con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Blue y n8n, las dudas que vienen después

01¿La integración Blue n8n es gratis?
Sí por el lado de n8n, con una condición. Blue no viene incluido: es un nodo comunitario, el paquete npm n8n-nodes-blue en versión 0.1.8, y alguien tiene que instalarlo desde Settings y luego Community nodes. Ese camino existe en una instancia autoalojada, da igual si corre en Docker o en npm. n8n Cloud solo acepta nodos comunitarios verificados, así que en un espacio Cloud puede que no se pueda añadir. Instalar el paquete y ejecutar el nodo no cuesta nada extra dentro de n8n. Lo que cuesta una cuenta de Blue es otra pregunta y esta página no la responde.
02¿Qué credenciales necesita el nodo de Blue?
Un credential de Blue, creado una sola vez. Entra en el menú Credentials de n8n, añade ahí la credencial en lugar de hacerlo dentro de un workflow, y todos los workflows de la instancia podrán reutilizarla; el nodo la ofrece luego en su lista desplegable. El nodo no lleva selector de autenticación, así que hay una sola vía de entrada y ningún método que comparar. Los campos exactos de esa credencial no constan en el catálogo con el que se armó esta página, de modo que revisa la documentación del paquete al rellenar el formulario. Después ejecuta List Companies para comprobarlo.
03¿Qué límites tiene el nodo de Blue en n8n?
Hay tres que conviene tener claros. El primero: el nodo expone 10 operaciones sobre un único recurso, una parte de la API GraphQL de Blue y no toda; Execute Custom GraphQL cubre el hueco con una consulta escrita a mano, y el nodo HTTP Request llega a cualquier endpoint reutilizando la misma autenticación predefinida. El segundo: las lecturas se paginan, Get Records avanza con Limit y Skip, y List Custom Fields con Take y Skip, así que una exportación completa pide un bucle. El tercero: no existe trigger de Blue, nada avisa a n8n cuando una tarjeta cambia.
04¿El nodo de Blue reacciona en tiempo real?
No, porque Blue no tiene nodo trigger en n8n. Nada empuja un evento desde Blue hacia un workflow, así que el arranque llega desde otro sitio. Dos montajes resuelven casi todo. Un Schedule Trigger se dispara a intervalo fijo, llama a Get Records y un nodo If compara lo que vuelve con lo que guardó la ejecución anterior. La otra opción es un Webhook de n8n, una URL a la que llama otro servicio, que arranca el workflow en cuanto ese servicio tiene novedades y deja que el nodo de Blue escriba en el tablero. El trigger de otra herramienta cumple el mismo papel.
05¿n8n o Make para Blue?
Depende de dónde deban quedarse los datos y de cómo prefieras pagar las ejecuciones. Make está alojado por Make, sin opción de autoalojamiento, y factura por operación, así que el gasto sigue al volumen. n8n funciona en n8n Cloud o en tu propio servidor, con Docker o con npm, y el workflow se comporta igual en ambos casos, algo que pesa cuando las tarjetas llevan información de clientes. Como Blue es un nodo comunitario y los nodos comunitarios solo se instalan en una instancia autoalojada, aquí la decisión ya viene medio tomada. Make entra mejor por lo visual; n8n deja más margen en expresiones y código.