Integración Businessmap n8nAutomatiza Businessmap con n8n.

Crea una tarjeta y la coloca en un punto exacto del tablero, y luego la devuelve con la forma que pidas.

• Board Name or ID, Workflow Name or ID, Lane Name or ID y Column Name or ID: las cuatro coordenadas obligatorias del destino, cada una elegida de una lista o indicada por su identificador.
• Title, Description, Priority (Critical, High, Average, Low), Deadline y Owner Name or ID: opcionales, y merece la pena llenarlos desde el item entrante, por ejemplo {{ $json.deadline }}.

Modifica una tarjeta que ya existe y deja intacto todo lo que no rellenes.

• Card ID: el identificador numérico de la tarjeta a modificar, obligatorio, que suele venir del trigger como {{ $json.card_id }}.
• Board Name or ID: también obligatorio aquí, para que el nodo sepa de qué tablero salen las etiquetas, los adhesivos y los tipos de tarjeta.
• Workflow, Column and Lane Fields: colección opcional, útil si el cambio también mueve la tarjeta.

Lleva una tarjeta a otra posición sin tocar su contenido, que es la operación detrás de casi todos los cambios de etapa.

• Card ID: la tarjeta que se mueve.
• Board Name or ID, Workflow Name or ID, Lane Name or ID, Column Name or ID: el destino completo, los cuatro obligatorios, porque una columna sola es ambigua en un tablero con varios carriles.

Lee una sola tarjeta a partir de su identificador numérico y la pasa al nodo siguiente.

• Card ID: el identificador de la tarjeta que quieres, obligatorio.
• Output: simplified para una tarjeta compacta, raw para todo lo que devuelve la API, selected para elegir.
• Select Output Fields: los campos devueltos en modo selected, por ejemplo title, deadline y owner_user_id.

Localiza una tarjeta por la referencia legible que le pone el equipo, y no por la clave numérica.

• Custom Card ID: el custom card ID de la tarjeta buscada, una cadena de texto, obligatorio.
• Board Name or ID: opcional, útil para acotar la búsqueda cuando el mismo formato de referencia existe en varios tableros.

Recupera todas las tarjetas de un tablero en una ejecución, el punto de partida de casi cualquier exportación o auditoría.

• Board Name or ID: el tablero que se lee, obligatorio.
• Select Output Fields: aquí se aligera la carga, porque un tablero con cientos de tarjetas devuelto en raw vuelve el resto del flujo difícil de leer y de depurar.

Crea una relación entre dos tarjetas, que es como el tablero muestra que un trabajo depende de otro.

• Card ID: la tarjeta de partida, que debe pertenecer al tablero seleccionado cuando la acción exige uno.
• Will Be Linked As: el tipo de relación, parents, children, relatives, successors o predecessors.
• To Card ID: la tarjeta del otro extremo.

Elimina una relación existente entre dos tarjetas y deja ambas en su sitio.

• Unlink Card ID: la tarjeta cuya relación estás cortando.
• Linked As: la relación que se retira, con los mismos cinco valores que al crearla.
• From Card ID: la tarjeta situada al otro extremo de esa relación.

Escribe los campos propios del tablero en una tarjeta, los que el equipo añadió sobre los campos estándar.

• Card ID y Board Name or ID: obligatorios los dos, porque los campos personalizados se definen tablero por tablero.
• Custom Fields to Set: un resource mapper que carga los campos de ese tablero y te deja asociar cada uno a un valor del item entrante.

Marca una tarjeta como bloqueada con un motivo documentado, para que el tablero enseñe dónde se atasca el trabajo.

• Board Name or ID y Card ID: el tablero implicado y la tarjeta bloqueada.
• Block Reason Name or ID: se elige entre los motivos configurados en ese tablero.
• Comment: obligatorio, y ahí el flujo se explica, por ejemplo nombrando el documento que falta.

Quita la marca de bloqueo de una tarjeta cuando el obstáculo desaparece y la tarjeta retoma su camino.

