Antes de entender como ela funciona, é importante compreender um conceito fundamental: Listas de Dados (Arrays).
No mundo das integrações, as informações nem sempre chegam sozinhas; às vezes, elas chegam em grupos. Por exemplo, um "Negócio" em um CRM pode ter vários produtos associados. Cada produto é uma Linha e o conjunto desses produtos é chamado de Lista (ou Array).
Exemplo de objeto JSON:
{ "nomeDoNegocio": "Venda Corporativa", "itens": [ { "nome": "Licença de IA", "quantidade": "2" }, { "nome": "Suporte Técnico", "quantidade": "1" } ] }O Iterator Tool foi projetado para processar cada elemento de uma lista individualmente. Isso garante que qualquer etapa subsequente no Fluxo seja executada o mesmo número de vezes que a quantidade de elementos presentes na lista.
Nota: O Iterator é comumente utilizado após ações de "Busca de múltiplos registros".
Quais desafios o Iterator resolve?
Imagine que você tem um banco de dados de clientes com faturas pendentes e deseja automatizar o envio de lembretes. Se um cliente tiver 3 faturas, você não quer enviar um e-mail genérico; você quer processar cada fatura separadamente para detalhar valores e datas.
Exemplo de uso do Iterator:
Gatilho (Trigger): O fluxo é ativado no fechamento do mês.
Busca de Dados: O Darwin busca no seu CRM todos os pagamentos pendentes de um cliente específico (isso retorna uma lista).
Iterator Tool: É aqui que a ferramenta entra. O iterador percorre cada fatura da lista, uma por uma:
Extrai o número da fatura, o valor e a data de vencimento de cada item.
Formata esses detalhes para a mensagem.
Ação: Para cada fatura encontrada, o Fluxo realiza uma ação, como enviar uma mensagem de WhatsApp individualizada ou atualizar o status de cada item em uma planilha.
Como acessar e configurar o Iterator Tool
Para aplicar a lógica de iteração no seu fluxo de trabalho, siga estas etapas:
Identifique a Lista: Abra sua automação e certifique-se de ter uma etapa anterior que gere uma lista de dados (como uma busca múltipla).
Adicione a Ferramenta: Clique no botão "+" (Plus) abaixo da etapa que contém a lista.
Selecione "Tool": Clique na opção Tool e selecione Iterator.
Defina a Origem: Na configuração do Iterator, selecione o campo que contém o "Array" ou lista que você deseja desmembrar.
Configure as Etapas Seguintes: Qualquer módulo colocado após o Iterator se repetirá automaticamente para cada item da lista.
✅ Dica de Sucesso
Se você for enviar mensagens em massa baseadas em uma lista (por exemplo, notificar 20 contatos encontrados em uma busca), recomendamos colocar um Delay Tool logo após o Iterator. Isso evita que todas as mensagens sejam enviadas no mesmo segundo, protegendo a reputação do seu número e evitando bloqueios por spam.
Perguntas Frequentes (FAQs)
O que acontece se a lista estiver vazia? Se o Iterator não encontrar elementos no array, as etapas subsequentes simplesmente não serão executadas e o Fluxo terminará com sucesso, sem erros.
Posso editar os dados dentro do iterador? Sim! Você pode usar ferramentas de formatação (como um formatador de texto ou números) dentro do ciclo do iterador para que cada item seja processado no formato correto antes de chegar ao destino final.
É o mesmo que um "Loop"? Sim. Em termos de programação, o Iterator funciona como um loop for-each, percorrendo cada objeto de uma coleção do início ao fim.