---
title: "Iterador"
description: "Quando chega um lote, ele trata um por um."
url: https://ajuda.customerx.com.br/pt-br/articles/195-iterador
collection: "Ferramentas"
updated: 2026-06-08
language: pt-br
---

# Iterador

Quando chega um lote, ele trata um por um.

Quando chega um lote, ele trata um por um.

> **Info:** O CX Connect fica em cliente.customerx.com.br/connect, na aba Automações. Você pode ver as ações de cada app antes de conectar qualquer conta, e cada dado gravado consome uma transação do plano.

## O que ele faz, em bom português

Primeiro, o termo: nos textos técnicos você verá a palavra array (ou matriz), que significa apenas lista, vários itens juntos, como uma coluna de planilha com diversos valores. Às vezes um único evento traz uma lista inteira: um pedido com cinco produtos, um formulário com três contatos. O Iterador pega essa lista e repete as etapas seguintes para cada item, um de cada vez, como passar item por item de uma lista de chamada.

## Quando usar no dia a dia de CS

-   Um evento traz vários contatos e cada um precisa ser criado individualmente no CustomerX.
    
-   Cada item de um pedido precisa virar um registro próprio.
    
-   Cada linha de uma planilha recebida precisa de tratamento separado.
    

## Como configurar, passo a passo

1.  Depois da etapa que entrega a lista, clique no sinal de mais e escolha **Ferramenta**, depois **Iterador** e **Selecionar**.
    
2.  Indique qual campo contém a lista.
    
3.  Monte as etapas seguintes uma vez só, elas vão rodar automaticamente para cada item.
    

## Exemplo do mundo real

Um formulário de kickoff pede os contatos-chave do cliente e chega com três pessoas de uma vez. O Iterador percorre a lista e cria os três contatos no CustomerX, cada um com nome e e-mail certos, sem ninguém digitar nada.

## Fica a dica

Cada item gravado consome uma transação do plano. Uma lista de 50 itens = 50 transações. Se só parte da lista interessa, filtre antes com o Filter row elements. E se depois você precisar juntar tudo de novo, o Agregador faz o caminho inverso.

## Artigos relacionados

[

Mapeamento de campos

Como ligar os campos da ferramenta de origem aos campos do CustomerX para que os dados entrem no lugar certo.

](https://ajuda.customerx.com.br/pt-br/articles/177-mapeamento-de-campos.md)[

Testar, ativar e acompanhar

Como testar uma automação antes de ativar e onde acompanhar as execuções pelo Histórico.

](https://ajuda.customerx.com.br/pt-br/articles/178-testar-ativar-e-acompanhar.md)