• Card ID: la tarjeta bloqueada, obligatorio. Si la acción elegida pide un tablero, comprueba que la tarjeta pertenece a él.
• Output: elige simplified si al nodo siguiente le basta la confirmación de que ya no está bloqueada.

Saca del tablero activo una tarjeta terminada y la mantiene consultable, al contrario que un borrado.

• Card ID: la tarjeta que se archiva, obligatorio.
• Select Output Fields: incluye archived_at cuando el nodo siguiente tenga que anotar en qué momento salió del tablero.

Devuelve al tablero una tarjeta archivada, en la posición que ocupaba al archivarse.

• Card ID: la tarjeta archivada que vuelve, obligatorio.
• Output: raw es la opción prudente aquí, porque el estado posterior al desarchivado es justo lo que querrás mirar en el registro de ejecución.

Descarta una tarjeta que nunca se va a entregar, el final honesto de un trabajo cancelado.

• Card ID: la tarjeta que se descarta, obligatorio.
• Select Output Fields: discarded_at y discard_comment son los dos campos que conviene devolver si más adelante un informe debe explicar la cancelación.

Deshace un descarte y devuelve la tarjeta al grupo de las vivas.

• Card ID: la tarjeta descartada que se restaura, obligatorio. Si la acción escogida pide un tablero, revisa que la tarjeta sea de ese tablero.
• Output: selected deja una respuesta corta cuando más adelante solo importa el identificador.

Publica un comentario en una tarjeta, la forma más simple que tiene un flujo de dejar un rastro que la gente lea de verdad.

• Card ID: la tarjeta que recibe el comentario, obligatorio.
• Comment: el texto, obligatorio, escrito como texto o como HTML, así un resumen con formato hecho antes en el flujo se sigue leyendo bien.

Añade un paso de lista dentro de una tarjeta, con responsable y fecha propios.

• Card ID y Board Name or ID: la tarjeta padre y su tablero, obligatorios los dos.
• Description: el texto de la subtarea, obligatorio, como texto o como HTML.
• Deadline, Owner Name or ID y Subtask Status: opcionales, y el estado permite crear un paso ya marcado como terminado.

Registra tiempo dedicado a una tarjeta, que es lo que hace un tablero útil para facturar o medir carga.

• Card ID: la tarjeta a la que se imputa el tiempo.
• Time Unit y Duration: la unidad y la cantidad, obligatorias las dos, para que la misma cifra no se lea en minutos aquí y en horas allá.
• Date: el día en que se hizo el trabajo, obligatorio, y Comment queda opcional.

Adjunta un archivo a una tarjeta a partir de los datos binarios que trae el nodo anterior.

• Card ID: la tarjeta que recibe el archivo, obligatorio.
• File Name: el nombre con el que se verá el adjunto en la tarjeta, obligatorio, y un nombre dinámico tipo {{ $json.reference }}.pdf rinde mejor que uno fijo.
• Content: los datos binarios del archivo, obligatorios.

Trae de vuelta al flujo, en datos binarios, un archivo ya adjunto en una tarjeta.

• Card ID: la tarjeta que guarda el archivo, obligatorio.
• File Name or ID: el archivo que se descarga, elegido de la lista o indicado con un identificador de adjunto sacado de Get Attachments, que es la manera habitual de encadenar las dos operaciones.

Lista los archivos adjuntos de una tarjeta, sin ningún otro ajuste que pensar.

• Card ID: la tarjeta cuyos adjuntos quieres, obligatorio, y es el único parámetro de esta operación.

Abre un espacio de trabajo, el contenedor que más tarde alojará tableros.

• Workspace Name: el nombre del espacio, obligatorio, y lo único sin lo que la operación no funciona.
• Type: opcional, fija el tipo del espacio cuando el valor por defecto no sirve.

Cambia el nombre de un espacio o su estado de archivo, según el campo opcional que rellenes.

• Workspace ID: el identificador numérico del espacio a modificar, obligatorio, con la forma 12345.
• Workspace Name: opcional, para mantener la nomenclatura alineada con el sistema que manda.
• Archive: opcional, archiva o desarchiva el espacio en una sola ejecución.

