Criar

Neste guia, você aprenderá a usar o componente visual da Hablla para criar uma nova pessoa dentro do seu fluxo de automação.

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": "[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
  }
}

---

🚀 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.