> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/hablla/personas/obtener-por-id.md).

# Obtener por ID

Con esta operación, la automatización puede buscar los datos de una persona usando su ID y utilizar esta 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": "+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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.