Crear

En esta guía, aprenderá a usar el componente visual de Hablla para crear una nueva persona dentro de su flujo de automatización.

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": "[phone]",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "[email protected]"
    }
  ],
  "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.