Introducción

En flujos de automatización reales, los datos rara vez fluyen en una sola línea recta. Puedes obtener registros de clientes desde un CRM en una rama, extraer sus pedidos recientes desde una API en otra rama, y luego necesitar juntar esos dos flujos en objetos unificados antes de pasarlos a los nodos siguientes. Eso es exactamente lo que gestiona el nodo Merge.

El nodo Merge acepta dos ramas de entrada separadas — denominadas Input 1 e Input 2 — y combina sus items según una estrategia que tú elijas. Elegir mal el modo de fusión es una de las fuentes más comunes de bugs silenciosos de datos en n8n, donde los items parecen combinarse pero el resultado no es el esperado. Comprender desde el principio la diferencia entre los modos ahorra mucho tiempo de depuración.

Los cuatro modos de Merge

El nodo Merge de n8n ofrece cuatro modos: Append, Combine by Position, Combine by Key y Multiplex. Cada uno responde a una pregunta diferente sobre cómo deben relacionarse los items de las dos ramas.

Append simplemente concatena ambas listas. Cada item de Input 1 va primero, luego cada item de Input 2. No se produce ningún emparejamiento. Úsalo cuando quieras una lista plana única y las dos ramas sean independientes — por ejemplo, fusionar dos listas separadas de direcciones de correo para enviar una sola campaña.

Combine by Position (anteriormente llamado Merge by Index) empareja los items por su orden en la lista. El Item 0 de Input 1 se fusiona con el Item 0 de Input 2, el Item 1 con el Item 1, y así sucesivamente. Los campos de ambos items se fusionan en un solo objeto. Si las listas tienen longitudes desiguales, por defecto la lista más corta determina la cantidad de salida.

Combine by Key empareja los items de las dos ramas usando el valor de un campo compartido — similar a un SQL JOIN sobre una columna. Especificas un campo clave en cada entrada (pueden tener nombres de campo diferentes), y n8n encuentra los pares donde los valores coinciden.

Multiplex produce todas las combinaciones posibles de items de Input 1 e Input 2 — un producto cartesiano. Si Input 1 tiene 3 items e Input 2 tiene 4 items, Multiplex genera 12 items. Rara vez es lo que deseas, pero es útil para generar combinaciones como emparejar cada producto con cada nivel de descuento.

Ejemplo práctico: Combine by Key

Supón que tu nodo HTTP Request devuelve perfiles de clientes en una rama:

[
  { "customerId": "C001", "name": "Alice" },
  { "customerId": "C002", "name": "Bob" }
]

Y un segundo HTTP Request devuelve totales de pedidos en otra rama:

[
  { "id": "C002", "totalSpent": 340 },
  { "id": "C001", "totalSpent": 120 }
]

Los items están en órdenes diferentes y usan nombres de campo distintos para el mismo identificador de cliente. En el nodo Merge configurado como Combine by Key, defines Input 1 Key Field como customerId e Input 2 Key Field como id. n8n emparejará C001 con C001 y C002 con C002 independientemente del orden, produciendo:

[
  { "customerId": "C001", "name": "Alice", "id": "C001", "totalSpent": 120 },
  { "customerId": "C002", "name": "Bob", "id": "C002", "totalSpent": 340 }
]

Por defecto, los items de Input 1 que no tengan coincidencia en Input 2 se descartan. Puedes cambiar este comportamiento en la opción Output Type, eligiendo conservar los items sin coincidencia de Input 1, de Input 2, o de ambos — equivalente a un LEFT, RIGHT o FULL OUTER JOIN en SQL.

Ejemplo de Combine by Position

Combine by Position es la elección correcta cuando sabes que ambas ramas producirán siempre el mismo número de items en el mismo orden. Un caso típico es dividir una lista, enriquecer cada item a través de dos APIs diferentes en paralelo y luego recombinar los resultados enriquecidos.

[
  { "userId": 1, "email": "alice@example.com" }
]

Si Input 1 contiene el registro base del usuario e Input 2 contiene un puntaje de un servicio de scoring:

[
  { "score": 87 }
]

Combine by Position fusiona estos por índice en:

[
  { "userId": 1, "email": "alice@example.com", "score": 87 }
]

Si ejecutaras esto sobre una lista de 50 usuarios repartidos entre ambas ramas, los 50 items se fusionan correctamente siempre que se preserve el orden — lo cual suele ocurrir cuando ambas ramas parten del mismo nodo Split In Batches o SplitOut.

Errores comunes

El error más frecuente es usar Combine by Position cuando las dos ramas procesan items a distinta velocidad o aplican filtrado, lo que hace que las listas se desincronicen. La fusión emparejará silenciosamente los items equivocados. Si existe la posibilidad de que el orden difiera, usa Combine by Key en su lugar.

Otro problema es activar el nodo Merge antes de que ambas ramas hayan terminado de ejecutarse. En n8n, el nodo Merge espera automáticamente a que ambas entradas lleguen antes de procesar, pero esto solo funciona correctamente cuando ambas ramas se originan en el mismo nodo upstream. Si conectas rutas de trigger no relacionadas a un nodo Merge esperando sincronización, el comportamiento es indefinido y a menudo produce ejecuciones duplicadas.

Por último, ten cuidado con las colisiones de nombres de campo. Cuando dos items comparten un nombre de campo y los combinas, el valor de Input 2 sobrescribe al de Input 1 por defecto. Renombra los campos en conflicto aguas arriba con un nodo Set antes de fusionar si necesitas conservar ambos valores.

Resumen

El nodo Merge es la columna vertebral de los flujos multibranch en n8n. Append apila listas, Combine by Position empareja items por orden, Combine by Key une items por el valor de un campo compartido, y Multiplex genera todas las combinaciones. La decisión clave siempre es si tus dos flujos de datos tienen una relación estructural — si la tienen, usa Combine by Key por su fiabilidad; si tienen garantizado estar ordenados y tener la misma longitud, Combine by Position es más simple. Elegir correctamente evita toda una clase de bugs sutiles de integridad de datos.