---
title: "Filter row elements"
description: "Uma peneira para listas: ficam só os itens que atendem à regra."
url: https://ajuda.customerx.com.br/pt-br/articles/208-filter-row-elements
collection: "Ferramentas"
updated: 2026-08-04
language: pt-br
---

# Filter row elements

Uma peneira para listas: ficam só os itens que atendem à regra.

Uma peneira para listas: ficam só os itens que atendem à regra.

> **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 ela faz, em bom português

Lembrando: array é lista. Quando uma lista inteira chega no fluxo (vários contratos, vários pedidos), nem sempre todos os itens interessam. Esta ferramenta peneira a lista com base numa regra que você define e deixa passar apenas os itens que se encaixam, os outros ficam de fora.

## Quando usar no dia a dia de CS

-   De todos os contratos enviados, processar apenas os ativos.
    
-   De uma lista de pedidos, seguir só com os acima de determinado valor.
    
-   Antes de um Iterador: peneirar primeiro economiza transações, porque menos itens passam para as etapas que gravam dados.
    

## Como configurar, passo a passo

1.  Depois da etapa que entrega a lista, clique no sinal de mais e escolha **Ferramenta**, depois **Filter row elements** e **Selecionar**.
    
2.  Monte a regra de permanência: campo, comparação e valor (ex.: status igual a "ativo").
    
3.  A lista peneirada segue para as próximas etapas.
    

## Exemplo do mundo real

A origem manda os 12 contratos do cliente, entre ativos e encerrados. A peneira deixa passar só os 3 ativos, e o Iterador grava apenas esses no CustomerX, base limpa e 9 transações economizadas.

## Fica a dica

Não confunda com o filtro comum (Interromper automação por condição): aquele decide se o fluxo continua; este decide quais itens da lista continuam. E se você quer só o primeiro item que se encaixa, o Obter elemento da linha resolve mais simples.

## 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)
