Conecta Taiga con n8n: 20 operaciones y 6 tipos de evento

Por qué automatizar

¿Qué hace en realidad la integración Taiga n8n?

La integración Taiga n8n une los tableros de proyecto de Taiga con los flujos de trabajo de n8n, en los dos sentidos. El nodo Taiga cubre 20 operaciones repartidas en 4 recursos, epics, historias de usuario, tareas e issues, así que un flujo puede crear, leer, actualizar o borrar cualquiera de ellos. El Taiga Trigger hace lo contrario: registra un webhook, o sea una URL a la que Taiga llama, y arranca el flujo en cuanto algo se mueve en el tablero.

Primer escenario, la entrada de trabajo. Un formulario de soporte llega a n8n, un paso de clasificación aparta lo que no es un fallo, y issue.create deja la issue en el proyecto correcto con su prioridad y su severidad ya puestas. La misma ejecución copia la referencia en Google Sheets para quien nunca abre Taiga.

Segundo escenario, el informe de sprint. A una hora fija, userStory.getAll recupera las historias del milestone activo con Return All encendido, task.getAll trae las tareas que cuelgan de ellas, y el resultado aterriza en Microsoft SQL para alimentar un panel, o sale como resumen del lunes por Slack.

Tercer escenario, dos sistemas que deben contar lo mismo. El Taiga Trigger salta con el evento issue, el flujo lee los datos recibidos y replica el cambio en GitHub. Al revés también funciona: un evento de GitHub que termina creando la issue en Taiga.

Cuándo tirar de HTTP Request. El nodo expone las 20 operaciones que verás más abajo. La API de Taiga tiene endpoints más allá de esa lista, y el nodo HTTP Request llama a cualquiera de ellos reutilizando el mismo credential de Taiga con la autenticación predefinida. Un solo acceso vale para los dos nodos.

Dos límites que conviene tener claros antes de montar nada. En las cuatro operaciones Get Many, Return All es lo que hace que n8n recorra todas las páginas de resultados: apagado, Limit pone techo a lo que vuelve, algo válido para una vista rápida y erróneo para una exportación. Y cada desplegable marcado Name or ID espera un identificador cuando lo alimentas con una expresión, no el nombre que lees en el tablero. Si n8n todavía te suena lejano, la Reseña n8n da el contexto completo.

Conexión

¿Cómo se conecta Taiga con n8n?

01
Crear el credential de Taiga
Lo primero es tener una cuenta de Taiga. En n8n, abre el menú Credentials y añade un credential de Taiga: un credential es el juego de datos de acceso que n8n guarda una sola vez. El nodo se autentica con basic auth, así que pide un Username, que acepta tu nombre de usuario o el correo de la cuenta, y un Password.
02
Elegir el entorno correcto
El campo Environment decide con qué Taiga habla el credential. Cloud apunta al servicio alojado. Self-Hosted apunta a tu propia instalación y hace aparecer un campo URL donde escribes la dirección de esa instancia. Ajusta esta pareja antes de probar nada: todo lo demás depende de que n8n llame a la máquina correcta.
03
Seleccionar el credential en el nodo
Coloca un nodo Taiga o un Taiga Trigger en el lienzo y elige en su desplegable el credential que acabas de guardar. Los dos nodos aceptan el mismo, así que un flujo que escucha y otro que escribe comparten un único acceso. Después eliges recurso y operación, y la lista Project Name or ID se rellena sola desde tu cuenta.

Disparadores

¿Qué arranca un flujo desde Taiga ?

Taiga Trigger es el nodo que arranca un workflow cuando algo ocurre en Taiga. Escucha 6 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que Taiga llama) en tu cuenta.

Lo que ves en n8n

Todos los eventos, por familia

Una fila por objeto, un chip por acción. El evento que marcas en el nodo se escribe objeto.acción; pasa el cursor por un chip para leer cuándo se dispara.

all.*1

all.
- all

issue.*1

issue.
- issue

milestone.*1

milestone.
- milestone

task.*1

task.
- task

userstory.*1

userstory.
- userstory

wikipage.*1

wikipage.
- wikipage

Notas de configuración

