# Obtener por ID

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": "+5511977775555",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "juliana.souza@example.com"
    }
  ],
  "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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hablla.com/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/hablla/personas/obtener-por-id.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.