Actualizar

Esta guía mostrará cómo editar los datos de una persona dentro de su flujo de automatización usando la interfaz visual de Hablla.

La operación Actualizar Persona permite modificar los datos de un registro de persona existente en su base de Hablla. Esta acción es esencial para mantener la información de sus contactos siempre correcta y actualizada, reflejando cambios de estado, nuevos datos de contacto o cualquier otra información relevante.

Puede usar esta operación para cambiar información específica, como el estado de cliente después de una compra, agregar un nuevo número de teléfono o actualizar el usuario responsable de un lead.

Cómo Configurar

1. En Hablla Studio, agregue el bloque "Personas" a su flujo de automatización.

2. En el campo "Operación", seleccione la opción "Actualizar".

3. En el campo "ID de la Persona" (personId), ingrese el identificador único de la persona que desea actualizar. Este dato es obligatorio y puede obtenerse de pasos anteriores del flujo.

4. Elija cómo desea proporcionar los nuevos 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 para actualizar una persona. Solo necesita completar los campos que desea cambiar.

Campo	Tipo	¿Obligatorio?	Descripción
ID de la Persona	Texto	✅ Sí	El ID único de la persona a actualizar.
Nombre	Texto	❌ No	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	❌ No	Define la base legal del contacto. Opciones: unknown, granted, interest, pre-existing, legal, protection, public.
Estado del Cliente	Lista de Opciones	❌ No	Clasifica a la persona en el embudo de ventas. Opciones: visitor, lead, marketing_qualified_lead, etc.
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	Agrega uno o más teléfonos. Cada teléfono debe contener: Tipo, Teléfono y ¿Es WhatsApp?.
Correos	Colección de Campos	❌ No	Agrega uno o más direcciones de correo electrónico.
Direcciones	Colección de Campos	❌ No	Agrega una o más direcciones.
Campos Personalizados	Clave-Valor	❌ No	Permite completar o cambiar valores en campos personalizados.

Exportar a las Hojas de Cálculo

---

Estructura (Usando JSON)

Para usuarios avanzados, es posible proporcionar los datos a actualizar en un objeto JSON. Recuerde que el personId se pasa directamente en el campo de configuración de la operación, no en el cuerpo JSON.

JSON

{
  "name": "João da Silva Santos",
  "customer_status": "customer",
  "phones": [
    {
      "type": "business",
      "phone": "[phone]",
      "is_whatsapp": true
    }
  ],
  "custom_fields": {
    "ultima_compra": "2024-08-15"
  }
}

---

🚀 Ejemplo de Caso de Uso

Objetivo: Cuando un negocio se mueve a la etapa "Ganada" en un embudo, actualizar el estado de la persona asociada a "Cliente" y agregar una etiqueta de "Cliente VIP".

1. Inicie un flujo con el gatillo "Card Movido", configurado para la etapa "Ganada".

2. Use la operación "Obtener Card por ID" para obtener los detalles del negocio, incluyendo el ID de la persona asociada (card.person.id).

3. Agregue el bloque "Personas" y seleccione la operación "Actualizar".

4. En el campo "ID de la Persona", ingrese la variable del paso anterior: {{steps.1.result.person.id}}.

5. En el campo "Estado del Cliente", seleccione el valor customer.

6. Agregue un paso siguiente con el bloque "Personas", operación "Agregar Etiquetas", y añada la etiqueta "Cliente VIP" a la misma persona.

De esta manera, su proceso de ventas queda totalmente sincronizado con los datos de sus contactos, garantizando que reflejen correctamente el recorrido del cliente.