# Crear o Actualizar

La operación Crear o Actualizar Persona es una funcionalidad poderosa para gestionar contactos de forma inteligente, evitando la creación de duplicados.

El sistema utiliza los campos de identificación única (como correo electrónico o teléfono) para verificar si la persona ya existe en la base.

* Si se encuentra la persona, sus datos serán actualizados con la información proporcionada.
* Si no se encuentra la persona, se creará un nuevo registro.

Esta acción es ideal para integraciones con otras plataformas, donde los datos de contacto se envían repetidamente y necesitas garantizar la consistencia de tu base.

#### 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 o Actualizar".
3. Rellena los campos con los datos de la persona. Es crucial proporcionar al menos un identificador único (Correo electrónico o Teléfono) para que la búsqueda funcione.
4. Define el campo "Regla" (`rule`) para determinar cómo debe comportarse el sistema en caso de encontrar múltiples registros con los mismos datos.

***

### Parámetros (Usando Campos)

| Campo                    | Tipo                | ¿Obligatorio? | Descripción                                                                                                                                                                                  |
| ------------------------ | ------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Regla (`rule`)           | Lista de Opciones   | ✅ Sí          | Define qué registro actualizar en caso de que se encuentre más de uno. Opciones: `older` (actualiza el más antiguo) o `newest` (actualiza el más reciente). El valor por defecto es `older`. |
| Nombre                   | Texto               | ✅ Sí          | El nombre completo de la persona.                                                                                                                                                            |
| Privacidad               | Lista de Opciones   | ✅ Sí          | Define la base legal del contacto. Opciones: `granted`, `interest`, etc.                                                                                                                     |
| Estado del Cliente       | Lista de Opciones   | ✅ Sí          | Clasifica a la persona en el embudo de ventas. Opciones: `visitor`, `lead`, `customer`, etc.                                                                                                 |
| Correos                  | Colección de Campos | ✅ Sí          | Proporciona al menos un correo electrónico. Este campo se usa para encontrar a la persona existente.                                                                                         |
| Teléfonos                | Colección de Campos | ❌ No          | Proporciona uno o más teléfonos. Este campo también se usa para encontrar a la persona existente.                                                                                            |
| 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.                                                                                                                                               |
| Responsable (Owner)      | Lista de Usuarios   | ❌ No          | Asocia o cambia los usuarios responsables de esta persona.                                                                                                                                   |
| Direcciones              | Colección de Campos | ❌ No          | Añade o actualiza las direcciones de la persona.                                                                                                                                             |
| Campos Personalizados    | Clave-Valor         | ❌ No          | Rellena o cambia valores en los campos personalizados.                                                                                                                                       |

Exportar a las Hojas de Cálculo

> ⚠️ Importante: Para que la funcionalidad de "Actualizar" funcione correctamente, debes proporcionar al menos uno de los campos de identificación: Correos electrónicos o Teléfonos.

***

### Estructura (Usando JSON)

El cuerpo JSON permite proporcionar todos los datos a la vez. La lógica de búsqueda y la regla de actualización se aplicarán en base a los datos enviados.

JSON

```
{
  "rule": "newest",
  "name": "Maria Oliveira",
  "customer_status": "opportunity",
  "privacy": "granted",
  "emails": [
    {
      "email": "maria.oliveira@example.com"
    }
  ],
  "phones": [
    {
      "type": "personal",
      "phone": "+5521999991234",
      "is_whatsapp": true
    }
  ],
  "custom_fields": {
    "produto_interesse": "Plano Premium",
    "score": 85
  }
}
```

***

### 🚀 Ejemplo de Caso de Uso

Objetivo: Sincronizar una lista de contactos de una plataforma de automatización de marketing (ej: RD Station, Mailchimp) con Hablla, sin generar contactos duplicados.

1. Crea un flujo que se ejecute periódicamente (ej: cada 24 horas).
2. En ese flujo, añade un paso que busque los contactos actualizados recientemente en la plataforma de marketing.
3. Usa un bucle (`loop`) para procesar cada contacto devuelto por la plataforma.
4. Dentro del bucle, añade el bloque "Personas" con la operación "Crear o Actualizar".
5. Mapea los campos del contacto proveniente de la plataforma externa (nombre, email, teléfono, etc.) a los parámetros de la acción en Hablla.
6. Define la Regla como `newest` para garantizar que, si hay duplicados en tu base, el más reciente sea siempre el actualizado.

Al ejecutar este flujo, tu base en Hablla se enriquecerá con nuevos contactos y se actualizará con la información más reciente, manteniéndola limpia y sin duplicidad.