# Criar ou Atualizar

A operação Criar ou Atualizar Pessoa é uma funcionalidade poderosa para gerenciar contatos de forma inteligente, evitando a criação de duplicatas.

O sistema utiliza os campos de identificação única (como e-mail ou telefone) para verificar se a pessoa já existe na base.

* Se a pessoa for encontrada, seus dados serão atualizados com as informações fornecidas.
* Se a pessoa não for encontrada, um novo registro será criado.

Esta ação é ideal para integrações com outras plataformas, onde os dados de contato são enviados repetidamente e você precisa garantir a consistência da sua base.

#### 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 ou Atualizar".
3. Preencha os campos com os dados da pessoa. É crucial fornecer pelo menos um identificador único (E-mail ou Telefone) para que a busca funcione.
4. Defina o campo "Regra" (`rule`) para determinar como o sistema deve se comportar caso encontre múltiplos registros com os mesmos dados.

***

### Parâmetros (Usando Campos)

| Campo                 | Tipo              | Obrigatório? | Descrição                                                                                                                                                           |
| --------------------- | ----------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Regra (`rule`)        | Lista de Opções   | ✅ Sim        | Define qual registro atualizar caso mais de um seja encontrado. Opções: `older` (atualiza o mais antigo) ou `newest` (atualiza o mais recente). O padrão é `older`. |
| Nome                  | Texto             | ✅ Sim        | O nome completo da pessoa.                                                                                                                                          |
| Privacidade           | Lista de Opções   | ✅ Sim        | Define a base legal do contato. Opções: `granted`, `interest`, etc.                                                                                                 |
| Status do Cliente     | Lista de Opções   | ✅ Sim        | Classifica a pessoa no funil de vendas. Opções: `visitor`, `lead`, `customer`, etc.                                                                                 |
| E-mails               | Coleção de Campos | ✅ Sim        | Forneça pelo menos um e-mail. Este campo é usado para encontrar a pessoa existente.                                                                                 |
| Telefones             | Coleção de Campos | ❌ Não        | Forneça um ou mais telefones. Este campo também é usado para encontrar a pessoa existente.                                                                          |
| 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.                                                                                                                           |
| Responsável (Owner)   | Lista de Usuários | ❌ Não        | Associa ou altera os usuários responsáveis por esta pessoa.                                                                                                         |
| Endereços             | Coleção de Campos | ❌ Não        | Adiciona ou atualiza os endereços da pessoa.                                                                                                                        |
| Campos Personalizados | Chave-Valor       | ❌ Não        | Preenche ou altera valores nos campos personalizados.                                                                                                               |

Exportar para as Planilhas

> ⚠️ Importante: Para que a funcionalidade de "Atualizar" funcione corretamente, você deve fornecer pelo menos um dos campos de identificação: E-mails ou Telefones.

***

### Estrutura (Usando JSON)

O corpo JSON permite fornecer todos os dados de uma vez. A lógica de busca e a regra de atualização serão aplicadas com base nos dados enviados.

JSON

```
{
  "rule": "newest",
  "name": "Maria Oliveira",
  "customer_status": "opportunity",
  "privacy": "granted",
  "emails": [
    {
      "email": "maria.oliveira@example.com"
    }
  ],
  "phones": [
    {
      "type": "personal",
      "phone": "+5521999991234",
      "is_whatsapp": true
    }
  ],
  "custom_fields": {
    "produto_interesse": "Plano Premium",
    "score": 85
  }
}
```

***

### 🚀 Exemplo de Caso de Uso

Objetivo: Sincronizar uma lista de contatos de uma plataforma de automação de marketing (ex: RD Station, Mailchimp) com a Hablla, sem gerar contatos duplicados.

1. Crie um fluxo que é executado periodicamente (ex: a cada 24 horas).
2. Nesse fluxo, adicione uma etapa que busca os contatos atualizados recentemente na plataforma de marketing.
3. Use um laço (`loop`) para processar cada contato retornado pela plataforma.
4. Dentro do laço, adicione o bloco "Pessoas" com a operação "Criar ou Atualizar".
5. Mapeie os campos do contato vindo da plataforma externa (nome, email, telefone, etc.) para os parâmetros da ação na Hablla.
6. Defina a Regra como `newest` para garantir que, se houver duplicatas na sua base, a mais recente seja sempre a atualizada.

Ao executar este fluxo, sua base na Hablla será enriquecida com novos contatos e atualizada com as informações mais recentes, mantendo-a limpa e sem duplicidade.


---

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