PIPEDRIVE_PERSON_CREATE - Criar Pessoa no Pipedrive

O que é este Node?

O PIPEDRIVE_PERSON_CREATE é o node responsável por criar novos contatos (pessoas) no Pipedrive CRM, permitindo adicionar clientes e prospects ao seu banco de dados.

Por que este Node existe?

Gerenciar contatos de forma centralizada é fundamental para vendas. O PIPEDRIVE_PERSON_CREATE existe para:

Centralização de Contatos: Cadastrar automaticamente pessoas que interagem via WhatsApp
Base de Dados: Construir base de contatos qualificados
Vinculação: Criar pessoas para posteriormente vincular a deals e organizações
Histórico: Manter histórico completo de interações com cada pessoa

Como funciona internamente?

Quando o PIPEDRIVE_PERSON_CREATE é executado, o sistema:

Recebe dados: Coleta nome, email, telefone, organização, etc.
Processa variáveis: Substitui variáveis do contexto
Monta payload: Cria objeto com dados da pessoa
Autentica: Usa apiToken e companyDomain
Faz requisição POST: Envia para /api/v1/persons
Retorna ID: Pipedrive responde com ID da pessoa criada
Salva na variável: Armazena resposta completa

Código interno (pipedrive.executor.ts:44-47):

if (operation === 'create') {
  const person = JSON.parse(this.replaceVariables(JSON.stringify(node.data.person), context.variables));
  const response = await axios.post(`${endpoint}?${authParam}`, person, { headers });
  result = response.data;
}

Quando você DEVE usar este Node?

Use PIPEDRIVE_PERSON_CREATE sempre que precisar cadastrar novo contato:

Casos de uso

Primeiro contato: Cliente inicia conversa e é cadastrado automaticamente
Formulário de cadastro: Coleta dados via WhatsApp e cria pessoa
Lead qualificado: Após qualificação, criar pessoa para futura conversão em deal
Integração omnichannel: Sincronizar contatos de outros canais

Quando NÃO usar PIPEDRIVE_PERSON_CREATE

Pessoa já existe: Use PIPEDRIVE_PERSON_UPDATE para atualizar
Não sabe se existe: Use PIPEDRIVE_PERSON_SEARCH primeiro
Apenas criar deal: Pode criar deal sem pessoa se necessário

Parâmetros Detalhados

person.name (string, obrigatório)

O que é: Nome completo da pessoa.

Exemplo: "João Silva", "{{customer_name}}"

Flow completo para testar:

{
  "name": "Teste Pipedrive - Criar Pessoa",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "input_1",
      "type": "input",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Nome",
        "parameters": {
          "message": "Qual é o seu nome?",
          "variableName": "name"
        }
      }
    },
    {
      "id": "pipedrive_1",
      "type": "pipedrive",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Criar Pessoa",
        "resource": "persons",
        "operation": "create",
        "config": {
          "apiToken": "{{pipedrive_token}}",
          "companyDomain": "sua-empresa"
        },
        "person": {
          "name": "{{name}}"
        },
        "responseVariable": "pessoa_criada"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 700, "y": 100 },
      "data": {
        "label": "Confirmar",
        "parameters": {
          "message": "Cadastro criado! ID: {{pessoa_criada.data.id}}"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 900, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "input_1" },
    { "source": "input_1", "target": "pipedrive_1" },
    { "source": "pipedrive_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

person.email (array, opcional)

O que é: Lista de emails da pessoa.

Formato: [{"value": "email@example.com", "primary": true}]

person.phone (array, opcional)

O que é: Lista de telefones da pessoa.

Formato: [{"value": "11999998888", "primary": true}]

person.org_id (number, opcional)

O que é: ID da organização à qual a pessoa pertence.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
resource	string	Sim	Deve ser "persons"
operation	string	Sim	Deve ser "create"
person.name	string	Sim	Nome completo
person.email	array	Não	Emails
person.phone	array	Não	Telefones
person.org_id	number	Não	ID organização

Exemplo 1: Cadastro Completo

Objetivo: Criar pessoa com nome, email e telefone

JSON para Importar

{
  "name": "Pipedrive - Cadastro Completo",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "input_1",
      "type": "input",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Nome",
        "parameters": {
          "message": "Nome completo:",
          "variableName": "name"
        }
      }
    },
    {
      "id": "email_1",
      "type": "email",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Email",
        "parameters": {
          "message": "Email:",
          "variableName": "email"
        }
      }
    },
    {
      "id": "phone_1",
      "type": "phone",
      "position": { "x": 700, "y": 100 },
      "data": {
        "label": "Telefone",
        "parameters": {
          "message": "Telefone:",
          "variableName": "phone"
        }
      }
    },
    {
      "id": "pipedrive_1",
      "type": "pipedrive",
      "position": { "x": 900, "y": 100 },
      "data": {
        "label": "Criar Pessoa",
        "resource": "persons",
        "operation": "create",
        "config": {
          "apiToken": "{{pipedrive_token}}",
          "companyDomain": "sua-empresa"
        },
        "person": {
          "name": "{{name}}",
          "email": [{"value": "{{email}}", "primary": true}],
          "phone": [{"value": "{{phone}}", "primary": true}]
        }
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 1100, "y": 100 },
      "data": {
        "label": "Sucesso",
        "parameters": {
          "message": "✅ Cadastro criado com sucesso!"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 1300, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "input_1" },
    { "source": "input_1", "target": "email_1" },
    { "source": "email_1", "target": "phone_1" },
    { "source": "phone_1", "target": "pipedrive_1" },
    { "source": "pipedrive_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Boas Práticas

✅ SIM:

Sempre colete nome (obrigatório)
Valide email com node EMAIL
Valide telefone com node PHONE
Use PERSON_SEARCH antes para evitar duplicados

❌ NÃO:

Criar pessoa sem nome
Criar duplicados
Ignorar validações de email/telefone

Próximos Nodes

→ PIPEDRIVE_PERSON_UPDATE - Atualizar pessoa → PIPEDRIVE_PERSON_SEARCH - Buscar pessoa