Crear o Actualizar

Con esta operación, la automatización verifica si la persona ya existe en el sistema basándose en el teléfono y correo electrónico: Si existe, los datos serán actualizados. Si no existe, se creará una nueva persona.

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": "[email protected]"
    }
  ],
  "phones": [
    {
      "type": "personal",
      "phone": "[phone]",
      "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.