Va a buscar un espacio de trabajo y entrega su contenido a la rama siguiente.

No escribe nada de vuelta, así que la operación cabe sin riesgo en cualquier rama que solo busque contexto.

• Workspace ID: el identificador del espacio a leer, obligatorio, y aquí el único parámetro.

Enumera espacios de trabajo con dos criterios obligatorios, en vez de traerlo todo a ciegas.

Como los dos filtros son obligatorios, el resultado sigue siendo predecible incluso en una cuenta que lleva años creciendo.

• Type: obligatorio, busca los espacios del tipo seleccionado.
• Get All, Archived or Non-Archived: obligatorio, selecciona los espacios por su estado de archivo.

Añade un tablero dentro del espacio de trabajo que indiques, listo para recibir tarjetas.

El tablero llega vacío, así que la ejecución siguiente suele asignarle sus etiquetas y adhesivos acto seguido.

• Workspace: obligatorio, elige el espacio al que pertenece el tablero.
• Name: obligatorio, el nombre del tablero, por ejemplo My board.
• Description: opcional, útil para llevar el contexto del proyecto al que sirve el tablero.

Reescribe el nombre de un tablero, su descripción o su estado de archivo.

• Board ID: el identificador numérico del tablero a modificar, obligatorio, con la forma 9876.
• Name y Description: opcionales, se quedan como están si no los rellenas.
• Archive: opcional, archiva o desarchiva el tablero.

Devuelve un solo tablero a partir de su identificador, sin modificar nada en él.

Es la lectura que responde a una sola pregunta: si el tablero que hay detrás de un identificador es el que espera el workflow.

• Board ID: el identificador del tablero a leer, obligatorio, y el único campo que rellenar.

Recorre los tableros de la cuenta, con dos filtros opcionales para acotar la cosecha.

Sin ningún filtro devuelve sencillamente lo que el credential alcanza a ver, suficiente para una primera exploración.

• Workspace: opcional, filtra los tableros por espacio de trabajo.
• Show Archive: opcional, decide si los tableros archivados vuelven en la lista.

Muestra cómo está construido un tablero, que es lo que se lee antes de mover nada dentro.

La respuesta describe la disposición y no el contenido, así que sigue siendo útil en un tablero cuyas tarjetas cambian todo el día.

• Board ID: el identificador del tablero cuya estructura recuperas, obligatorio.

Declara una etiqueta en la cuenta, con un color opcional para leerla de un vistazo.

La etiqueta existe a nivel de cuenta en cuanto se crea, y aún hay que asignarla a un tablero antes de que una tarjeta la lleve.

• Label: obligatorio, el texto de la etiqueta, por ejemplo Label.
• Color: opcional, fija el color de la etiqueta con la forma #EEEEEE.

Cambia el texto de una etiqueta existente, y su color si rellenas también ese campo.

• Tag ID: obligatorio, el identificador numérico de la etiqueta, con la forma 12345.
• Label: obligatorio aquí, a diferencia de la creación donde nada obliga a repetirlo.
• Color: opcional, y la vía más rápida para alinear una etiqueta con un código de color decidido fuera.

Borra una etiqueta de la cuenta, una decisión que ninguna otra operación deshace.

Conviene protegerla con una condición, porque las tarjetas que llevaban la etiqueta no la recuperan después.

• Tag ID: el identificador de la etiqueta a borrar, obligatorio, y el único parámetro de la operación.

Busca una etiqueta por su identificador o por su texto, cómodo cuando entre herramientas solo viaja el texto.

• Tag ID/Label: obligatorio, el identificador o el texto de la etiqueta a leer, por ejemplo 12345 or Label Name.
• Search By: opcional, elige sobre cuál de los dos va la búsqueda.

Devuelve todas las etiquetas conocidas de la cuenta, sin nada que configurar.

Esta operación no toma ningún parámetro, así que es la forma más barata de montar una tabla de correspondencia al principio de la ejecución y la compañera natural de la asignación que viene después. Conviene lanzarla una vez por ejecución y no una vez por tarjeta.

