# 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. --- # 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-o-actualizar.md?ask= ``` 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.