01Set up the Taiga TriggerEl Taiga Trigger es la puerta de entrada: recibe los eventos de Taiga por webhook, una URL a la que Taiga llama cuando ocurre algo, y arranca el flujo en cuestión de segundos. Sin polling, así que no hay ningún intervalo que ajustar.

El Taiga Trigger es la puerta de entrada: recibe los eventos de Taiga por webhook, una URL a la que Taiga llama cuando ocurre algo, y arranca el flujo en cuestión de segundos. Sin polling, así que no hay ningún intervalo que ajustar.

Parámetros clave

Project Name or ID: el proyecto a vigilar, elegido de la lista o pasado como identificador con una expresión. Es obligatorio, de modo que un trigger cubre un proyecto.
Operations: la selección múltiple de lo que se escucha, también obligatoria. Hay 6 valores disponibles y varios pueden convivir en el mismo trigger.

Cuándo usarlo

siempre que el flujo deba reaccionar al tablero y no a un reloj. Activa el flujo para registrar el webhook, y ten presente que un flujo desactivado deja de recibir eventos.

02Issue eventsEl valor issue manda al trigger cada movimiento de issue del proyecto vigilado. Es la cara de fallos e incidencias de Taiga, y suele ser el más ruidoso de los seis, razón de más para encaminarlo con cuidado.

El valor issue manda al trigger cada movimiento de issue del proyecto vigilado. Es la cara de fallos e incidencias de Taiga, y suele ser el más ruidoso de los seis, razón de más para encaminarlo con cuidado.

Casos de uso

una issue que entra se cruza con el calendario de guardias y el mensaje sale al canal que toca. Otra variante: el flujo lee los datos recibidos, llama a issue.get para la ficha completa y escribe una fila en una tabla de seguimiento con la que medir después los tiempos de respuesta.

Cuándo usarlo

para todo lo que deba pasar rápido después de abrir o tocar un fallo. Pon un filtro pronto en el flujo, porque un proyecto activo dispara este evento varias veces al día y casi nunca quieres que todos lleguen al final de la cadena.

03User Story and Task eventsDos valores distintos, userstory y task, cubren la cara de entrega del tablero. Marca los dos en el mismo trigger cuando un flujo sigue toda la cadena, o sepáralos en dos flujos cuando las reacciones no coinciden.

Dos valores distintos, userstory y task, cubren la cara de entrega del tablero. Marca los dos en el mismo trigger cuando un flujo sigue toda la cadena, o sepáralos en dos flujos cuando las reacciones no coinciden.

Casos de uso

una historia que se mueve sirve de señal para refrescar una página de estado dirigida al cliente. Una tarea que se mueve sirve para recalcular lo que queda del sprint, con task.getAll filtrado por milestone.

Cuándo usarlo

para señales de avance más que para alertas. Estos dos valores llevan el pulso diario de un equipo, así que alimentan bien paneles, resúmenes y traspasos de turno. Un detalle: el trigger avisa de que hubo un evento sobre ese tipo de objeto; cuando el flujo necesita los valores actuales, una operación Get justo después del trigger es la forma fiable de conseguirlos.

04Milestone (Sprint) eventsEl valor milestone salta a nivel de sprint. En Taiga el milestone es el contenedor del sprint, de modo que este evento marca el principio y el final de una iteración, no el desplazamiento de una tarjeta suelta.

El valor milestone salta a nivel de sprint. En Taiga el milestone es el contenedor del sprint, de modo que este evento marca el principio y el final de una iteración, no el desplazamiento de una tarjeta suelta.

Casos de uso

cuando un sprint cambia, un flujo recupera las historias asociadas con userStory.getAll y el filtro de milestone, y redacta el resumen de sprint que nadie disfruta escribiendo a mano.

Cuándo usarlo

para los rituales. Revisión de sprint, preparación de la retrospectiva, nota de capacidad para el cliente. El volumen es bajo comparado con issues o tareas, lo que lo convierte en buen candidato para flujos que terminan en un documento o un mensaje largo, porque no vas a saturar a nadie. Un mismo trigger puede llevarlo junto a otros valores si un solo flujo gestiona varios ritmos.

05Wikipage and All eventsDos valores cierran la lista. wikipage reacciona a la parte wiki de un proyecto de Taiga, las páginas donde se escriben especificaciones y decisiones. all es el cajón de sastre: márcalo y el trigger acepta todos los tipos de evento en lugar de un subconjunto elegido.

