Obtener por ID

Con esta operación, la automatización puede buscar los datos de una persona usando su ID y utilizar esa información en otros bloques del flujo.

La operación Obtener Persona por ID recupera toda la información de un registro de persona específico, utilizando su identificador único (personId).

Esta acción es una de las más utilizadas en automatizaciones, ya que permite cargar los datos de un contacto conocido para utilizarlos en pasos posteriores, como personalizar un mensaje, tomar decisiones basadas en sus datos (ej: estado del cliente) o simplemente verificar su información.

El resultado de esta operación es un objeto completo que contiene todos los campos de la persona, incluidos campos personalizados.

Cómo Configurar

1. En Hablla Studio, agregue el bloque "Personas" a su flujo de automatización.

2. En el campo "Operación", seleccione la opción "Obtener por ID".

3. En el campo "ID de la Persona" (personId), ingrese el identificador único de la persona que desea consultar. Este valor generalmente se obtiene de un disparador o de un paso anterior del flujo.

---

Parámetros

Campo	Tipo	¿Obligatorio?	Descripción
ID de la Persona	Texto	✅ Sí	El ID único de la persona a consultar.
Popular Datos de la Persona	Booleano (Sí/No)	❌ No	Si se establece en true, la búsqueda puede devolver datos relacionados adicionales, como información detallada de organizaciones u otros registros asociados.

Exportar a las Hojas de Cálculo

---

Estructura de Salida (Ejemplo de Resultado)

Después de la ejecución, el resultado de este bloque será un objeto JSON con la estructura a continuación, que puede ser accedido en pasos siguientes (ej: {{steps.1.result}}):

JSON

{
  "id": "person_abcdef123456",
  "name": "Juliana Souza",
  "about": "Gerente de Marketing en la Empresa Ejemplo.",
  "photo_url": "https://example.com/juliana.jpg",
  "privacy": "granted",
  "customer_status": "customer",
  "is_blocked": false,
  "created_at": "2023-10-26T10:00:00Z",
  "updated_at": "2024-08-16T15:30:00Z",
  "users": [
    {
      "id": "user_xyz789",
      "name": "Carlos Andrade"
    }
  ],
  "phones": [
    {
      "type": "business",
      "phone": "[phone]",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "[email protected]"
    }
  ],
  "custom_fields": {
    "data_ultima_reuniao": "2024-08-10",
    "nivel_satisfacao": "Muy Satisfecha"
  }
}

---

🚀 Ejemplo de Caso de Uso

Objetivo: Enviar un correo de bienvenida personalizado a un nuevo cliente tan pronto como un negocio se marque como "Ganado".

1. Cree un flujo con el disparador "Tarjeta Movida", configurado para la etapa "Ganada" de su embudo de ventas. El disparador proporcionará el cardId y el personId asociado.

2. Agregue el bloque "Personas" con la operación "Obtener por ID".

3. En el campo "ID de la Persona", ingrese la variable correspondiente del disparador (ej: {{trigger.person.id}}).

4. Agregue un bloque de envío de correo en el paso siguiente.

5. En el cuerpo del correo, personalice el saludo usando los datos obtenidos en el paso anterior. Por ejemplo: "Hola, {{steps.2.result.name}}! Bienvenido(a) a nuestra empresa."

De esta manera, utiliza los datos en tiempo real de la persona para crear una comunicación mucho más personal y eficaz, de forma totalmente automatizada.