{"id":50038,"date":"2026-04-17T07:37:43","date_gmt":"2026-04-17T10:37:43","guid":{"rendered":"https:\/\/www.hostinger.com\/pt\/tutoriais\/n8n-loop-over-items\/"},"modified":"2026-04-17T07:54:58","modified_gmt":"2026-04-17T10:54:58","slug":"n8n-loop-over-items","status":"publish","type":"post","link":"\/pt\/tutoriais\/n8n-loop-over-items","title":{"rendered":"n8n Loop Over Items: o que \u00e9 e como funciona"},"content":{"rendered":"
O Loop Over Items do n8n é um componente que permite iterar e processar dados em lote. Ele ajuda a lidar com grandes conjuntos de dados, como endereços de e-mail, respostas de API ou registros de banco de dados.<\/p>
Para implementar loops no seu worflow n8n, há alguns pontos-chave que você precisa entender sobre esse recurso:<\/p>
\n
Definição e benefícios do looping<\/strong>. A repetição é um processo de execução de operações específicas para um grupo de dados, o que é útil quando seu workflow envolve serviços de terceiros com políticas de limite de taxa.<\/li>\n\n\n\n
Como funciona o node Loop Over Items<\/strong>. No n8n, o Loop Over Items pega os dados de outro node, divide-os em lotes, passa-os para processamento e repete essas etapas até o último item de dados.<\/li>\n\n\n\n
Passos para criar um loop<\/strong>. Criar um loop no n8n envolve inserir o node Loop Over Items<\/strong> após a fonte de dados, conectar o pipeline de processamento e fazer o loop do workflow de volta para o node Loop Over Items<\/strong>.<\/li>\n\n\n\n
Exemplos práticos de loop no n8n<\/strong>. Alguns dos muitos casos de uso para loops no n8n incluem o envio de e-mails em massa e o gerenciamento de feeds RSS.<\/li>\n<\/ul>
\n\n\n\n<\/p>
O que significa looping no n8n?<\/strong> <\/h2>
Looping em n8n refere-se a repetir um conjunto de ações para cada item em uma lista ou array (matriz) dentro de um workflow<\/strong>. Isso permite automatizar tarefas para cada item em um conjunto de dados sem intervenção manual.<\/p>
Por exemplo, se você tiver uma lista de 100 contatos e quiser enviar um e-mail para cada um, o looping permite que o n8n processe cada contato sequencialmente em vez de enviar e-mails em massa para todos de uma vez.<\/p>
Repetir é necessário quando você precisa de controle específico sobre a ordem das operações, ou quando lidar com muitos itens simultaneamente poderia sobrecarregar seu sistema ou APIs externas. Você pode configurá-lo no n8n usando o node Loop Over Items<\/strong>.<\/p>
Como funciona o node Loop Over Items no n8n?<\/strong><\/h2>
O funcionamento do Loop Over Items (Split in Batches)<\/strong> consiste em separar uma lista de itens em pequenos grupos (batches) e processar cada um deles individualmente. Entenda como o processo funciona passo a passo:<\/p>\n
Entrada. <\/strong>O node recebe uma array de itens de entrada.<\/li>\n\n\n\n
Divisão.<\/strong> Em seguida, ele divide o array em lotes com base no Batch Size<\/strong> (tamanho do lote<\/strong>) que você define.<\/li>\n\n\n\n
Ação.<\/strong> Cada lote passa para o próximo node conectado para realizar a ação desejada.<\/li>\n\n\n\n
Retorno.<\/strong> Após o processamento, o workflow retorna ao node Loop Over Items<\/strong>.<\/li>\n\n\n\n
Repetição.<\/strong> Esse ciclo continua automaticamente até que todos os lotes sejam processados.<\/li>\n<\/ol>
Ao definir um tamanho de lote, você controla quantos itens passam pelo seu workflow em cada iteração. Isso é semelhante a um loop for<\/strong> na programação, onde você executa uma ação específica um determinado número de vezes antes de continuar.<\/p>
O tamanho do lote é especialmente importante se você estiver buscando dados de uma API, pois garante que as solicitações sejam enviadas em grupos controlados e gerenciáveis, em vez de todas de uma vez, ajudando a evitar atingir o limite de taxa.<\/p>
Observe que, se você buscar dados de uma API ou outros dados paginados, deve adicionar uma lógica condicional – como um node If – para verificar se há mais páginas. Esta condição informa ao workflow quando parar, evitando que ele passe por páginas vazias.<\/p>
Quando você deve usar o node Loop Over Items?<\/strong><\/h2>
Você deve usar o node Loop Over Items quando precisar dividir os dados em partes menores e processar os itens um por um. Isso é especialmente útil para grandes conjuntos de dados, quando cada item requer uma ação individual, ou quando você deseja controlar o número de itens processados em cada iteração.<\/p>
O node Loop Over Items é útil se você quiser:<\/p>
\n
Enviar e-mails em lotes.<\/strong> Divida grandes listas de e-mails em grupos menores para evitar acionar filtros de spam ou atingir limites de envio.<\/li>\n\n\n\n
Fazer chamadas de API separadas.<\/strong> Processar as entradas em um conjunto de dados uma por uma, como atualizar registros de clientes, para respeitar os limites de taxa da API.<\/li>\n\n\n\n
Processar linhas de planilha.<\/strong> Garanta que cada linha de um banco de dados ou planilha seja tratada individualmente para validação ou formatação.<\/li>\n\n\n\n
Lidar com respostas de API paginadas.<\/strong> Recupere todos os dados disponíveis de uma API por meio de várias solicitações, verificando se há mais páginas após cada lote.<\/li>\n\n\n\n
Gerar documentos personalizados.<\/strong> Crie relatórios ou faturas individuais para cada cliente em uma lista.<\/li>\n<\/ol>
Em resumo, use o node Loop Over Item sempre que seu workflow precisar agir em cada registro individualmente ou respeitar limites de taxa.<\/p>
\n
Dica<\/h4>\n
O node Loop Over Items costuma ser usado para processar uma quantidade fixa de grupos, funcionando de forma parecida com o comando for na programação. Você o utiliza quando precisa repetir uma tarefa várias vezes antes de avançar para o próximo passo do fluxo.<\/p>\n <\/div>\n\n\n\n<\/p>
Como usar o Loop Over Items no n8n?<\/strong><\/h2>
Para utilizar no n8n, combine vários node para processar cada item individualmente em uma lista.<\/p>
O Loop Over Items é o node principal para isso, mas você o combinará com outros nodes, comoEdit Fields (Set)<\/strong><\/strong> para preparar dados, HTTP Request<\/strong><\/strong> para interagir com serviços externos, e If<\/strong> para adicionar lógica ou definir condições de parada.<\/p>
Aqui está um procedimento geral para iterar sobre itens no n8n:<\/p>
\n
Adicione o node que fornece uma fonte de dados, como Google Sheets<\/strong> ou Edit Fields (Set)<\/strong><\/strong><\/strong>.<\/li>\n\n\n\n
Conecte o node Loop Over Items<\/strong> à fonte de dados.<\/li>\n\n\n\n
Nas configurações do node Loop Over Items<\/strong>, defina o Batch Size<\/strong><\/strong>.<\/li>\n\n\n\n
Conecte a saída do node Loop Over Items<\/strong> ao node que executa a ação, como HTTP Request<\/strong><\/strong>.<\/li>\n\n\n\n
Conecte a saída do seu node de processamento de volta à entrada do node Loop Over Items<\/strong> para fechar o loop.<\/li>\n\n\n\n
Adicione a saída Done<\/strong><\/strong> a qualquer etapa final que deve ser executada somente após o processamento de todos os itens.<\/li>\n<\/ol>
Aqui está um exemplo de um workflow simples que percorre itens:<\/p>
![\"Um](\"\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/exemplo-simples-de-um-fluxo-de-trabalho-com-looping.png\")