Dos valores cierran la lista. wikipage reacciona a la parte wiki de un proyecto de Taiga, las páginas donde se escriben especificaciones y decisiones. all es el cajón de sastre: márcalo y el trigger acepta todos los tipos de evento en lugar de un subconjunto elegido.

Casos de uso

un cambio en el wiki lanza un aviso a quienes dependen de esa página. Con all, un único flujo lo recoge todo y un nodo Switch clasifica por tipo, lo que mantiene el lienzo pequeño cuando varias reacciones comparten los mismos pasos previos.

Cuándo usarlo

elige wikipage cuando el problema a resolver sea documentación que se queda vieja. Elige all cuando ibas a montar cuatro flujos casi idénticos. Aquí no se escribe ningún comodín: el valor all es la manera de escucharlo todo.

Acciones

¿Qué sabe hacer el nodo Taiga ?

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

Matriz recursos × operaciones
Recurso	Create	Get	Get Many	Update	Delete
Epic	✓	✓	✓	✓	✓
Issue	✓	✓	✓	✓	✓
Task	✓	✓	✓	✓	✓
User Story	✓	✓	✓	✓	✓

Epic

5 operaciones

01

Create an epic

epic.create

Lo que ves en n8n

Notas y casos de uso

Esta operación abre un epic en un proyecto de Taiga y devuelve el epic creado, identificador incluido, listo para los nodos siguientes.

Parámetros clave

Project Name or ID: el proyecto al que pertenece el epic, elegido de la lista o pasado como identificador con una expresión del tipo {{ $json.projectId }}.
Subject: el título del epic, el único otro campo obligatorio.
Color: dentro de Additional Fields, un código de color en notación hexadecimal, cómodo cuando cada área de producto tiene su tono en el tablero.

Casos de uso

una hoja de planificación trimestral se lee fila a fila y cada línea se convierte en un epic, etiquetado con Tag Names or IDs para que el tablero nazca ordenado.

02

Delete an epic

epic.delete

Lo que ves en n8n

Notas y casos de uso

Borrar un epic pide un solo valor y, una vez pasada la llamada, Taiga ya no guarda ese epic.

Parámetros clave

Epic ID: el identificador del epic a borrar, casi siempre arrastrado desde un nodo anterior con {{ $json.id }} en lugar de escrito a mano.

Casos de uso

un flujo que crea epics desde un backlog externo necesita su rama de limpieza. Cuando la ficha de origen se anula, la misma ejecución borra el epic que había abierto y el tablero no se llena de cáscaras vacías.

03

Get an epic

epic.get

Lo que ves en n8n

Notas y casos de uso

Leer un epic devuelve su estado actual tal y como Taiga lo guarda, que es justo lo que un nodo IF necesita antes de decidir nada.

Parámetros clave

Epic ID: el identificador del epic a recuperar. El nodo devuelve solo ese, así que esta es la llamada de una consulta puntual y no de un barrido.

Casos de uso

antes de que salga un avance hacia el cliente, el flujo recupera el epic y comprueba si sigue bloqueado. Anunciar progreso sobre trabajo parado se nota, y la comprobación cuesta un nodo.

04

Get many epics

epic.getAll

Lo que ves en n8n

Notas y casos de uso

Una llamada trae los epics de un proyecto, un elemento de n8n por epic, listos para recorrer en bucle.

Parámetros clave

Project Name or ID: obligatorio, delimita toda la llamada a un proyecto.
Return All: encendido, n8n recorre todas las páginas de epics; apagado, Limit fija el número máximo de epics devueltos.
Is Closed: dentro de Filters, mantiene o descarta los epics cerrados.

Casos de uso

una exportación mensual de la hoja de ruta corre con Return All encendido e Is Closed apagado, para que el archivo enseñe solo lo que sigue vivo.

05

Update an epic

epic.update

Lo que ves en n8n

Notas y casos de uso

Un epic cambia según avanza el trimestre. Esta operación reescribe los campos que rellenas y deja el resto como estaba.

Parámetros clave

