Atualizar

Este guia mostrará como editar os dados de uma pessoa dentro do seu fluxo de automação usando a interface visual da Hablla.

A operação Atualizar Pessoa permite modificar os dados de um registro de pessoa existente na sua base da Hablla. Esta ação é essencial para manter as informações de seus contatos sempre corretas e atualizadas, refletindo mudanças de status, novos dados de contato ou qualquer outra informação relevante.

Você pode usar esta operação para alterar informações específicas, como o status de cliente após uma compra, adicionar um novo número de telefone ou atualizar o usuário responsável por um lead.

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 "Atualizar".

3. No campo "ID da Pessoa" (personId), insira o identificador único da pessoa que você deseja atualizar. Este dado é obrigatório e pode ser obtido de etapas anteriores do fluxo.

4. Escolha como deseja fornecer os novos 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 para atualizar uma pessoa. Você precisa preencher apenas os campos que deseja alterar.

Campo	Tipo	Obrigatório?	Descrição
ID da Pessoa	Texto	✅ Sim	O ID único da pessoa a ser atualizada.
Nome	Texto	❌ Não	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	❌ Não	Define a base legal do contato. Opções: unknown, granted, interest, pre-existing, legal, protection, public.
Status do Cliente	Lista de Opções	❌ Não	Classifica a pessoa no funil de vendas. Opções: visitor, lead, marketing_qualified_lead, etc.
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	Adiciona um ou mais telefones. Cada telefone deve conter: Tipo, Telefone e É WhatsApp?.
E-mails	Coleção de Campos	❌ Não	Adiciona um ou mais endereços de e-mail.
Endereços	Coleção de Campos	❌ Não	Adiciona um ou mais endereços.
Campos Personalizados	Chave-Valor	❌ Não	Permite preencher ou alterar valores em campos personalizados.

Exportar para as Planilhas

---

Estrutura (Usando JSON)

Para usuários avançados, é possível fornecer os dados a serem atualizados em um objeto JSON. Lembre-se que o personId é passado diretamente no campo de configuração da operação, não no corpo 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"
  }
}

---

🚀 Exemplo de Caso de Uso

Objetivo: Quando um negócio é movido para a etapa "Ganha" em um funil, atualizar o status da pessoa associada para "Cliente" e adicionar uma tag de "Cliente VIP".

1. Inicie um fluxo com o gatilho "Card Movido", configurado para a etapa "Ganha".

2. Use a operação "Obter Card por ID" para pegar os detalhes do negócio, incluindo o ID da pessoa associada (card.person.id).

3. Adicione o bloco "Pessoas" e selecione a operação "Atualizar".

4. No campo "ID da Pessoa", insira a variável do passo anterior: {{steps.1.result.person.id}}.

5. No campo "Status do Cliente", selecione o valor customer.

6. Adicione um passo seguinte com o bloco "Pessoas", operação "Adicionar Tags", e adicione a tag "Cliente VIP" à mesma pessoa.

Dessa forma, seu processo de vendas fica totalmente sincronizado com os dados dos seus contatos, garantindo que eles reflitam corretamente a jornada do cliente.