Herramienta Obtener un Elemento de una Matriz

La herramienta Obtener un elemento de una matriz es una función que te permite obtener un elemento específico de una matriz por su número de posición. Puedes seleccionar fácilmente el elemento que deseas recibir indicando su número de posición. La numeración de los elementos comienza en 1.

Imagina que tienes una lista de artículos en un pedido, como "Sombrero", "Camiseta", "Pantalón corto". Pero solo necesitas pasar un artículo a tu sistema de CRM. Con esta herramienta, puedes indicar la posición del artículo que necesitas recibir. Por ejemplo, si quieres obtener el segundo artículo de la lista, indica el número de posición (2) y Albato pasará solo "Camiseta" de toda la lista.

Si introduces un número en el campo Posición que está fuera del rango de elementos de la lista (por ejemplo, la lista tiene tres elementos, pero introduces 0, -1 o 5), ocurrirá un error en el registro de la herramienta con el mensaje "El número introducido no coincide con el número de elementos en la matriz".

Ejemplo 1

La conexión automática recibirá datos de la tarjeta de Trello y los pasará a HubSpot, donde se crearán usuarios y sus pedidos para el primer artículo de la tarjeta.

Asegúrate de que Trello y HubSpot estén conectados a Albato.

Para comenzar, haz clic en el botón New (Nuevo). Configura el primer paso.

Elige una aplicación de origen, especifica un disparador y añade tu conexión.

Añade la herramienta antes de continuar con el siguiente paso de tu conexión automática. Para ello, haz clic en "+" y selecciona la herramienta que necesitas de la lista.

Ahora es momento de completar los campos.

Añade y configura el siguiente paso de tu escenario — acción.

Elige una aplicación, especifica una acción y añade tu conexión.

Pasaremos el primer elemento. Puedes seleccionar cualquier elemento de la lista que necesites.

¡Tu conexión automática está lista! No olvides ejecutarla.

Ejemplo 2. Extracción de un Número de Teléfono de una Matriz en Pipedrive

En este ejemplo, configurarás una conexión automática que detecta cuando un negocio se marca como perdido en Pipedrive, recupera la información de contacto, extrae un único número de teléfono de la matriz de teléfonos y luego actualiza o crea el contacto en RD Station.

La estructura de la conexión automática es la siguiente:

Actualización de Negocio → Encontrar Cliente por ID → Obtener un elemento de una matriz → Enrutador → Encontrar Lead → Enrutador → Crear/Actualizar contacto → Crear evento

Paso 1. Configurar el disparador

Crea una nueva conexión automática y añade un nuevo disparador: Pipedrive → Actualización de Negocio

Luego configura el filtro:

• Campo → Estado del negocio
• Condición → Igual a
• Valor → perdido

Esto asegura que la conexión automática se ejecute solo cuando un negocio se marque como perdido.

En esta etapa, el sistema recibe los datos del negocio, incluido el ID de la Persona relacionada con el negocio.

Paso 2. Añadir una acción para recuperar detalles del contacto

Añade un nuevo paso: Pipedrive → Encontrar Cliente por ID

En Configuración de campos, configura:

• El ID de la persona (obligatorio) → Selecciona Actualización de Negocio → ID de Persona

Esta acción recupera los datos completos del contacto de Pipedrive. Entre los campos devueltos están:

• Correo electrónico principal
• Números de teléfono

Importante: el campo Números de teléfono se devuelve como una matriz, incluso si el contacto tiene solo un número de teléfono.

Estructura de ejemplo:

Números de teléfono:

• +123456789
• +987654321

En esta etapa, el número de teléfono no puede pasarse directamente a RD Station si ese campo espera un único valor.

Paso 3. Añadir la herramienta para extraer un número de teléfono

Añade un nuevo paso y selecciona: Herramienta → Obtener un elemento de una matriz

En la configuración, configúralo de la siguiente manera:

• Elemento → Primer elemento
• Elemento de la sección de fila → Selecciona Encontrar Cliente por ID → Números de teléfono → Teléfono

Esta herramienta recibe la matriz completa de números de teléfono y extrae solo el primer elemento.

• Si existen varios números de teléfono, solo se devuelve el primero.
• Si solo existe un número, se devuelve ese valor.

El resultado de este paso es un único valor de cadena que puede usarse de forma segura en las siguientes acciones.

Si introduces un número de posición que no existe en la matriz (por ejemplo, 5 cuando solo existen 2 elementos), el registro de la conexión automática mostrará el error: "El número introducido no coincide con el número de elementos en la matriz."

Paso 4. Añadir un Enrutador para validar los datos

Añade un paso de Enrutador para controlar el flujo.

Aquí puedes configurar condiciones para verificar:

• Si existen los campos obligatorios
• Si el campo de correo electrónico no está vacío
• O cualquier otra condición necesaria antes de continuar

Esto evita errores en los siguientes pasos.

Paso 5. Añadir la acción para encontrar el lead en RD Station

Añade el siguiente paso: RD Station → Encontrar Lead

En Configuración de campos, configura:

• Correo electrónico (obligatorio) → Selecciona Encontrar Cliente por ID → Correo electrónico principal

Este paso verifica si el contacto ya existe en RD Station.

El número de teléfono extraído en el Paso 3 se utilizará más adelante al crear o actualizar el contacto.

Paso 6. Añadir un segundo Enrutador

Añade otro Enrutador para determinar el siguiente camino:

• Si el lead existe → continuar con la actualización
• Si el lead no existe → continuar con la creación

Esto evita la creación de contactos duplicados.

Paso 7. Añadir la acción para crear o actualizar el contacto

Añade el paso: RD Station → Crear/Actualizar contacto

En Configuración de campos, configura:

• Correo electrónico → del Paso 2 (Correo electrónico principal)
• Teléfono → del Paso 3 (salida de Obtener un elemento de una matriz)

Como el número de teléfono se ha convertido de una matriz en un único valor de cadena, RD Station ahora puede aceptarlo correctamente.

Paso 8. Añadir la acción final

Añade la acción: RD Station → Crear evento "Marcar oportunidad como perdida"

Esto registra la oportunidad perdida dentro de RD Station.

Conclusión

En esta conexión automática, Pipedrive devuelve números de teléfono como una matriz, incluso cuando solo hay un número de teléfono. RD Station, sin embargo, espera un único valor.

Al añadir la herramienta Obtener un elemento de una matriz, extraes un valor específico de la matriz y lo conviertes en una cadena única que puede pasarse de forma segura al siguiente paso.

Este escenario ocurre frecuentemente cuando se trabaja con campos de múltiples valores, como números de teléfono, correos electrónicos, artículos de pedidos o campos personalizados.

La herramienta te permite extraer:

• el primer elemento
• el último elemento
• o un elemento específico por posición

La numeración siempre comienza en 1.