# Ferramenta Obter um Elemento de uma Matriz — Central de Ajuda da Albato Source: https://albato.com/br/wiki/articles/albato-get-an-element-from-an-array-tool Bem-vindo ao Central de Ajuda da Albato Buscar artigos # Ferramenta Obter um Elemento de uma Matriz Última atualização: 22/5/2026 · 1 min de leitura * * * NESTE ARTIGO A ferramenta **Obter um elemento de uma matriz** é um recurso que permite obter um elemento específico de uma matriz pelo número de posição. Você pode selecionar facilmente o elemento desejado indicando seu número de posição. A numeração dos elementos começa em 1. Imagine que você tem uma lista de itens em um pedido, como "Chapéu", "Camiseta", "Shorts". Mas você precisa passar apenas um item para o seu sistema de CRM. Com essa ferramenta, você pode indicar a posição do item que deseja receber. Por exemplo, se quiser obter o segundo item da lista, indique o número de posição (2) e a Albato passará apenas "Camiseta" de toda a lista. Se você inserir um número no campo Posição que esteja fora do intervalo de elementos da lista (por exemplo, a lista tem três elementos, mas você insere 0, -1 ou 5), ocorrerá um erro no log da etapa da ferramenta com a mensagem "O número inserido não corresponde ao número de elementos na matriz". ## Exemplo 1 A conexão automática receberá dados do cartão do [Trello](https://albato.com/br/apps/trello) e os passará para o HubSpot, onde serão criados usuários e seus pedidos para o primeiro item do cartão. Certifique-se de que o Trello e o [HubSpot](https://albato.com/br/apps/hubspot) estejam conectados à Albato. Para começar, clique no botão **New** (Novo). Configure a primeira etapa. Escolha um aplicativo de origem, especifique um gatilho e adicione sua conexão. Example (1).png Adicione a ferramenta antes de prosseguir para a próxima etapa da sua conexão automática. Para isso, clique em "+" e selecione a ferramenta desejada na lista. Trello (2).png Agora é hora de preencher os campos. Trello (3).png Adicione e configure a próxima etapa do seu cenário, ação. Escolha um aplicativo, especifique uma ação e adicione sua conexão. Trello (4).png Passaremos o primeiro elemento. Você pode selecionar qualquer elemento da lista que precisar. Trello (5).png Sua conexão automática está pronta! Não se esqueça de iniciá-la. ## Exemplo 2. Extraindo um Número de Telefone de uma Matriz no Pipedrive Neste exemplo, você irá configurar uma conexão automática que detecta quando um negócio é marcado como perdido no Pipedrive, recupera as informações de contato, extrai um único número de telefone da matriz de telefones e, em seguida, atualiza ou cria o contato no RD Station. A estrutura da conexão automática é a seguinte: Atualização de Negócio → Encontrar Cliente por ID → Obter um elemento de uma matriz → Roteador → Encontrar Lead → Roteador → Criar/Atualizar contato → Criar evento 1.png ### Etapa 1. Configurar o gatilho Crie uma nova conexão automática e adicione um novo gatilho: **Pipedrive → Atualização de Negócio** Em seguida, configure o filtro: - Campo → Status do negócio - Condição → Igual a - Valor → perdido Isso garante que a conexão automática seja executada apenas quando um negócio for marcado como perdido. Nessa etapa, o sistema recebe os dados do negócio, incluindo o **ID da Pessoa** relacionada ao negócio. ### Etapa 2. Adicionar uma ação para recuperar detalhes do contato Adicione uma nova etapa: **Pipedrive → Encontrar Cliente por ID** Em **Configuração dos campos**, configure: - O ID da pessoa (obrigatório) → Selecione **Atualização de Negócio → ID da Pessoa** Essa ação recupera os dados completos do contato no Pipedrive. Entre os campos retornados estão: - E-mail principal - Números de telefone > Importante: o campo **Números de telefone** é retornado como uma matriz, mesmo que o contato tenha apenas um número de telefone. Estrutura de exemplo: Números de telefone: - +123456789 - +987654321 Nessa etapa, o número de telefone não pode ser passado diretamente para o RD Station se esse campo esperar um único valor. ### Etapa 3. Adicionar a ferramenta para extrair um número de telefone Adicione uma nova etapa e selecione: **Ferramenta → Obter um elemento de uma matriz** 2.png 4.png Nas configurações, configure da seguinte forma: - Elemento → Primeiro elemento - Elemento da seção de linha → Selecione **Encontrar Cliente por ID → Números de telefone → Telefone** 3.png Essa ferramenta recebe a matriz completa de números de telefone e extrai apenas o primeiro elemento. - Se existirem vários números de telefone, somente o primeiro será retornado. - Se existir apenas um número, esse valor será retornado. O resultado dessa etapa é um único valor de string que pode ser usado com segurança nas próximas ações. Se você inserir um número de posição que não existe na matriz (por exemplo, 5 quando existem apenas 2 elementos), o log da conexão automática exibirá o erro: "O número inserido não corresponde ao número de elementos na matriz." ### Etapa 4. Adicionar um Roteador para validar os dados Adicione uma etapa de **Roteador** para controlar o fluxo. Aqui você pode configurar condições para verificar: - Se os campos obrigatórios existem - Se o campo de e-mail não está vazio - Ou qualquer outra condição necessária antes de prosseguir Isso evita erros nas próximas etapas. ### Etapa 5. Adicionar a ação para encontrar o lead no RD Station Adicione a próxima etapa: **RD Station → Encontrar Lead** Em **Configuração dos campos**, configure: - E-mail (obrigatório) → Selecione **Encontrar Cliente por ID → E-mail principal** 5.png Essa etapa verifica se o contato já existe no RD Station. O número de telefone extraído na Etapa 3 será usado posteriormente ao criar ou atualizar o contato. ### Etapa 6. Adicionar um segundo Roteador Adicione outro **Roteador** para determinar o próximo caminho: - Se o lead existe → prosseguir para atualização - Se o lead não existe → prosseguir para criação Isso evita a criação de contatos duplicados. ### Etapa 7. Adicionar a ação para criar ou atualizar o contato Adicione a etapa: **RD Station → Criar/Atualizar contato** Em **Configuração dos campos**, configure: - E-mail → da Etapa 2 (E-mail principal) - Telefone → da Etapa 3 (saída de Obter um elemento de uma matriz) Como o número de telefone foi convertido de uma matriz em um único valor de string, o RD Station agora pode aceitá-lo corretamente. ### Etapa 8. Adicionar a ação final Adicione a ação: **RD Station → Criar evento "Marcar oportunidade como perdida"** Isso registra a oportunidade perdida dentro do RD Station. ## Conclusão Nesta conexão automática, o Pipedrive retorna números de telefone como uma matriz, mesmo quando há apenas um número de telefone. O RD Station, no entanto, espera um único valor. Ao adicionar a ferramenta **Obter um elemento de uma matriz**, você extrai um valor específico da matriz e o converte em uma única string que pode ser passada com segurança para a próxima etapa. Esse cenário ocorre frequentemente ao trabalhar com campos de múltiplos valores, como números de telefone, e-mails, itens de pedido ou campos personalizados. A ferramenta permite extrair: - o primeiro elemento - o último elemento - ou um elemento específico por posição A numeração sempre começa em 1. Isso respondeu à sua pergunta?