# Criar

A operação Criar Pessoa permite registrar um novo indivíduo (como um lead, cliente ou contato) na sua base da Hablla. Esta ação é fundamental para centralizar as informações de contato e iniciar o gerenciamento do relacionamento através de automações.

Ao criar uma pessoa, você pode especificar todos os seus dados principais, como nome, status de cliente, informações de contato e campos personalizados, garantindo que o registro já nasça completo e pronto para ser utilizado em outros fluxos.

#### Como Configurar

1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação.
2. No campo "Operação", selecione a opção "Criar".
3. Escolha como deseja fornecer os dados: "Usando Campos" para a interface visual ou "Usando JSON" para maior flexibilidade.

***

### Parâmetros (Usando Campos)

Abaixo estão todos os campos disponíveis ao configurar a criação de uma nova pessoa.

| Campo                 | Tipo              | Obrigatório? | Descrição                                                                                                                                                                      |
| --------------------- | ----------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Nome                  | Texto             | ✅ Sim        | O nome completo da pessoa.                                                                                                                                                     |
| Sobre                 | Texto Longo       | ❌ Não        | Um campo aberto para anotações ou uma biografia sobre a pessoa.                                                                                                                |
| URL da Foto de Perfil | Texto             | ❌ Não        | O link para a imagem de perfil da pessoa.                                                                                                                                      |
| Privacidade           | Lista de Opções   | ✅ Sim        | Define a base legal do contato. Opções: `unknown`, `granted`, `interest`, `pre-existing`, `legal`, `protection`, `public`.                                                     |
| Status do Cliente     | Lista de Opções   | ✅ Sim        | Classifica a pessoa no funil de vendas. Opções: `visitor`, `lead`, `marketing_qualified_lead`, `sales_qualified_lead`, `opportunity`, `customer`, `evangelist`, `ex_customer`. |
| Responsável (Owner)   | Lista de Usuários | ❌ Não        | Permite associar um ou mais usuários da plataforma como responsáveis por essa pessoa.                                                                                          |
| Telefones             | Coleção de Campos | ❌ Não        | Uma lista de um ou mais telefones associados. Cada telefone deve conter: `Tipo` (Personal ou Business), `Telefone` (o número) e `É WhatsApp?` (sim/não).                       |
| E-mails               | Coleção de Campos | ❌ Não        | Uma lista com um ou mais endereços de e-mail.                                                                                                                                  |
| Endereços             | Coleção de Campos | ❌ Não        | Uma lista de endereços. Cada endereço pode conter: `CEP`, `País`, `Rua`, `Número`, `Complemento`, `Bairro`, `Cidade` e `Estado`.                                               |
| Campos Personalizados | Chave-Valor       | ❌ Não        | Permite preencher os campos personalizados que foram criados na plataforma para a entidade "Pessoa".                                                                           |

Exportar para as Planilhas

***

### Estrutura (Usando JSON)

Para usuários avançados, é possível fornecer todos os dados em um único objeto JSON. Esta é a estrutura base:

JSON

```
{
  "name": "João da Silva",
  "about": "Lead interessado no produto X. Veio da campanha 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": "+5511999998888",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "joao.silva@example.com"
    }
  ],
  "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
  }
}
```

***

### 🚀 Exemplo de Caso de Uso

Objetivo: Cadastrar um novo lead na Hablla sempre que um formulário de "Peça uma Demonstração" for preenchido no site.

1. Crie um gatilho no seu fluxo que recebe os dados do formulário via Webhook.
2. Adicione o bloco "Pessoas" e selecione a operação "Criar".
3. Mapeie os campos recebidos do formulário para os parâmetros da ação "Criar Pessoa":
   * `Nome` ← `dados.webhook.nome`
   * `E-mails` ← `dados.webhook.email`
   * `Telefones` ← `dados.webhook.telefone`
4. Defina um valor fixo para o campo Status do Cliente como `"lead"`.
5. Associe um usuário específico no campo Responsável para que ele receba a notificação do novo lead.

Com isso, a cada novo envio no formulário, uma nova pessoa será criada automaticamente na plataforma, com o status e o responsável já definidos, pronta para o time comercial agir.


---

# 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/fluxos-de-automacoes/todos-os-componentes/hablla/pessoas/criar.md?ask=<question>
```

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.