# Atualizar

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": "+5511988887777",
      "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.