Ferramenta Obter um Elemento de uma Matriz

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

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.

Agora é hora de preencher os campos.

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.

Passaremos o primeiro elemento. Você pode selecionar qualquer elemento da lista que precisar.

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

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

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

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

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.