Epic ID: el identificador del epic a actualizar.
Is Blocked: dentro de Update Fields, el interruptor que marca el epic como bloqueado.
Blocked Note: el motivo del bloqueo. Necesita el interruptor Is Blocked activado para significar algo, así que se ponen los dos juntos.

Casos de uso

una dependencia se retrasa aguas arriba y el flujo marca el epic con el motivo escrito, de modo que la reunión diaria parte del tablero y no de la memoria de nadie.

Issue

5 operaciones

06

Create an issue

issue.create

Lo que ves en n8n

Notas y casos de uso

Las issues son la cara de fallos e incidencias de Taiga. Esta operación deposita una en un proyecto y devuelve la issue creada.

Parámetros clave

Project Name or ID y Subject: los dos campos obligatorios, el proyecto de destino y el título de la issue.
Priority Name or ID, Severity Name or ID y Type Name or ID: dentro de Additional Fields, los tres calificadores con los que un flujo de clasificación da forma a la issue desde el primer momento.

Casos de uso

un aviso entrante se clasifica antes de llegar, y la severidad que le corresponde se escribe directamente en la issue en vez de corregirse más tarde.

07

Delete an issue

issue.delete

Lo que ves en n8n

Notas y casos de uso

A veces un flujo tiene que deshacer su propio trabajo, y esta operación borra una issue del proyecto.

Parámetros clave

Issue ID: el identificador de la issue a borrar. Aliméntalo desde el nodo que encontró la issue, para que el borrado apunte a la ficha que de verdad se revisó.

Casos de uso

un paso de deduplicación compara un aviso nuevo con la cola abierta. Cuando dos entradas describen el mismo fallo, se va la más reciente y la original conserva su historial, sus comentarios y la persona asignada.

08

Get an issue

issue.get

Lo que ves en n8n

Notas y casos de uso

Cuando un flujo necesita el estado real de una issue, esta es la llamada. Devuelve la issue tal como está ahora, no como estaba cuando saltó un evento.

Parámetros clave

Issue ID: el identificador de la issue a recuperar, a menudo sacado de los datos que envía el trigger.

Casos de uso

un aviso que solo dice que una issue se movió no sirve de mucho. Colocar esta operación justo después del trigger permite que el mensaje lleve el asunto, el estado y la persona a cargo, que es lo que busca quien lo lee.

09

Get many issues

issue.getAll

Lo que ves en n8n

Notas y casos de uso

Un proyecto acumula issues deprisa, así que esta operación llega con el juego de filtros más amplio de los cuatro listados.

Parámetros clave

Project Name or ID: obligatorio, es el alcance de la consulta.
Order By: dentro de Filters, ordena el resultado, por ejemplo por created_date o por severity.
Return All: encendido para una exportación completa, apagado para parar en Limit.

Casos de uso

la lista de clasificación de la mañana trae las issues abiertas ordenadas por created_date, para que el aviso más antiguo sin tocar sea lo primero que lea el equipo.

10

Update an issue

issue.update

Lo que ves en n8n

Notas y casos de uso

Todo puede moverse en una issue después de abrirla, y aquí es donde se aplican esos cambios.

Parámetros clave

Issue ID: el identificador de la issue a actualizar, único campo obligatorio.
Status Name or ID: dentro de Update Fields, el nuevo estado de la issue.
Milestone (Sprint) Name or ID: el milestone al que pertenece la issue, que es como un flujo arrastra un fallo al sprint en curso.

Casos de uso

un cliente confirma que el arreglo funciona, y la issue se cierra y entra en el sprint actual en la misma ejecución, sin volver a abrir el tablero.

Task

5 operaciones

11

Create a task

task.create

Lo que ves en n8n

Notas y casos de uso

Las tareas viven debajo de una historia de usuario en Taiga. Esta operación añade una a un proyecto y la devuelve.

Parámetros clave

Project Name or ID y Subject: obligatorios, el proyecto y el título de la tarea.
User Story Name or ID: dentro de Additional Fields, la historia de la que cuelga la tarea, que es lo que mantiene legible el taskboard.
Taskboard Order: la posición de la tarea en el taskboard.

Casos de uso

una lista de comprobación recurrente se despliega en tareas bajo la historia que carga el trabajo, cada una colocada en el orden en que el equipo la ejecuta.

12

Delete a task

