Nó Loop / Para Cada

O nó Loop / Para Cada itera sobre um array e executa um ramo do fluxo para cada item. Essencial para processar listas retornadas por APIs.

Duas saídas visuais

• ↻ POR ITEM (amber, esquerda) — conecte aqui os nós que devem rodar em cada iteração
• → APÓS TERMINAR (verde, direita) — conecte aqui o que acontece depois de todas as iterações

Configuração

• Variável do array — nome da variável com o array (ex: resposta salva por um requestNode)
• Nome da variável do item — como acessar o item atual (padrão: item)
• Variável do índice (opcional) — expõe o índice 0-based
• Máximo de iterações — limite de segurança (padrão 100, máx 1000)

Acessando dados no body

Dentro do loop, use:

• {{item}} — item inteiro serializado JSON
• {{item_campo}} — campo específico do objeto (ex: {{item_phone}}, {{item_nome}})
• {{i}} — índice atual (se configurado)

Nós suportados no body

✅ Suportados: sendMessage, sendTemplate, webhook, code, condition, assign (agente/time/tag/status/prioridade), email, CRM, CAPI, delay (limitado a 2s)

❌ Não suportados: askQuestion, menu, buttonReply, aiAgent, sendNps, whatsappFlow (nós que pausam o fluxo). São pulados com um warning no log.

❌ Loops aninhados não são suportados.

Exemplo

1. 1requestNode chama GET /api/pedidos e salva em {{pedidos}} (array)
2. 2loopNode com Array: pedidos, Item: pedido
3. 3No body: sendMessage com texto "Olá {{pedido_cliente}}, seu pedido #{{pedido_id}} foi enviado!"
4. 4Depois do loop: sendMessage final "Enviamos {{pedidos_count}} notificações"