Nó: Loop / para cada

O nó Loop / para cada percorre uma lista (um array ou uma variável com vários elementos) e executa o ramo interno uma vez para cada elemento, expondo o elemento atual e sua posição como variáveis para usar dentro do loop.

Quando usar

• Processar um a um os elementos de uma lista trazida por uma etapa anterior (ex. uma resposta de API com vários registros).
• Aplicar a mesma ação (nota, mensagem, atualização) a cada item de uma lista de contatos ou tarefas.

Configuração

• Origem (source): a variável com a lista, ex. $items ou $response.body.users. Também aceita texto separado por vírgulas.
• Variável do elemento (item_var): nome do elemento atual dentro do loop, padrão item.
• Variável do índice (index_var): nome da posição atual, padrão index.
• Máximo de iterações: limite de segurança, 100 por padrão.

Saídas

• iteration: ramo que se repete uma vez por elemento.
• done: ramo que roda uma única vez, ao terminar o loop.

Exemplo

Um nó "Requisição HTTP" traz uma lista em {{$response.json.users}} → nó Loop com origem $response.json.users → dentro do ramo "iteration", "Registrar atividade" usando {{$item.email}} para cada usuário; ao terminar, o ramo "done" segue para "Encerrar conversa".

Dicas

• A origem aceita arrays JSON, variáveis de etapas anteriores ou texto separado por vírgulas.
• Aumente o máximo de iterações se esperar listas maiores que o padrão de 100.

Solução de problemas

• O loop não itera nada: a variável de origem está vazia ou não resolve para uma lista; verifique o painel de Variáveis.
• Ele para antes de processar tudo: a lista ultrapassou o máximo de iterações configurado e foi truncada.