Criar ou Atualizar

Com essa operação, a automação verifica se a pessoa já existe no sistema baseado no telefone e e-mail: Se existir, os dados serão atualizados. Se não existir, será criada uma nova pessoa.

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": "[email protected]"
    }
  ],
  "phones": [
    {
      "type": "personal",
      "phone": "[phone]",
      "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.