Pone una etiqueta existente a disposición de un tablero, paso obligado antes de que una tarjeta la lleve allí.

Asignar cuesta una llamada por pareja, algo que un bucle sobre los tableros de un espacio absorbe sin lógica adicional.

• Tag Name or ID: obligatorio, elegido de la lista o indicado por su identificador.
• Board Name or ID: obligatorio, el tablero que recibe la etiqueta.

Registra un adhesivo con su texto, y un color cuando quieres que destaque.

Como una etiqueta, un adhesivo se crea una vez para la cuenta y se reutiliza en tantos tableros como le asignes.

• Label: obligatorio, el texto del adhesivo, por ejemplo Label.
• Color: opcional, puesto con la forma #EEEEEE.

Modifica el texto de un adhesivo ya existente, y de paso su color.

• Sticker ID: obligatorio, el identificador numérico, con la forma 12345.
• Label: obligatorio en esta operación, para que un adhesivo nunca se quede sin texto.
• Color: opcional, intacto si no lo rellenas.

Elimina un adhesivo de la cuenta para siempre.

Aquí no hay vuelta atrás, así que una ejecución que borra en bloque merece una rama en seco que solo deje traza.

• Sticker ID: el identificador del adhesivo a borrar, obligatorio, y nada más que aportar.

Resuelve un adhesivo desde su identificador o desde su texto, según lo que traiga el item entrante.

• Sticker ID/Label: obligatorio, el identificador o el texto del adhesivo a leer, por ejemplo 12345 or Label Name.
• Search By: opcional, indica al nodo sobre cuál de los dos buscar.

Enumera los adhesivos de la cuenta en una sola llamada.

Tampoco hay parámetros que rellenar aquí, lo que la convierte en un primer paso natural de una sincronización y en una manera sencilla de saber qué existe ya antes de crear nada. La respuesta cubre la cuenta y no un tablero, así que la asignación sigue siendo una decisión aparte.

Engancha un adhesivo a un tablero para que sus tarjetas puedan llevarlo.

La asignación va tablero a tablero, de modo que un mismo adhesivo equipa a un equipo y sigue invisible en los de otro.

• Sticker Name or ID: obligatorio, elegido de la lista o indicado por su identificador.
• Board Name or ID: obligatorio, el tablero de destino.

Redacta un documento desde el workflow, con contenido en texto o en HTML.

• Title: obligatorio, el título del documento.
• Content: opcional, escrito como texto o como HTML.
• Additional Fields: colección opcional con For Welcome, Is Archived, Is Important, Is Indexed for AI, Parent Doc ID y Show in Main Doc List.

Carga un único documento por su identificador y lo pasa al resto del flujo.

Solo viaja el identificador, así que esta lectura encaja de forma natural con un trigger que ya lo trae.

• Document ID: obligatorio, el identificador numérico, con la forma 123.

Reúne todos los documentos que viven en un tablero.

La lista vuelve tablero a tablero, lo que la convierte en la puerta de entrada de cualquier auditoría de toda la cuenta.

• Board Name or ID: obligatorio, el tablero cuyos documentos se listan.

Retoca un documento en su sitio y conserva tal cual cada campo que dejes vacío.

• Document ID: obligatorio, el documento a modificar.
• Title y Content: opcionales, se conservan si los dejas vacíos.
• Update Fields: colección opcional con For Welcome, Is Archived, Is Important, Is Indexed for AI y Parent Doc ID.

Coloca un documento existente en una tarjeta, en un tablero, o en ambos en la misma llamada.

• Document ID: obligatorio, el documento a colocar.
• Card ID: opcional, la tarjeta que recibe el documento, dejado en 0 para omitirlo.
• Board Name or ID: opcional, el tablero que lo recibe, dejado vacío para omitirlo.

Sube un archivo desde el workflow y lo adjunta a un documento.

• Document ID: obligatorio, el documento que recibe el archivo.
• File Name: opcional, el nombre que toma el archivo.
• Binary Property: opcional, el nombre del campo binario del item, o una expresión que devuelva ese nombre o el objeto binario completo cuando el item ya no lleva el archivo.