---
title: "Obter elemento da linha"
description: "Pega um item da lista por uma regra: \"o primeiro que for assim\"."
url: https://ajuda.customerx.com.br/pt-br/articles/199-obter-elemento-da-linha
collection: "Ferramentas"
updated: 2026-08-04
language: pt-br
---

# Obter elemento da linha

Pega um item da lista por uma regra: "o primeiro que for assim".

Pega um item da lista por uma regra: "o primeiro que for assim".

> **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

Enquanto o Obter um elemento de um array escolhe pela posição (o 1º, o 2º), esta escolhe pela característica: você define uma condição e ela devolve o primeiro item da lista que se encaixa. "Da lista de contratos, me dá o primeiro que estiver ativo."

## Quando usar no dia a dia de CS

-   Achar o contrato ativo no meio de vários (ativos e cancelados).
    
-   Pegar o contato com papel de decisor dentro da lista de contatos do cliente.
    
-   Selecionar o item com valor acima de um corte.
    

## Como configurar, passo a passo

1.  Clique no sinal de mais entre as etapas e escolha **Ferramenta**, depois **Obter elemento da linha** e **Selecionar**.
    
2.  Indique a lista e monte a condição: campo, comparação e valor (ex.: status igual a "ativo").
    
3.  A ferramenta devolve o primeiro item que atende; use-o nas etapas seguintes.
    

## Exemplo do mundo real

A origem manda todos os contratos do cliente, inclusive os encerrados. A ferramenta devolve o primeiro com status ativo, e é só esse que a automação grava no CustomerX, mantendo a base limpa.

## Fica a dica

Ela devolve apenas o primeiro que casa com a regra. Se você precisa de todos os que casam, a ferramenta certa é o Filter row elements.

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