> 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-correo-electronico.md).

# Obtener por correo electrónico

Con esta operación, la automatización puede localizar el registro de una persona en el sistema solo por el correo electrónico.

La operación Obtener Persona por Correo electrónico localiza un registro de persona en su base de contactos utilizando una dirección de correo electrónico como criterio de búsqueda.

Esta acción es crucial para integraciones con plataformas donde el correo electrónico es el identificador principal, como herramientas de automatización de marketing, sistemas de comercio electrónico, formularios de sitio y plataformas de soporte por correo electrónico.

Si se encuentra un contacto con el correo electrónico exacto, la operación devuelve el objeto completo de la persona, permitiéndole usar sus datos en los pasos siguientes del flujo.

#### 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 Correo electrónico".
3. En el campo "Correo electrónico" (`email`), introduzca la dirección de correo electrónico que desea usar para la búsqueda. Este valor puede ser un texto fijo o, más comúnmente, una variable provista por un activador.

***

### Parámetros

| Campo                        | Tipo  | ¿Obligatorio? | Descripción                                                                     |
| ---------------------------- | ----- | ------------- | ------------------------------------------------------------------------------- |
| Correo electrónico (`email`) | Texto | ✅ Sí          | La dirección de correo electrónico exacta de la persona que se desea localizar. |

### Estructura de Salida (Ejemplo de Resultado)

Si se encuentra una persona, el resultado será un objeto JSON completo, idéntico al devuelto por las otras operaciones de búsqueda.

JSON

```
{
  "id": "person_ghijkl789012",
  "name": "Ana Clara Costa",
  "customer_status": "customer",
  "is_blocked": false,
  "created_at": "2023-09-20T09:15:00Z",
  "phones": [
    {
      "type": "personal",
      "phone": "+5521988887777",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "ana.costa@example.com"
    }
  ]
}
```

***

### 🚀 Ejemplo de Caso de Uso

Objetivo: Cuando un cliente abre un ticket de soporte a través de un formulario en el sitio, buscar su registro en Hablla para verificar si es un cliente del plan "Premium" y, en caso afirmativo, priorizar su atención.

1. Cree un flujo que comience con un activador de Webhook, recibiendo los datos del formulario de soporte (incluido el correo electrónico del cliente).
2. Agregue el bloque "Personas" con la operación "Obtener por Correo electrónico".
3. En el campo "Correo electrónico", introduzca la variable del correo electrónico proveniente del activador (`{{trigger.body.email}}`).
4. Agregue un bloque de Condición (If) para verificar el valor del campo personalizado `plan` en el resultado de la búsqueda: `{{steps.2.result.custom_fields.plano}}` es igual a `Premium`.
   * Si Sí: Agregue un paso para crear el ticket en la plataforma de soporte con la prioridad "Urgente".
   * Si No: Cree el ticket con la prioridad "Normal".

Con esta automatización, utiliza los datos que ya posee sobre sus clientes para ofrecer un servicio diferenciado y más eficiente, sin ningún esfuerzo manual.


---

# 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-correo-electronico.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.