task.delete

Lo que ves en n8n

Notas y casos de uso

Sacar una tarea del tablero depende de un único campo, y la acción es definitiva del lado de Taiga.

Parámetros clave

Task ID: el identificador de la tarea a borrar. Pásalo antes por un filtro, porque no llega ninguna confirmación una vez que el nodo se ejecuta.

Casos de uso

una lista de comprobación generada de forma automática resulta no aplicar, el alcance cambia, y el flujo retira las tareas que había creado en el mismo lote para que la historia conserve solo el trabajo que sigue siendo real.

13

Get a task

task.get

Lo que ves en n8n

Notas y casos de uso

Traer una tarea de vuelta al flujo devuelve todos los campos que Taiga guarda sobre ella, en un solo elemento.

Parámetros clave

Task ID: el identificador de la tarea a recuperar.

Casos de uso

un control de horas recibe una referencia de tarea desde otra herramienta y le falta el asunto y el estado antes de escribir nada. Esta operación resuelve la referencia, y la fila que se guarda se lee como una frase en lugar de como un número.

14

Get many tasks

task.getAll

Lo que ves en n8n

Notas y casos de uso

Las listas de tareas se alargan, así que este listado trae sus propios filtros, orientados al taskboard más que al backlog.

Parámetros clave

Project Name or ID: obligatorio.
User Story Name or ID: dentro de Filters, reduce el resultado a las tareas de una sola historia.
Is Closed: conserva o descarta las tareas ya terminadas.
Return All: encendido para recorrer la lista entera, apagado para parar en Limit.

Casos de uso

un recuento diario de tareas abiertas por historia alimenta un burn-down sencillo sin tocar ninguna hoja de cálculo.

15

Update a task

task.update

Lo que ves en n8n

Notas y casos de uso

Hacer avanzar una tarea, o moverla de sitio, pasa por esta operación. Solo se escriben los campos que rellenas.

Parámetros clave

Task ID: el identificador de la tarea a actualizar.
Status Name or ID: dentro de Update Fields, el nuevo estado de la tarea.
User Story Order: la posición de la tarea dentro de su historia de usuario, útil cuando la secuencia importa más que el estado.

Casos de uso

alguien cierra una tarea desde un comando de chat, y el flujo devuelve el estado a Taiga para que el tablero coincida con la realidad antes de la reunión diaria.

User Story

5 operaciones

16

Create a user story

userStory.create

Lo que ves en n8n

Notas y casos de uso

Las historias de usuario cargan el trabajo en Taiga. Esta operación añade una a un proyecto y devuelve la historia creada.

Parámetros clave

Project Name or ID y Subject: los dos campos obligatorios.
Backlog Order: dentro de Additional Fields, la posición de la historia en el backlog, para que una recién llegada aterrice arriba y no al final.
Milestone (Sprint) Name or ID: el sprint al que pertenece la historia, cuando ya está planificada.

Casos de uso

las notas de una entrevista de descubrimiento se convierten en historias, ordenadas según la prioridad que se acordó durante la conversación.

17

Delete a user story

userStory.delete

Lo que ves en n8n

Notas y casos de uso

Hay historias que nunca deberían haber existido. Esta operación retira una del proyecto de forma definitiva.

Parámetros clave

User Story ID: el identificador de la historia a borrar, que el nodo espera como identificador y no como el título que se ve en el tablero.

Casos de uso

un flujo en pruebas ha escrito una docena de historias en un proyecto real. Una ejecución de limpieza relee los identificadores registrados durante la prueba y los borra uno a uno, dejando el backlog como estaba.

18

Get a user story

userStory.get

Lo que ves en n8n

Notas y casos de uso

Una historia, recuperada por su identificador, vuelve con los campos que Taiga conserva sobre ella, incluidos su estado y sus valores de orden.

Parámetros clave

User Story ID: el identificador de la historia a recuperar.

Casos de uso

una nota de versión se redacta a partir de una lista de referencias entregadas. Para cada una, esta operación aporta el asunto y la descripción, de modo que la nota sale del tablero y no del recuerdo aproximado que queda de un sprint.

19

Get many user stories

userStory.getAll

Lo que ves en n8n

Notas y casos de uso

