---
title: "Obter um elemento de um array"
description: "Pega um item da lista pela posição: o primeiro, o segundo, o último."
url: https://ajuda.customerx.com.br/pt-br/articles/198-obter-um-elemento-de-um-array
collection: "Ferramentas"
updated: 2026-06-08
language: pt-br
---

# Obter um elemento de um array

Pega um item da lista pela posição: o primeiro, o segundo, o último.

Pega um item da lista pela posição: o primeiro, o segundo, o último.

> **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 o termo: array é lista. Esta ferramenta entra quando você não precisa da lista inteira, só de um item em uma posição conhecida, geralmente o primeiro. Em vez de tratar tudo, ela pinça aquele item e segue o fluxo só com ele.

## Quando usar no dia a dia de CS

-   O sistema manda vários e-mails do contato e você quer gravar só o primeiro como principal.
    
-   De uma lista de registros, interessa apenas o mais recente (ou o primeiro).
    
-   Evitar um Iterador completo quando um único item resolve.
    

## Como configurar, passo a passo

1.  Clique no sinal de mais entre as etapas e escolha **Ferramenta**, depois **Obter um elemento de um array** e **Selecionar**.
    
2.  Indique o campo da lista e a posição do item desejado (1º, 2º...).
    
3.  Use o item escolhido nas etapas seguintes.
    

## Exemplo do mundo real

O app de origem manda uma lista com três e-mails do contato. A ferramenta pega o primeiro, e é esse que a automação grava como e-mail principal no CustomerX.

## Fica a dica

Posição é cega: o "primeiro" pode não ser o melhor. Se a escolha depende de uma regra ("o e-mail corporativo", "o contrato ativo"), use o Obter elemento da linha, que escolhe por condição.

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