# Crear

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