Los listados de historias son donde suele empezar el reporte, y aquí los filtros siguen la forma en que se organiza un backlog.

Parámetros clave

Project Name or ID: obligatorio.
Epic Name or ID: dentro de Filters, devuelve solo las historias asociadas a un epic.
Is Archived: conserva o descarta las historias archivadas.
Return All: encendido para el backlog completo, apagado para parar en Limit.

Casos de uso

un informe de avance por epic cuenta las historias de ese epic por estado, sin las archivadas, y manda la proporción al responsable de producto.

20

Update a user story

userStory.update

Lo que ves en n8n

Notas y casos de uso

Reescribir una historia después de crearla es para lo que sirve esta operación, tanto si el cambio es de estado como de posición.

Parámetros clave

User Story ID: el identificador de la historia a actualizar.
Status Name or ID: dentro de Update Fields, el nuevo estado.
Kanban Order y Sprint Order: la posición de la historia en el kanban y en el milestone, los dos valores que deciden dónde aparece.

Casos de uso

llega una validación de fuera del equipo, y la historia pasa a la columna siguiente en el puesto correcto.

Necesitas ayuda

¿Necesitas ayuda para automatizar Taiga con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Taiga y n8n, las dudas que vienen después

01¿La integración Taiga n8n es gratis?

Sí, por el lado de n8n. El nodo Taiga y el Taiga Trigger vienen incluidos con n8n, así que no hay nada que instalar ni nada extra que pagar, trabajes en n8n Cloud o en una instancia alojada por ti en Community Edition con licencia Sustainable Use. Un flujo se comporta igual en los dos casos. Lo que sí hace falta es una cuenta de Taiga, porque el credential se autentica como un usuario real de esa cuenta. Lo que cueste Taiga en sí queda fuera de esta página.

02¿Qué credentials necesita el nodo de Taiga?

Basic auth, nada más complicado. El credential pide un Username, que acepta el nombre de usuario o el correo de la cuenta, y un Password. También pide un Environment, Cloud o Self-Hosted, y al elegir Self-Hosted aparece un campo URL para la dirección de tu propia instancia. Un solo credential sirve para el nodo Taiga y para el Taiga Trigger, y una vez guardado en el menú Credentials se muestra en el desplegable de todos los flujos que lo necesiten.

03¿Qué límites tiene el nodo de Taiga en n8n?

Dos importan en la práctica. La paginación: en las cuatro operaciones Get Many, epics, issues, tareas e historias de usuario, Return All es lo que hace que n8n recorra todas las páginas, y con él apagado el valor de Limit pone techo al resultado. La cobertura: el nodo expone 20 operaciones sobre 4 recursos, y todo lo que la API de Taiga ofrezca más allá de esa lista se alcanza con el nodo HTTP Request, que reutiliza el mismo credential de Taiga con la autenticación predefinida. Un endpoint que falte cuesta un nodo más, no un acceso aparte.

04¿El Taiga Trigger reacciona en tiempo real?

Sí. El Taiga Trigger funciona por webhook: n8n registra una URL a la que Taiga llama cuando pasa algo, y el evento llega a tu flujo en cuestión de segundos. No hay polling ni intervalo que configurar. El webhook se registra al activar el flujo, de modo que un flujo dejado inactivo no recibe nada. Lo que llega se elige en el parámetro Operations, que ofrece 6 valores, y no hay ningún comodín que escribir: selecciona el valor all para recibir todos los tipos de evento.

05¿n8n o Make para Taiga?

Depende de cuatro criterios, y el precio no es el primero. El alojamiento: n8n corre en tu propio servidor con Docker o npm, o en n8n Cloud, mientras que Make existe solo alojado. El control de los datos va detrás, porque una instancia propia mantiene los datos de Taiga dentro de tu infraestructura. El modelo de coste: Make factura por operación, lo que cambia la forma de diseñar un flujo que recorre un backlog largo. Y la lógica visual, donde las dos herramientas no se parecen. Monta el mismo flujo pequeño de Taiga en ambas y la respuesta se ve rápido.

Crear el credential de Taiga

Elegir el entorno correcto

Seleccionar el credential en el nodo

Todos los eventos, por familia

Notas de configuración

¿Necesitas ayuda para automatizar Taiga con n8n?