> 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/crear.md).

# Crear

En esta guía, aprenderás a usar el componente visual de Hablla para crear una nueva persona dentro de tu flujo de automatización.

La operación Crear Persona permite registrar un nuevo individuo (como un lead, cliente o contacto) en tu base de Hablla. Esta acción es fundamental para centralizar la información de contacto e iniciar la gestión de la relación mediante automatizaciones.

Al crear una persona, puedes especificar todos sus datos principales, como nombre, estado de cliente, información de contacto y campos personalizados, asegurando que el registro ya nazca completo y listo para ser utilizado en otros flujos.

#### Cómo Configurar

1. En Hablla Studio, agregue el bloque "Personas" a su flujo de automatización.
2. En el campo "Operación", selecciona la opción "Crear".
3. Elige cómo deseas proporcionar los datos: "Usando Campos" para la interfaz visual o "Usando JSON" para mayor flexibilidad.

***

### Parámetros (Usando Campos)

A continuación están todos los campos disponibles al configurar la creación de una nueva persona.

| Campo                    | Tipo                | ¿Obligatorio? | Descripción                                                                                                                                                                             |
| ------------------------ | ------------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nombre                   | Texto               | ✅ Sí          | El nombre completo de la persona.                                                                                                                                                       |
| Acerca de                | Texto Largo         | ❌ No          | Un campo abierto para anotaciones o una biografía sobre la persona.                                                                                                                     |
| URL de la Foto de Perfil | Texto               | ❌ No          | El enlace a la imagen de perfil de la persona.                                                                                                                                          |
| Privacidad               | Lista de Opciones   | ✅ Sí          | Define la base legal del contacto. Opciones: `unknown`, `granted`, `interest`, `pre-existing`, `legal`, `protection`, `public`.                                                         |
| Estado del Cliente       | Lista de Opciones   | ✅ Sí          | Clasifica a la persona en el embudo de ventas. Opciones: `visitor`, `lead`, `marketing_qualified_lead`, `sales_qualified_lead`, `opportunity`, `customer`, `evangelist`, `ex_customer`. |
| Responsable (Owner)      | Lista de Usuarios   | ❌ No          | Permite asociar uno o más usuarios de la plataforma como responsables de esa persona.                                                                                                   |
| Teléfonos                | Colección de Campos | ❌ No          | Una lista de uno o más teléfonos asociados. Cada teléfono debe contener: `Tipo` (Personal o Business), `Teléfono` (el número) y `¿Es WhatsApp?` (sí/no).                                |
| Correos                  | Colección de Campos | ❌ No          | Una lista con uno o más correos electrónicos.                                                                                                                                           |
| Direcciones              | Colección de Campos | ❌ No          | Una lista de direcciones. Cada dirección puede contener: `Código postal`, `País`, `Calle`, `Número`, `Complemento`, `Barrio`, `Ciudad` y `Estado`.                                      |
| Campos Personalizados    | Clave-Valor         | ❌ No          | Permite completar los campos personalizados que fueron creados en la plataforma para la entidad "Persona".                                                                              |

Exportar a las Hojas de Cálculo

***

### Estructura (Usando JSON)

Para usuarios avanzados, es posible proporcionar todos los datos en un único objeto JSON. Esta es la estructura base:

JSON

```
{
  "name": "João da Silva",
  "about": "Lead interesado en el producto X. Vino de la campaña de marketing de agosto.",
  "photo_url": "https://example.com/photo.jpg",
  "privacy": "granted",
  "customer_status": "lead",
  "users": [
    "user_id_1",
    "user_id_2"
  ],
  "phones": [
    {
      "type": "personal",
      "phone": "+5511999998888",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "joao.silva@example.com"
    }
  ],
  "addresses": [
    {
      "zip_code": "01001-000",
      "country": "Brasil",
      "street": "Praça da Sé",
      "number": "100",
      "complement": "Lado A",
      "neighborhood": "Sé",
      "city": "São Paulo",
      "state": "SP"
    }
  ],
  "custom_fields": {
    "origem_do_lead": "Website",
    "score": 50
  }
}
```

***

### 🚀 Ejemplo de Caso de Uso

Objetivo: Registrar un nuevo lead en Hablla cada vez que se complete un formulario de "Pide una Demostración" en el sitio web.

1. Crea un disparador en tu flujo que reciba los datos del formulario vía Webhook.
2. Agrega el bloque "Personas" y selecciona la operación "Crear".
3. Mapea los campos recibidos del formulario a los parámetros de la acción "Crear Persona":
   * `Nombre` ← `dados.webhook.nome`
   * `Correos` ← `dados.webhook.email`
   * `Teléfonos` ← `dados.webhook.telefone`
4. Define un valor fijo para el campo Estado del Cliente como `"lead"`.
5. Asocia un usuario específico en el campo Responsable para que reciba la notificación del nuevo lead.

Con esto, cada nuevo envío del formulario creará automáticamente una nueva persona en la plataforma, con el estado y el responsable ya definidos, lista para que el equipo comercial actúe.


---

# 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/crear.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.