Introducción
En flujos de n8n reales rara vez tienes una única línea de ejecución recta. Más a menudo, bifurcas el flujo: una rama consulta tu CRM, otra obtiene analíticas, una tercera espera un webhook de un cliente. En algún momento necesitas volver a unir esas ramas paralelas, y eso es precisamente para lo que sirve el nodo Merge. Entender cómo combinar las ramas correctamente previene la pérdida de datos, el procesamiento duplicado y errores silenciosos que solo aparecen en producción.
Esta lección cubre las tres estrategias principales de fusión en n8n: esperar a que lleguen todas las entradas, fusionar por una clave coincidente (join estilo SQL) y anexar (concatenar) todos los ítems entrantes. Cada estrategia sirve para un propósito distinto, y elegir la incorrecta es uno de los errores más comunes al construir automatizaciones no triviales.
Cómo funciona el Nodo Merge
El nodo Merge toma múltiples flujos de entrada (Entrada 1, Entrada 2, y opcionalmente más) y produce un único flujo de salida. Se ejecuta solo cuando cada entrada conectada ha entregado al menos un ítem, lo que significa que sincroniza implícitamente las ramas. Este es el comportamiento de "espera": no importa cuán rápido termine una rama, el nodo Merge se detiene hasta que llega la rama más lenta.
También puedes añadir un timeout en la configuración del nodo. Si una rama nunca se completa, la fusión dejará de esperar eventualmente y ya sea descartar los datos o continuar con lo que haya llegado. Esto importa para flujos de trabajo de larga duración donde una API externa podría quedarse colgada.
Merge by Key (Comportamiento de Unión)
Este es el equivalente más cercano a un SQL JOIN. Eliges un campo (p. ej. `email` o `orderId`) que exista en ambas corrientes de entrada, y el nodo empareja ítems que comparten el mismo valor. Los ítems sin coincidencia se eliminan por defecto, pero puedes configurar el modo para comportarse como un LEFT JOIN (conservar ítems no coincidentes de Entrada 1) o como un outer join.
El resultado es un ítem por coincidencia, con campos de ambas entradas combinados. Las opciones del menú desplegable son:
Append: concatena todos los ítems de ambas entradas en una lista plana, en ese orden, sin emparejar. Usa esto cuando las ramas producen registros independientes que deben procesarse juntos más tarde (por ejemplo, todos los contactos de Mailchimp y todos los contactos de HubSpot encolados para un solo paso de deduplicación).
Merge By Key: empareja ítems mediante un campo compartido, como un join de base de datos. Usa esto cuando cada ítem de un lado se relaciona lógicamente con un ítem del otro lado, como emparejar un registro de pedido con su registro de pago correspondiente.
Wait: el modo más sencillo — no realiza transformación alguna, solo sincroniza el tiempo. Los ítems de salida siguen el orden de Input 1, y los ítems de Input 2 se adjuntan uno a uno por posición. Usa esto solo cuando controles ambas ramas y sepas que el orden coincide.
El menú Mode tiene estas cuatro opciones: Append, Merge By Key, Merge By Position y Wait. Nota que "Merge By Position" es el nombre técnico del comportamiento simple de esperar y emparejar — empareja ítems por su índice en la matriz de entrada, lo cual solo funciona correctamente cuando ambas ramas tienen la misma cantidad de ítems en el mismo orden.
Ejemplo práctico: Combinando datos de Pedidos y Pagos
Imagina que la Rama 1 obtiene pedidos de una base de datos, y la Rama 2 obtiene el estado de pago de Stripe. Cada rama produce ítems con un campo `orderId`. Quieres un único registro combinado por pedido.
Con `joinMode` configurado a `inner`, solo los pedidos que existen en ambas ramas terminan en la salida. Si cambias a `left`, los pedidos que aún no tienen un registro de pago siguen fluyendo, marcados como no emparejados — útil para detectar pagos faltantes.
Errores comunes y trampas
El error más frecuente es usar "Merge By Position" cuando las dos ramas producen un número diferente de ítems. Si la Rama 1 devuelve 10 pedidos y la Rama 2 devuelve solo 7 registros de pago, 3 de los ítems de pedido se emparejarán con datos de pago nulos o serán eliminados silenciosamente según la configuración. Usa siempre "Merge By Key" cuando las cuentas pueden diferir.
Otra trampa: el nodo Merge no deduplica. Si la Rama 1 tiene el mismo correo dos veces y la Rama 2 una, puedes obtener filas combinadas duplicadas. La deduplicación debe ocurrir antes de la fusión, o con un nodo separado después.
Finalmente, recuerda que Merge espera a todas las entradas conectadas. Si olvides conectar una entrada, el nodo esperará indefinidamente (o hasta el timeout). Las entradas no conectadas son una causa común de flujos de trabajo que se quedan esperando en producción.
Resumen
El nodo de Merge es el punto de sincronización de cualquier flujo de trabajo con múltiples ramas. Use Append cuando solo desea apilar listas independientes, Merge By Key cuando los elementos de cada lado se relacionan por un identificador compartido, y Wait / Merge By Position solo cuando ambas ramas producen matrices coincidentes de la misma longitud. Verifique siempre que cada entrada esté conectada, elija un modo de unión que coincida con sus necesidades de integridad de datos y coloque la desduplicación fuera de la fusión para evitar sorpresas.
Punto de control de la lección
Repasa lo aprendido y recibe comentarios sobre tu trabajo.