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


---

# 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/atualizar.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.