{"id":54063,"date":"2026-04-17T07:20:14","date_gmt":"2026-04-17T10:20:14","guid":{"rendered":"\/br\/tutoriais\/?p=54063"},"modified":"2026-04-17T07:54:40","modified_gmt":"2026-04-17T10:54:40","slug":"n8n-loop-over-items","status":"publish","type":"post","link":"\/br\/tutoriais\/n8n-loop-over-items\/","title":{"rendered":"n8n Loop Over Items: o que \u00e9 e como funciona"},"content":{"rendered":"<p class=\"wp-block-paragraph\">O Loop Over Items do n8n &eacute; um componente que permite iterar e processar dados em lote. Ele ajuda a lidar com grandes conjuntos de dados, como endere&ccedil;os de e-mail, respostas de API ou registros de banco de dados.<\/p><p class=\"wp-block-paragraph\">Para implementar loops no seu worflow n8n, h&aacute; alguns pontos-chave que voc&ecirc; precisa entender sobre esse recurso:<\/p><ul class=\"wp-block-list\">\n<li><strong>Defini&ccedil;&atilde;o e benef&iacute;cios do looping<\/strong>. A repeti&ccedil;&atilde;o &eacute; um processo de execu&ccedil;&atilde;o de opera&ccedil;&otilde;es espec&iacute;ficas para um grupo de dados, o que &eacute; &uacute;til quando seu workflow envolve servi&ccedil;os de terceiros com pol&iacute;ticas de limite de taxa.<\/li>\n\n\n\n<li><strong>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&eacute; o &uacute;ltimo item de dados.<\/li>\n\n\n\n<li><strong>Passos para criar um loop<\/strong>. Criar um loop no n8n envolve inserir o node <strong>Loop Over Items<\/strong> ap&oacute;s a fonte de dados, conectar o pipeline de processamento e fazer o loop do workflow de volta para o node <strong>Loop Over Items<\/strong>.<\/li>\n\n\n\n<li><strong>Exemplos pr&aacute;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><p>\n\n\n\n\n\n\n<\/p><h2 class=\"wp-block-heading\" id=\"h-o-que-significa-looping-no-n8n\"><strong>O que significa looping no n8n?<\/strong> <\/h2><p class=\"wp-block-paragraph\">Looping em n8n refere-se a<strong> repetir um conjunto de a&ccedil;&otilde;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&ccedil;&atilde;o manual.<\/p><p class=\"wp-block-paragraph\">Por exemplo, se voc&ecirc; 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><p class=\"wp-block-paragraph\">Repetir &eacute; necess&aacute;rio quando voc&ecirc; precisa de controle espec&iacute;fico sobre a ordem das opera&ccedil;&otilde;es, ou quando lidar com muitos itens simultaneamente poderia sobrecarregar seu sistema ou APIs externas. Voc&ecirc; pode configur&aacute;-lo no n8n usando o node <strong>Loop Over Items<\/strong>.<\/p><h2 class=\"wp-block-heading\" id=\"h-como-funciona-o-node-loop-over-items-no-n8n\"><strong>Como funciona o node Loop Over Items no n8n?<\/strong><\/h2><p class=\"wp-block-paragraph\">O funcionamento do <strong>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><ol class=\"wp-block-list\">\n<li><strong>Entrada. <\/strong>O node recebe uma array de itens de entrada.<\/li>\n\n\n\n<li><strong>Divis&atilde;o.<\/strong> Em seguida, ele divide o array em lotes com base no <strong>Batch Size<\/strong> (<strong>tamanho do lote<\/strong>) que voc&ecirc; define.<\/li>\n\n\n\n<li><strong>A&ccedil;&atilde;o.<\/strong> Cada lote passa para o pr&oacute;ximo node conectado para realizar a a&ccedil;&atilde;o desejada.<\/li>\n\n\n\n<li><strong>Retorno.<\/strong> Ap&oacute;s o processamento, o workflow retorna ao node <strong>Loop Over Items<\/strong>.<\/li>\n\n\n\n<li><strong>Repeti&ccedil;&atilde;o.<\/strong> Esse ciclo continua automaticamente at&eacute; que todos os lotes sejam processados.<\/li>\n<\/ol><p class=\"wp-block-paragraph\">Ao definir um tamanho de lote, voc&ecirc; controla quantos itens passam pelo seu workflow em cada itera&ccedil;&atilde;o. Isso &eacute; semelhante a um<strong> loop for<\/strong> na programa&ccedil;&atilde;o, onde voc&ecirc; executa uma a&ccedil;&atilde;o espec&iacute;fica um determinado n&uacute;mero de vezes antes de continuar.<\/p><p class=\"wp-block-paragraph\">O tamanho do lote &eacute; especialmente importante se voc&ecirc; estiver buscando dados de uma API, pois garante que as solicita&ccedil;&otilde;es sejam enviadas em grupos controlados e gerenci&aacute;veis, em vez de todas de uma vez, ajudando a evitar atingir o limite de taxa.<\/p><p class=\"wp-block-paragraph\">Observe que, se voc&ecirc; buscar dados de uma API ou outros dados paginados, deve adicionar uma l&oacute;gica condicional &ndash; como um node If &ndash; para verificar se h&aacute; mais p&aacute;ginas. Esta condi&ccedil;&atilde;o informa ao workflow quando parar, evitando que ele passe por p&aacute;ginas vazias.<\/p><h2 class=\"wp-block-heading\" id=\"h-quando-voce-deve-usar-o-node-loop-over-items\"><strong>Quando voc&ecirc; deve usar o node Loop Over Items?<\/strong><\/h2><p class=\"wp-block-paragraph\">Voc&ecirc; deve usar o node Loop Over Items quando precisar dividir os dados em partes menores e processar os itens um por um. Isso &eacute; especialmente &uacute;til para grandes conjuntos de dados, quando cada item requer uma a&ccedil;&atilde;o individual, ou quando voc&ecirc; deseja controlar o n&uacute;mero de itens processados em cada itera&ccedil;&atilde;o.<\/p><p class=\"wp-block-paragraph\">O node Loop Over Items &eacute; &uacute;til se voc&ecirc; quiser:<\/p><ol class=\"wp-block-list\">\n<li><strong>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<li><strong>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<li><strong>Processar linhas de planilha.<\/strong> Garanta que cada linha de um banco de dados ou planilha seja tratada individualmente para valida&ccedil;&atilde;o ou formata&ccedil;&atilde;o.<\/li>\n\n\n\n<li><strong>Lidar com respostas de API paginadas.<\/strong> Recupere todos os dados dispon&iacute;veis de uma API por meio de v&aacute;rias solicita&ccedil;&otilde;es, verificando se h&aacute; mais p&aacute;ginas ap&oacute;s cada lote.<\/li>\n\n\n\n<li><strong>Gerar documentos personalizados.<\/strong> Crie relat&oacute;rios ou faturas individuais para cada cliente em uma lista.<\/li>\n<\/ol><p class=\"wp-block-paragraph\">Em resumo, use o node Loop Over Item sempre que seu workflow precisar agir em cada registro individualmente ou respeitar limites de taxa.<\/p><p>\n\n\n        <div class=\"protip\">\n            <div class=\"protip__heading\">\n                <svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\">\n                    <path d=\"M1.49234 23.5024C1.23229 23.5024 0.972242 23.4024 0.782206 23.2123C0.562165 22.9923 0.452144 22.6822 0.502153 22.3722C0.562165 21.9221 1.14227 17.9113 3.00262 16.351C3.63274 15.8209 4.43289 15.5509 5.26305 15.5609C6.09321 15.5909 6.87335 15.9109 7.47347 16.4911C8.6937 17.6913 8.76371 19.6717 7.6435 20.9919C6.0832 22.8523 2.08245 23.4324 1.63237 23.4924C1.59236 23.4924 1.54235 23.4924 1.50234 23.4924L1.49234 23.5024ZM5.16303 17.5613C4.84297 17.5613 4.53291 17.6713 4.29287 17.8813C3.60274 18.4614 3.07264 19.9317 2.75258 21.242C4.06282 20.9219 5.5331 20.3918 6.11321 19.7017C6.55329 19.1716 6.54329 18.3814 6.0832 17.9213C5.85316 17.7013 5.5431 17.5713 5.20304 17.5613C5.19304 17.5613 5.17303 17.5613 5.16303 17.5613ZM11.7243 21.8821C11.4942 21.8821 11.2642 21.8021 11.0841 21.652C10.8541 21.462 10.7241 21.1819 10.7241 20.8819V15.9109L8.08358 13.2705H3.11264C2.81259 13.2705 2.53254 13.1404 2.3425 12.9104C2.15246 12.6803 2.07245 12.3803 2.12246 12.0902C2.19247 11.7102 2.84259 8.36953 4.70294 7.12929C6.33325 6.04909 8.96375 6.49918 10.244 6.80923C11.5442 4.96889 13.2546 3.4286 15.2349 2.33839C17.4553 1.11816 19.9858 0.518051 22.4963 0.498047C23.0464 0.498047 23.4865 0.948132 23.4865 1.49824C23.4865 5.0389 22.3763 9.97983 17.1753 13.7605C17.4853 15.0408 17.9354 17.6613 16.8552 19.2816C15.615 21.1419 12.2744 21.7921 11.8943 21.8621C11.8343 21.8721 11.7743 21.8821 11.7143 21.8821H11.7243ZM12.7245 16.181V19.6016C13.7146 19.2916 14.7948 18.7915 15.2049 18.1814C15.675 17.4812 15.605 16.091 15.385 14.9008C14.5248 15.3808 13.6346 15.8109 12.7245 16.181ZM9.66388 12.0302L11.9643 14.3307C13.1845 13.8306 14.3648 13.2204 15.485 12.5103C19.9358 9.51974 21.2361 5.60901 21.4561 2.53843C19.6157 2.67846 17.8254 3.20856 16.2051 4.09872C14.2847 5.14892 12.6544 6.68921 11.4942 8.54956C10.7841 9.65977 10.174 10.82 9.66388 12.0302ZM4.39289 11.2701H7.81353C8.1936 10.3599 8.63368 9.46974 9.11377 8.60957C7.92355 8.38953 6.51329 8.31952 5.81315 8.78961C5.19304 9.19968 4.70294 10.3099 4.39289 11.2701Z\" fill=\"#673DE6\"\/>\n                <\/svg>\n                <p class=\"protip__title\">\n                    Dica                <\/p>\n            <\/div>\n            <p class=\"protip__content\">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&ccedil;&atilde;o. Voc&ecirc; o utiliza quando precisa repetir uma tarefa v&aacute;rias vezes antes de avan&ccedil;ar para o pr&oacute;ximo passo do fluxo.<\/p>\n                    <\/div>\n        \n\n\n\n<\/p><h2 class=\"wp-block-heading\" id=\"h-como-usar-o-loop-over-items-no-n8n\"><strong>Como usar o Loop Over Items no n8n?<\/strong><\/h2><p class=\"wp-block-paragraph\">Para utilizar no n8n, combine v&aacute;rios node para processar cada item individualmente em uma lista.<\/p><p class=\"wp-block-paragraph\">O Loop Over Items &eacute; o node principal para isso, mas voc&ecirc; o combinar&aacute; com outros nodes, como<strong> <strong>Edit Fields (Set)<\/strong><\/strong> para preparar dados, <strong><strong>HTTP Request<\/strong><\/strong> para interagir com servi&ccedil;os externos, e <strong>If<\/strong> para adicionar l&oacute;gica ou definir condi&ccedil;&otilde;es de parada.<\/p><p class=\"wp-block-paragraph\">Aqui est&aacute; um procedimento geral para iterar sobre itens no n8n:<\/p><ol class=\"wp-block-list\">\n<li>Adicione o node que fornece uma fonte de dados, como <strong>Google Sheets<\/strong> ou <strong><strong><strong>Edit Fields (Set)<\/strong><\/strong><\/strong>.<\/li>\n\n\n\n<li>Conecte o node <strong>Loop Over Items<\/strong> &agrave; fonte de dados.<\/li>\n\n\n\n<li>Nas configura&ccedil;&otilde;es do node <strong>Loop Over Items<\/strong>, defina o <strong><strong>Batch Size<\/strong><\/strong>.<\/li>\n\n\n\n<li>Conecte a sa&iacute;da do node <strong>Loop Over Items<\/strong> ao node que executa a a&ccedil;&atilde;o, como <strong><strong>HTTP Request<\/strong><\/strong>.<\/li>\n\n\n\n<li>Conecte a sa&iacute;da do seu node de processamento de volta &agrave; entrada do node <strong>Loop Over Items<\/strong> para fechar o loop.<\/li>\n\n\n\n<li>Adicione a sa&iacute;da <strong><strong>Done<\/strong><\/strong> a qualquer etapa final que deve ser executada somente ap&oacute;s o processamento de todos os itens.<\/li>\n<\/ol><p class=\"wp-block-paragraph\">Aqui est&aacute; um exemplo de um workflow simples que percorre itens:<\/p><div class=\"wp-block-image\">\n<figure data-wp-context='{\"imageId\":\"6a71541c43bb5\"}' data-wp-interactive=\"core\/image\" data-wp-key=\"6a71541c43bb5\" class=\"aligncenter size-large wp-lightbox-container\"><img decoding=\"async\" width=\"1024\" height=\"565\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/exemplo-simples-de-um-fluxo-de-trabalho-com-looping.png\" alt=\"Um workflow n8n simples com loop\" class=\"wp-image-54062\" srcset=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/exemplo-simples-de-um-fluxo-de-trabalho-com-looping.png 1024w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/exemplo-simples-de-um-fluxo-de-trabalho-com-looping-300x166.png 300w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/exemplo-simples-de-um-fluxo-de-trabalho-com-looping-150x83.png 150w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/exemplo-simples-de-um-fluxo-de-trabalho-com-looping-768x424.png 768w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" data-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on--click=\"actions.showLightbox\" data-wp-style--right=\"state.thisImage.buttonRight\" data-wp-style--top=\"state.thisImage.buttonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n<\/div><p class=\"wp-block-paragraph\">Neste exemplo, enviamos <strong>100<\/strong> e-mails em grupos de <strong>10<\/strong>, que &eacute; o tamanho do lote (Batch size). O workflow executar&aacute; o node de envio de e-mail 10 vezes. Quando o loop termina de processar todos os itens, o worflow continua atrav&eacute;s da sa&iacute;da <strong>Done<\/strong>.<\/p><p class=\"wp-block-paragraph\">Exploraremos mais exemplos pr&aacute;ticos na se&ccedil;&atilde;o seguinte.<\/p><h2 class=\"wp-block-heading\" id=\"h-exemplos-praticos-de-loop\"><strong>Exemplos pr&aacute;ticos de loop<\/strong> <\/h2><p class=\"wp-block-paragraph\">Aqui est&atilde;o exemplos pr&aacute;ticos do <a href=\"\/br\/tutoriais\/o-que-automatizar-com-n8n\/\" target=\"_blank\" rel=\"noreferrer noopener\">que voc&ecirc; pode automatizar com n8n<\/a> e loops:<\/p><h3 class=\"wp-block-heading\"><strong>Enviando e-mails em massa em lotes<\/strong> <\/h3><p class=\"wp-block-paragraph\">Neste exemplo, voc&ecirc; tem 100 endere&ccedil;os de e-mail e deseja enviar mensagens em lotes de cinco por vez, com uma pausa de cinco minutos entre os lotes.<\/p><p class=\"wp-block-paragraph\">A repeti&ccedil;&atilde;o &eacute; necess&aacute;ria porque<strong> <\/strong>os provedores de servi&ccedil;o de e-mail aplicam limites rigorosos na taxa de envio de e-mails. Enviar 100 e-mails de uma vez pode exceder esses limites, resultando em falhas ou suspens&otilde;es tempor&aacute;rias da conta.<\/p><p class=\"wp-block-paragraph\">Repetir com intervalos entre os lotes ajuda a manter-se dentro desses limites, manter uma reputa&ccedil;&atilde;o de envio leg&iacute;tima e reduzir o risco de seus e-mails serem marcados como spam. Aqui est&aacute; como o workflow se parece:<\/p><figure data-wp-context='{\"galleryId\":\"6a71541c440fb\"}' data-wp-interactive=\"core\/gallery\" class=\"wp-block-gallery aligncenter has-nested-images columns-default is-cropped wp-block-gallery-1 is-layout-flex wp-block-gallery-is-layout-flex\">\n<figure data-wp-context='{\"imageId\":\"6a71541c4891e\"}' data-wp-interactive=\"core\/image\" data-wp-key=\"6a71541c4891e\" class=\"wp-block-image size-large wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" data-id=\"131666\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/2\/2025\/07\/n8n-workflow-send-bulk-emails.png\/w=1024,h=1024,fit=scale-down\" alt=\"Workflow n8n para envio de e-mails em massa\" class=\"wp-image-131666\"><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" data-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on--click=\"actions.showLightbox\" data-wp-style--right=\"state.thisImage.buttonRight\" data-wp-style--top=\"state.thisImage.buttonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n<\/figure><p class=\"wp-block-paragraph\">No workflow, definimos os endere&ccedil;os de e-mail usando o node <strong>Edit Fields<\/strong>. No entanto, se voc&ecirc; j&aacute; conectou o n8n ao Google Sheets, pode extrair endere&ccedil;os de e-mail reais de uma planilha usando o node do Google Sheets.<\/p><p class=\"wp-block-paragraph\">O workflow ent&atilde;o divide os dados de origem em v&aacute;rios endere&ccedil;os de e-mail individuais, pelos quais o loop ent&atilde;o itera. O workflow posteriormente usa cada item de contato como destino para o node <strong>Send email<\/strong>.<\/p><h3 class=\"wp-block-heading\"><strong>Processamento de grandes conjuntos de dados<\/strong> <\/h3><p class=\"wp-block-paragraph\">Neste exemplo, imagine que voc&ecirc; precisa processar um grande conjunto de dados enquanto respeita limites de taxa ou restri&ccedil;&otilde;es do sistema. Este workflow processa 500 registros de clientes em lotes de 10.<\/p><p class=\"wp-block-paragraph\">O looping &eacute; crucial aqui porque muitas APIs imp&otilde;em limites de taxa, como 100 solicita&ccedil;&otilde;es por minuto. Processar todos os 500 registros de uma vez excede esses limites, causando falhas.<\/p><p class=\"wp-block-paragraph\">O node Loop Over Items divide os dados em partes menores, evitando sobrecargas no n8n e no sistema de destino, garantindo um processamento mais suave e confi&aacute;vel. Aqui est&aacute; como isso se encaixa no workflow:<\/p><figure data-wp-context='{\"galleryId\":\"6a71541c4bbec\"}' data-wp-interactive=\"core\/gallery\" class=\"wp-block-gallery aligncenter has-nested-images columns-default is-cropped wp-block-gallery-2 is-layout-flex wp-block-gallery-is-layout-flex\">\n<figure data-wp-context='{\"imageId\":\"6a71541c4f9f3\"}' data-wp-interactive=\"core\/image\" data-wp-key=\"6a71541c4f9f3\" class=\"wp-block-image size-large wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" data-id=\"131668\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/2\/2025\/07\/n8n-workflow-handle-large-datasets.png\/w=1024,h=1024,fit=scale-down\" alt=\"Workflow n8n para lidar com grandes conjuntos de dados\" class=\"wp-image-131668\"><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" data-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on--click=\"actions.showLightbox\" data-wp-style--right=\"state.thisImage.buttonRight\" data-wp-style--top=\"state.thisImage.buttonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n<\/figure><p class=\"wp-block-paragraph\">O node de <strong>Code<\/strong> gera registros fict&iacute;cios de clientes. Se voc&ecirc; j&aacute; tiver uma lista de dados de clientes em uma planilha ou em uma plataforma de CRM de terceiros, como o<strong> Airtable,<\/strong> conecte o node correspondente.<\/p><p class=\"wp-block-paragraph\">O workflow percorre os dados do cliente recebidos e pausa a execu&ccedil;&atilde;o assim que atinge o node de espera para evitar ultrapassar o limite de taxa da API. Em seguida, os dados passam para o node de processamento, que no exemplo acima &eacute; representado pelo node <strong>No Operation<\/strong> como um espa&ccedil;o reservado.<\/p><p>\n\n\n        <div class=\"protip\">\n            <div class=\"protip__heading\">\n                <svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\">\n                    <path d=\"M1.49234 23.5024C1.23229 23.5024 0.972242 23.4024 0.782206 23.2123C0.562165 22.9923 0.452144 22.6822 0.502153 22.3722C0.562165 21.9221 1.14227 17.9113 3.00262 16.351C3.63274 15.8209 4.43289 15.5509 5.26305 15.5609C6.09321 15.5909 6.87335 15.9109 7.47347 16.4911C8.6937 17.6913 8.76371 19.6717 7.6435 20.9919C6.0832 22.8523 2.08245 23.4324 1.63237 23.4924C1.59236 23.4924 1.54235 23.4924 1.50234 23.4924L1.49234 23.5024ZM5.16303 17.5613C4.84297 17.5613 4.53291 17.6713 4.29287 17.8813C3.60274 18.4614 3.07264 19.9317 2.75258 21.242C4.06282 20.9219 5.5331 20.3918 6.11321 19.7017C6.55329 19.1716 6.54329 18.3814 6.0832 17.9213C5.85316 17.7013 5.5431 17.5713 5.20304 17.5613C5.19304 17.5613 5.17303 17.5613 5.16303 17.5613ZM11.7243 21.8821C11.4942 21.8821 11.2642 21.8021 11.0841 21.652C10.8541 21.462 10.7241 21.1819 10.7241 20.8819V15.9109L8.08358 13.2705H3.11264C2.81259 13.2705 2.53254 13.1404 2.3425 12.9104C2.15246 12.6803 2.07245 12.3803 2.12246 12.0902C2.19247 11.7102 2.84259 8.36953 4.70294 7.12929C6.33325 6.04909 8.96375 6.49918 10.244 6.80923C11.5442 4.96889 13.2546 3.4286 15.2349 2.33839C17.4553 1.11816 19.9858 0.518051 22.4963 0.498047C23.0464 0.498047 23.4865 0.948132 23.4865 1.49824C23.4865 5.0389 22.3763 9.97983 17.1753 13.7605C17.4853 15.0408 17.9354 17.6613 16.8552 19.2816C15.615 21.1419 12.2744 21.7921 11.8943 21.8621C11.8343 21.8721 11.7743 21.8821 11.7143 21.8821H11.7243ZM12.7245 16.181V19.6016C13.7146 19.2916 14.7948 18.7915 15.2049 18.1814C15.675 17.4812 15.605 16.091 15.385 14.9008C14.5248 15.3808 13.6346 15.8109 12.7245 16.181ZM9.66388 12.0302L11.9643 14.3307C13.1845 13.8306 14.3648 13.2204 15.485 12.5103C19.9358 9.51974 21.2361 5.60901 21.4561 2.53843C19.6157 2.67846 17.8254 3.20856 16.2051 4.09872C14.2847 5.14892 12.6544 6.68921 11.4942 8.54956C10.7841 9.65977 10.174 10.82 9.66388 12.0302ZM4.39289 11.2701H7.81353C8.1936 10.3599 8.63368 9.46974 9.11377 8.60957C7.92355 8.38953 6.51329 8.31952 5.81315 8.78961C5.19304 9.19968 4.70294 10.3099 4.39289 11.2701Z\" fill=\"#673DE6\"\/>\n                <\/svg>\n                <p class=\"protip__title\">\n                    &#128218; Leitura sugerida                <\/p>\n            <\/div>\n            <p class=\"protip__content\">Se voc&ecirc; trabalha com automa&ccedil;&otilde;es grandes ou que consomem muitos recursos, aprenda a mant&ecirc;-las est&aacute;veis <a href=\"\/br\/tutoriais\/n8n-queue-mode\/\">usando o modo de fila para workflows grandes<\/a>.<\/p>\n                    <\/div>\n        \n\n\n\n<\/p><h3 class=\"wp-block-heading\"><strong>Lendo v&aacute;rios feeds RSS sequencialmente<\/strong> <\/h3><p class=\"wp-block-paragraph\">Neste exemplo, suponha que voc&ecirc; queira configurar um sistema automatizado que busque conte&uacute;do de v&aacute;rias fontes RSS &ndash; por exemplo, Tutoriais e Blog da Hostinger &ndash; fazendo isso sequencialmente, com intervalos controlados.<\/p><p class=\"wp-block-paragraph\">A repeti&ccedil;&atilde;o &eacute; necess&aacute;ria aqui para evitar que solicita&ccedil;&otilde;es simult&acirc;neas a v&aacute;rios feeds RSS, seja do mesmo dom&iacute;nio ou de dom&iacute;nios diferentes, sejam interpretadas como comportamento agressivo. Emparelh&aacute;-lo com intervalos ajuda a gerenciar os recursos do servidor, reduz o risco de bloqueio de IP ou limita&ccedil;&atilde;o de taxa e garante acesso confi&aacute;vel aos feeds.<\/p><p class=\"wp-block-paragraph\">Aqui est&aacute; um exemplo de um wokflow com um loop que busca v&aacute;rios feeds RSS:<\/p><figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"306\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/Captura-de-Tela-2026-04-17-as-06.50.41-1-1024x306.png\" alt=\"Fluxo de trabalho n8n para processar m&uacute;ltiplos feeds RSS\" class=\"wp-image-54353\" srcset=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/Captura-de-Tela-2026-04-17-as-06.50.41-1-scaled.png 1024w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/Captura-de-Tela-2026-04-17-as-06.50.41-1-300x90.png 300w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/Captura-de-Tela-2026-04-17-as-06.50.41-1-150x45.png 150w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/Captura-de-Tela-2026-04-17-as-06.50.41-1-768x230.png 768w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><p class=\"wp-block-paragraph\">O bloco de <strong>Code<\/strong> gera uma lista de URLs para buscar feeds RSS. O workflow percorre cada item e passa o endere&ccedil;o para o node <strong>RSS<\/strong> <strong>Read<\/strong> que vai buscar o conte&uacute;do do blog.<\/p><h2 class=\"wp-block-heading\" id=\"h-melhores-praticas-para-lacos-de-repeticao\"><strong>Melhores pr&aacute;ticas para la&ccedil;os de repeti&ccedil;&atilde;o<\/strong> <\/h2><p class=\"wp-block-paragraph\">Siga estas melhores pr&aacute;ticas para iterar sobre itens no n8n para evitar problemas e manter seus workflows organizados:<\/p><ul class=\"wp-block-list\">\n<li><strong>Defina o<\/strong> <strong>Batch Size<\/strong> como 1 para processamento item por item, ou aumente o valor caso o processamento em lote seja mais adequado para o seu caso..<\/li>\n\n\n\n<li><strong>Sempre conecte o loop de volta<\/strong> do seu node de processamento ao node <strong>Loop Over Items<\/strong> para continuar at&eacute; que todos os itens sejam processados.<\/li>\n\n\n\n<li><strong>Use o node Split Out<\/strong> se sua entrada for um &uacute;nico array JSON que ainda n&atilde;o foi dividido em itens individuais.<\/li>\n\n\n\n<li><strong>Defina uma condi&ccedil;&atilde;o de sa&iacute;da clara<\/strong> para evitar loops infinitos, especialmente ao trabalhar com pagina&ccedil;&atilde;o.<\/li>\n\n\n\n<li><strong>Respeite os limites de taxa da API<\/strong> adicionando um node de <strong>espera<\/strong> entre as solicita&ccedil;&otilde;es para evitar a limita&ccedil;&atilde;o.<\/li>\n\n\n\n<li><strong>Mantenha seu loop enxuto;<\/strong> quanto menos nodes dentro dele, melhor ser&aacute; o desempenho.<\/li>\n<\/ul><p class=\"wp-block-paragraph\">Al&eacute;m de seguir essas melhores pr&aacute;ticas, h&aacute; v&aacute;rios erros que voc&ecirc; deve evitar ao fazer loop de dados no seu workflow n8n.<\/p><h3 class=\"wp-block-heading\"><strong>Erros comuns ao fazer loop no n8n<\/strong> <\/h3><p class=\"wp-block-paragraph\">Alguns dos erros mais comuns ao percorrer dados em seu workflow n8n incluem:<\/p><ul class=\"wp-block-list\">\n<li><strong>Loops infinitos.<\/strong> Conectar um node de volta ao in&iacute;cio do workflow em vez do node <strong>Loop Over Items<\/strong> faz com que o loop seja executado indefinidamente.<\/li>\n\n\n\n<li><strong>Conex&atilde;o de retorno ausente.<\/strong> N&atilde;o conectar o node de processamento de volta ao node de loop faz com que o workflow pare ap&oacute;s o primeiro lote.<\/li>\n\n\n\n<li><strong>Uso incorreto de sa&iacute;da.<\/strong> Conectar a l&oacute;gica de processamento &agrave; sa&iacute;da <strong>Done<\/strong> em vez da sa&iacute;da <strong>Loop<\/strong> faz com que seus dados sejam repetidos, mas n&atilde;o processados. <\/li>\n<\/ul><h2 class=\"wp-block-heading\" id=\"h-onde-voce-deve-hospedar-seus-fluxos-de-trabalho-n8n\"><strong>Onde voc&ecirc; deve hospedar seus fluxos de trabalho n8n?<\/strong> <\/h2><p class=\"wp-block-paragraph\">O ideal &eacute; hospedar seu workflow n8n em um ambiente confi&aacute;vel, pois ele requer estabilidade, desempenho ideal e tempo de atividade consistente. Com isso em mente, as melhores op&ccedil;&otilde;es s&atilde;o usar o plano oficial em nuvem do n8n ou hosped&aacute;-lo em um servidor virtual privado (VPS) de um provedor renomado como a Hostinger.<\/p><p class=\"wp-block-paragraph\">Com a <a href=\"\/br\/vps\/n8n-hosting\" target=\"_blank\" rel=\"noreferrer noopener\">hospedagem n8n da Hostinger<\/a>, o n8n e todos os componentes necess&aacute;rios v&ecirc;m pr&eacute;-instalados, ent&atilde;o voc&ecirc; n&atilde;o precisa instalar tudo manualmente. Voc&ecirc; pode executar automa&ccedil;&otilde;es avan&ccedil;adas sem interrup&ccedil;&atilde;o, apoiado por hardware e infraestrutura poderosos que garantem <strong>99,9%<\/strong> de tempo de atividade.<\/p><p class=\"wp-block-paragraph\">Escalar &eacute; simples. Com at&eacute;<strong> 8 n&uacute;cleos de vCPU<\/strong>, <strong>32 GB <\/strong>de RAM, <strong>400 GB <\/strong>de armazenamento NVMe SSD e <strong>32 TB <\/strong>de largura de banda, voc&ecirc; pode come&ccedil;ar pequeno e fazer upgrades com apenas alguns cliques &agrave; medida que seus workflows crescem.<\/p><figure class=\"wp-block-image size-large\"><a href=\"\/br\/servidor-vps\" target=\"_blank\" rel=\"noreferrer noopener\"><img decoding=\"async\" width=\"1024\" height=\"300\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=1024,h=1024,fit=scale-down\" alt=\"\" class=\"wp-image-32923\" srcset=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=1024,fit=scale-down 1024w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=300,fit=scale-down 300w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=150,fit=scale-down 150w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=768,fit=scale-down 768w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=1536,fit=scale-down 1536w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure><h2 class=\"wp-block-heading\" id=\"h-como-conectar-seus-loops-n8n-a-apis-externas\"><strong>Como conectar seus loops n8n a APIs externas<\/strong> <\/h2><p class=\"wp-block-paragraph\">Depois de dominar a itera&ccedil;&atilde;o sobre itens, o pr&oacute;ximo passo &eacute; expandir seus workflows para interagir com fontes de dados externas. Por exemplo, um loop &eacute; frequetemente usado com APIs para permitir que seu n8n busque ou envie dados dinamicamente sem ultrapassar o limite de taxa.<\/p><p class=\"wp-block-paragraph\">Como existem v&aacute;rias APIs, voc&ecirc; pode conectar o n8n a elas de diferentes maneiras. Para come&ccedil;ar, percorra uma lista de novos pedidos e use um node de <strong><strong>HTTP Request<\/strong><\/strong> para enviar detalhes a uma API de contabilidade.<\/p><p class=\"wp-block-paragraph\">Para saber mais sobre como integrar API ao seu workflow n8n, leia nosso guia sobre<a href=\"\/br\/tutoriais\/n8n-api\/\" target=\"_blank\" rel=\"noreferrer noopener\"> como usar n8n com APIs<\/a>. Se voc&ecirc; &eacute; novo em APIs e quer entender como elas funcionam antes de conect&aacute;-las ao n8n, leia nosso tutorial sobre o que &eacute; uma API p&uacute;blica.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>O Loop Over Items do n8n &eacute; um componente que permite iterar e processar dados em lote. Ele ajuda a lidar com grandes conjuntos de dados, como endere&ccedil;os de e-mail, respostas de API ou registros de banco de dados. Para implementar loops no seu worflow n8n, h&aacute; alguns pontos-chave que voc&ecirc; precisa entender sobre esse [&#8230;]<\/p>\n<p><a class=\"btn btn-secondary understrap-read-more-link\" href=\"\/br\/tutoriais\/n8n-loop-over-items\/\">Read More&#8230;<\/a><\/p>\n","protected":false},"author":433,"featured_media":54061,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"rank_math_title":"","rank_math_description":"Conhe\u00e7a o node n8n Loop Over Items para automatizar envios de email, processar grandes volumes de dados e dividir fluxos em execu\u00e7\u00f5es eficientes.","rank_math_focus_keyword":"n8n loop over items","footnotes":""},"categories":[4915],"tags":[],"class_list":["post-54063","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-vps"],"hreflangs":[{"locale":"en-US","link":"https:\/\/www.hostinger.com\/tutorials\/how-to-loop-over-items-in-n8n\/","default":1},{"locale":"pt-BR","link":"https:\/\/www.hostinger.com\/br\/tutoriais\/n8n-loop-over-items\/","default":0},{"locale":"fr-FR","link":"https:\/\/www.hostinger.com\/fr\/tutoriels\/loop-over-items-n8n\/","default":0},{"locale":"es-ES","link":"https:\/\/www.hostinger.com\/es\/tutoriales\/como-utilizar-el-nodo-loop-over-items-en-n8n\/","default":0},{"locale":"de-DE","link":"https:\/\/www.hostinger.com\/de\/tutorials\/loop-over-items-in-n8n-anleitung\/","default":0},{"locale":"it-IT","link":"https:\/\/www.hostinger.com\/it\/tutorial\/loop-over-items-n8n\/","default":0},{"locale":"en-PH","link":"https:\/\/www.hostinger.com\/ph\/tutorials\/how-to-loop-over-items-in-n8n\/","default":0},{"locale":"en-MY","link":"https:\/\/www.hostinger.com\/my\/tutorials\/how-to-loop-over-items-in-n8n\/","default":0},{"locale":"en-GB","link":"https:\/\/www.hostinger.com\/uk\/tutorials\/how-to-loop-over-items-in-n8n\/","default":0},{"locale":"en-IN","link":"https:\/\/www.hostinger.com\/in\/tutorials\/how-to-loop-over-items-in-n8n\/","default":0},{"locale":"en-CA","link":"https:\/\/www.hostinger.com\/ca\/tutorials\/how-to-loop-over-items-in-n8n\/","default":0},{"locale":"en-AU","link":"https:\/\/www.hostinger.com\/au\/tutorials\/how-to-loop-over-items-in-n8n\/","default":0},{"locale":"en-NG","link":"https:\/\/www.hostinger.com\/ng\/tutorials\/how-to-loop-over-items-in-n8n\/","default":0},{"locale":"es-AR","link":"https:\/\/www.hostinger.com\/ar\/tutoriales\/como-utilizar-el-nodo-loop-over-items-en-n8n\/","default":0},{"locale":"es-MX","link":"https:\/\/www.hostinger.com\/mx\/tutoriales\/como-utilizar-el-nodo-loop-over-items-en-n8n\/","default":0},{"locale":"es-CO","link":"https:\/\/www.hostinger.com\/co\/tutoriales\/como-utilizar-el-nodo-loop-over-items-en-n8n\/","default":0},{"locale":"pt-PT","link":"https:\/\/www.hostinger.com\/pt\/tutoriais\/n8n-loop-over-items\/","default":0}],"acf":[],"_links":{"self":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts\/54063","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/users\/433"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/comments?post=54063"}],"version-history":[{"count":7,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts\/54063\/revisions"}],"predecessor-version":[{"id":54359,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts\/54063\/revisions\/54359"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/media\/54061"}],"wp:attachment":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/media?parent=54063"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/categories?post=54063"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/tags?post=54063"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}