Create

In this guide, you will learn how to use Hablla's visual component to create a new person within your automation flow.

The Create Person operation allows registering a new individual (such as a lead, customer, or contact) in your Hablla database. This action is essential to centralize contact information and start relationship management through automations.

When creating a person, you can specify all their main data, such as name, customer status, contact information, and custom fields, ensuring the record is complete from the start and ready to be used in other flows.

How to Configure

1. In Hablla Studio, add the "People" block to your automation flow.

2. In the "Operation" field, select the "Create" option.

3. Choose how you want to provide the data: "Using Fields" for the visual interface or "Using JSON" for greater flexibility.

---

Parameters (Using Fields)

Below are all the fields available when configuring the creation of a new person.

Field	Type	Required?	Description
Full name	Text	✅ Yes	The person's full name.
About	Long Text	❌ No	An open field for notes or a biography about the person.
Profile Photo URL	Text	❌ No	The link to the person's profile image.
Privacy	Options List	✅ Yes	Defines the contact's legal basis. Options: unknown, granted, interest, pre-existing, legal, protection, public.
Customer Status	Options List	✅ Yes	Classifies the person in the sales funnel. Options: visitor, lead, marketing_qualified_lead, sales_qualified_lead, opportunity, customer, evangelist, ex_customer.
Responsible (Owner)	User List	❌ No	Allows associating one or more platform users as responsible for this person.
Phones	Fields Collection	❌ No	A list of one or more phones associated. Each phone must contain: Type (Personal or Business), Phone (the number) and Is WhatsApp? (yes/no).
Emails	Fields Collection	❌ No	A list of one or more email addresses.
Addresses	Fields Collection	❌ No	A list of addresses. Each address can contain: ZIP code, Country, Street, Number, Complement, Neighborhood, City and State.
Custom Fields	Key-Value	❌ No	Allows filling the custom fields that were created on the platform for the "Person" entity.

Export to Spreadsheets

---

Structure (Using JSON)

For advanced users, it is possible to provide all data in a single JSON object. This is the base structure:

JSON

{
  "name": "João da Silva",
  "about": "Lead interested in product X. Came from the August marketing campaign.",
  "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": "Brazil",
      "street": "Praça da Sé",
      "number": "100",
      "complement": "Side A",
      "neighborhood": "Sé",
      "city": "São Paulo",
      "state": "SP"
    }
  ],
  "custom_fields": {
    "lead_source": "Website",
    "score": 50
  }
}

---

🚀 Example Use Case

Goal: Register a new lead in Hablla whenever a "Request a Demo" form is submitted on the website.

1. Create a trigger in your flow that receives the form data via Webhook.

2. Add the "People" block and select the "Create" operation.

3. Map the fields received from the form to the parameters of the "Create Person" action:

   • Full name ← data.webhook.name

   • Emails ← data.webhook.email

   • Phones ← data.webhook.phone

4. Set a fixed value for the Customer Status field as "lead".

5. Associate a specific user in the Responsible field so they receive the notification of the new lead.

With this, for each new form submission, a new person will be automatically created in the platform, with the status and responsible already defined, ready for the commercial team to act.