Node Merge no n8n: juntando dados de caminhos diferentes
Como usar o Merge no n8n para juntar dados de caminhos diferentes: append, manter só o novo, ou só o que coincide entre os dois conjuntos.
Resumo por IA
Resumo gerado por IA, revisado pela redação.
O node Merge junta dados que vieram de caminhos diferentes do fluxo — depois que ele se dividiu num IF ou Switch, ou quando dois nodes distintos processaram a mesma informação separadamente e você precisa reunir o resultado num único conjunto de dados.
Adicione ao Google NotíciasOs cenários em que o Merge entra
1. Juntar streams que se separaram
Se o fluxo se dividiu num IF ou Switch e, mais adiante, você precisa reunir os caminhos de volta num só, o Merge combina os dois de volta — anexando um conjunto ao outro, mantendo só os itens novos, ou só os que já existiam, dependendo da operação escolhida.
2. Combinar dados de dois nodes diferentes
Mesmo sem o fluxo ter se dividido, dá para usar o Merge para juntar a saída de dois nodes anteriores distintos num único conjunto — útil quando você buscou informação de duas fontes diferentes e precisa cruzá-las.
3. Combinar múltiplas execuções (com Code)
Para cenários mais complexos — juntar resultado de várias voltas de um loop, por exemplo —, o Merge simples não basta; a documentação recomenda o node Code para esse tipo de combinação mais elaborada.
As formas de combinar
| Operação | O que faz |
|---|---|
| Append | Junta os dois conjuntos, um atrás do outro |
| Keep only new | Mantém só os itens que não existiam antes |
| Keep only existing | Mantém só os itens que já existiam nos dois |
Antes de escolher a operação, pense no resultado que você espera ver: quer tudo junto (Append), quer só o que é novo em relação ao outro conjunto, ou quer só o que coincide entre os dois? A resposta a essa pergunta decide qual operação usar.
Um cuidado com a ordem de chegada
O Merge espera receber dados das duas entradas antes de continuar. Se um dos caminhos nunca chegar — por exemplo, porque um IF anterior descartou todos os itens daquele lado —, o fluxo pode ficar esperando indefinidamente. Vale considerar esse caso ao desenhar o fluxo.
Use Merge para juntar streams divididos ou combinar dois nodes distintos. Para combinar múltiplas execuções de um loop, o Code node é o caminho recomendado.
Perguntas frequentes
Para que serve o node Merge no n8n?
Para juntar dados que vieram de caminhos diferentes do fluxo — depois de uma divisão por IF ou Switch, ou combinando a saída de dois nodes distintos num único conjunto de dados.
Qual a diferença entre Append e Keep only new no Merge?
Append junta os dois conjuntos completos, um atrás do outro. Keep only new mantém apenas os itens que não existiam no outro conjunto — útil para identificar o que é realmente novo entre duas listas.
O Merge serve para juntar dados de várias voltas de um loop?
Não é o caso de uso principal dele. Para combinar dados de múltiplas execuções, como as voltas de um loop, a documentação recomenda usar o node Code, mais flexível para esse cenário.
Este tutorial faz parte do guia Curso de n8n do zero ao avançado: o guia completo em português. Veja também: Node, trigger e workflow: o vocabulário do n8n em 10 minutos · A estrutura de dados do n8n: por que tudo é um array com json · Item linking no n8n: como ele decide qual item vai pra saída · Execuções passo a passo: como achar onde o fluxo do n8n quebrou · A Canvas UI do n8n 2.0: o que mudou e como se orientar · n8n Cloud ou self-hosted: a decisão que define seu custo e sua liberdade
