Ferramenta Agregador

O Agregador coleta linhas de dados individuais em um único array. Ele funciona como o oposto da ferramenta Iterador:

• O Iterator divide um array em elementos separados.

• O Agregador combina os elementos de volta em um array.

Se o Iterator permite que você processe cada item separadamente, o Agregador ajuda você a montar tudo no formato correto para a etapa final.

Por que você precisa do Agregador

Quando uma etapa espera um array (por exemplo, itens de linha em uma fatura), a Albato deve receber esse array como um único objeto estruturado.

Se você mapear campos diretamente de diferentes etapas após um Iterator, o sistema não pode combiná-los automaticamente em um único array. Isso leva a um conflito de estrutura e resulta em erro.

O Agregador resolve esse problema. Ele combina dados de múltiplas etapas em um único array estruturado. A etapa final então recebe tudo de uma única fonte, corretamente formatado e sem conflitos.

Exemplo de Fluxo que usa o Iterador/Agregador:

Iterador → Processamento de dados → Agregador → Etapa final.

Como configurar o Agregador

Primeiro, clique na etapa de Agregador préviamente adicionado no local desejado, sempre após o Iterador.

Nas configurações, você precisa adicionar campos e cada um deles representa uma coluna do futuro array.

Para cada campo, você configura dois parâmetros:

Nome

Esse nome estará disponível nas próximas etapas e te ajudará a selecionar o campo correto.

Selecionar um campo

A fonte de dados de qualquer etapa anterior na automação. Esses valores selecionados formarão novas seções de linha que depois serão enviadas como um array.

Dentro de uma única etapa do Agregador , você pode coletar dados simultaneamente:

• do Iterator;

• de ferramentas de processamento (por exemplo, Operação matemática);

• de outras etapas anteriores.

Exemplo: Criando uma fatura no Zoho Books com itens de linha do pedido

Vamos analisar um exemplo real de automação. O objetivo é criar uma fatura no Zoho Books quando um novo pedido é recebido e enviar todas as posições do pedido como itens de linha.

A automação ficaria assim:

Webhook → Encontrar cliente → Iterator → Processamento de dados → Agregador → Criar fatura

Etapa 1. Webhook de entrada

A automação começa com Webhook: Webhook de entrada.

O webhook envia um pedido que inclui um array de produtos. Cada item contém:

• nome do produto;
• preço;
• quantidade;
• imposto;
• envio;
• código promocional.

Nesta etapa, os dados existem como um único objeto contendo um array de itens.

Etapa 2. Encontrar o cliente

A próxima etapa é Google Sheets: Encontrar uma linha.

Aqui, a automação usa o e-mail recebido do webhook para buscar o cliente correspondente em uma tabela do Google Sheets. Assim que a linha correta é encontrada, ela recupera o ID do Cliente , que é necessário para criar a fatura no Zoho Books.

Essa lógica é separada do processamento do array, mas necessária para a etapa final.

Etapa 3. Iterator

Nesta etapa, o Iterator seleciona o array Items recebido do Google Sheets:

Ao escolher os dados do Google Sheets, a automação divide os dados coletados de diferentes IDs e produtos de cada linha da sua planilha. Cada dado então pode ser processado separadamente nas etapas seguintes.

Isso permite que você calcule impostos, modifique descrições ou ajuste valores para cada item antes de reuni-los novamente em um array estruturado.

Etapa 4. Processando cada item

Após o Iterator, cada item é processado separadamente.

Nesta etapa, você pode aplicar ferramentas adicionais, por exemplo:

• usar a ferramenta Remove tags para limpar a descrição do produto;

• usar a ferramenta Operação matemática para calcular imposto ou outros valores.

Etapa 6. Agregador

Após o processamento, a etapa Tool: Agregador é adicionada.

É aqui que acontece a transformação principal.

Nas configurações do Agregador, os campos são adicionados e nesse caso, estamos juntando dados diferentes, vindos da planilha e do Webhook em um único Array.

O que acontece depois?

O Agregador:

• Pega a primeira iteração.
• Coleta todos os campos especificados.
• Forma uma linha do array.
• Passa para a segunda iteração.
• Repete o processo.

Como resultado, um novo array estruturado é criado. Esse array se torna uma única fonte de dados para a próxima etapa.

Etapa 7. Substituição de tabela

Após o Agregador, uma ferramenta Substituição de tabela (Table lookup) é usada para transformar valores específicos antes de enviá-los para o Zoho Books.

Nesta etapa, o sistema verifica o valor recebido da etapa anterior (por exemplo, uma porcentagem de imposto ou código interno) e o substitui pelo ID correspondente exigido pelo Zoho Books.

Isso é necessário porque alguns apps, por exemplo o Zoho Books, não aceita o nome ou o valor do campo diretamente. Em vez disso, ele exige IDs internos já salvos por lá.

A etapa de Substituicao de tabela faz o mapeamento de valores legíveis para os IDs exatos esperados pelo serviço.

Etapa 8. Criando a fatura no Zoho Books

Após configurar as etapas anteriores, adicione a ação para criar recibos: Zoho Books - Create Invoice.

Na seção Line items, cada campo é mapeado a partir do resultado do Agregador:

Isso significa que o Zoho Books recebe um array totalmente estruturado de itens de linha, com todos os valores já processados e formatados corretamente.

Conclusão

O Agregador garante que dados baseados em array sejam enviados corretamente para o serviço final.

Ele combina linhas processadas em um único array estruturado que o serviço de destino pode aceitar sem conflitos ou problemas de formatação.

Se sua automação usa o Iterador e coleta dados de array de múltiplas etapas, o Agregador se torna uma parte essencial do fluxo. Ele torna automações complexas estáveis, previsíveis e tecnicamente corretas.

Para saber mais sobre como nossas ferramentas funcionam, explore nosso blog. Você pode encontrar um guia detalhado sobre a ferramenta Iterador neste artigo aqui .

Se você tiver alguma dúvida, nossa equipe de suporte está sempre disponível no chat ao vivo.