PIPEDRIVE_ORGANIZATION_CREATE - Criar Organização no Pipedrive

O que é este Node?

O PIPEDRIVE_ORGANIZATION_CREATE é o node responsável por criar novas organizações (empresas) no Pipedrive CRM, permitindo cadastrar empresas clientes no sistema.

Por que este Node existe?

Gerenciar empresas clientes é fundamental para vendas B2B. O PIPEDRIVE_ORGANIZATION_CREATE existe para:

Cadastro de Empresas: Registrar empresas clientes automaticamente
Organização de Contatos: Agrupar pessoas por empresa
Vendas B2B: Estruturar vendas corporativas com hierarquia empresa → pessoas → deals
Base de Dados: Construir base de empresas prospects e clientes

Como funciona internamente?

Quando o PIPEDRIVE_ORGANIZATION_CREATE é executado, o sistema:

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

Código interno (pipedrive.executor.ts:64-67):

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

Quando você DEVE usar este Node?

Use PIPEDRIVE_ORGANIZATION_CREATE sempre que precisar cadastrar empresa cliente:

Casos de uso

Vendas B2B: Cliente corporativo inicia conversa e empresa é cadastrada
Formulário empresa: Coleta dados da empresa via WhatsApp
Qualificação corporativa: Após identificar lead corporativo, criar organização
Integração: Sincronizar empresas de outros sistemas

Quando NÃO usar PIPEDRIVE_ORGANIZATION_CREATE

Organização já existe: Use PIPEDRIVE_ORGANIZATION_UPDATE
Vendas B2C: Para consumidores finais, pode não precisar de organização
Apenas pessoa: Use PIPEDRIVE_PERSON_CREATE se for pessoa física

Parâmetros Detalhados

organization.name (string, obrigatório)

O que é: Nome da empresa/organização.

Exemplo: "Tech Solutions LTDA", "{{company_name}}"

Flow completo para testar:

{
  "name": "Teste Pipedrive - Criar Organização",
  "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 Empresa",
        "parameters": {
          "message": "Nome da sua empresa:",
          "variableName": "company"
        }
      }
    },
    {
      "id": "pipedrive_1",
      "type": "pipedrive",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Criar Organização",
        "resource": "organizations",
        "operation": "create",
        "config": {
          "apiToken": "{{pipedrive_token}}",
          "companyDomain": "sua-empresa"
        },
        "organization": {
          "name": "{{company}}"
        },
        "responseVariable": "org_criada"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 700, "y": 100 },
      "data": {
        "label": "Confirmar",
        "parameters": {
          "message": "✅ Empresa cadastrada! ID: {{org_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" }
  ]
}

Teste: Digite nome da empresa. Sistema criará organização e retornará ID.

organization.address (string, opcional)

O que é: Endereço da empresa.

Exemplo: "Av. Paulista, 1000 - São Paulo/SP"

organization.owner_id (number, opcional)

O que é: ID do usuário responsável pela organização.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
resource	string	Sim	Deve ser "organizations"
operation	string	Sim	Deve ser "create"
organization.name	string	Sim	Nome da empresa
organization.address	string	Não	Endereço
organization.owner_id	number	Não	ID usuário responsável
config.apiToken	string	Sim	Token API
config.companyDomain	string	Sim	Subdomínio
responseVariable	string	Não	Variável resposta

Exemplo: Cadastro Completo de Empresa

Objetivo: Criar organização com dados completos

JSON para Importar

{
  "name": "Pipedrive - Cadastro Empresa Completo",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Boas-vindas",
        "parameters": {
          "message": "Vamos cadastrar sua empresa no nosso sistema!"
        }
      }
    },
    {
      "id": "input_1",
      "type": "input",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Nome Empresa",
        "parameters": {
          "message": "Nome da empresa:",
          "variableName": "company_name"
        }
      }
    },
    {
      "id": "input_2",
      "type": "input",
      "position": { "x": 700, "y": 100 },
      "data": {
        "label": "Endereço",
        "parameters": {
          "message": "Endereço completo:",
          "variableName": "address"
        }
      }
    },
    {
      "id": "pipedrive_1",
      "type": "pipedrive",
      "position": { "x": 900, "y": 100 },
      "data": {
        "label": "Criar Organização",
        "resource": "organizations",
        "operation": "create",
        "config": {
          "apiToken": "{{pipedrive_token}}",
          "companyDomain": "sua-empresa"
        },
        "organization": {
          "name": "{{company_name}}",
          "address": "{{address}}"
        },
        "responseVariable": "empresa"
      }
    },
    {
      "id": "message_2",
      "type": "message",
      "position": { "x": 1100, "y": 100 },
      "data": {
        "label": "Sucesso",
        "parameters": {
          "message": "✅ Empresa {{company_name}} cadastrada com sucesso!"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 1300, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "message_1" },
    { "source": "message_1", "target": "input_1" },
    { "source": "input_1", "target": "input_2" },
    { "source": "input_2", "target": "pipedrive_1" },
    { "source": "pipedrive_1", "target": "message_2" },
    { "source": "message_2", "target": "end_1" }
  ]
}

Saída esperada:

Sistema: Vamos cadastrar sua empresa no nosso sistema!
Sistema: Nome da empresa:
Usuário: TechCorp Sistemas
Sistema: Endereço completo:
Usuário: Rua das Flores, 123 - São Paulo/SP
Sistema: ✅ Empresa TechCorp Sistemas cadastrada com sucesso!

Resposta do Node

{
  "success": true,
  "data": {
    "id": 456,
    "name": "TechCorp Sistemas",
    "address": "Rua das Flores, 123 - São Paulo/SP",
    "owner_id": 1,
    "add_time": "2025-01-15 10:30:00",
    "update_time": "2025-01-15 10:30:00",
    "active_flag": true,
    "people_count": 0,
    "deals_count": 0
  }
}

Boas Práticas

✅ SIM:

Sempre colete nome da empresa (obrigatório)
Use em vendas B2B para organizar contatos
Vincule pessoas à organização após criar
Salve ID da organização para usar em deals
Busque antes de criar para evitar duplicados

❌ NÃO:

Criar organização sem nome
Criar duplicados da mesma empresa
Usar para vendas B2C (pessoas físicas)
Ignorar erros de criação

Dicas

💡 Dica 1: Após criar organização, use PIPEDRIVE_PERSON_CREATE com org_id para vincular contatos.

💡 Dica 2: Salve o ID retornado para usar em PIPEDRIVE_DEAL_CREATE e associar deals à empresa.

💡 Dica 3: Combine com validação de CNPJ para garantir dados corretos de empresa.

Próximos Nodes

→ PIPEDRIVE_ORGANIZATION_UPDATE - Atualizar organização → PIPEDRIVE_ORGANIZATION_GET - Buscar organização → PIPEDRIVE_PERSON_CREATE - Criar pessoa vinculada à organização → PIPEDRIVE_DEAL_CREATE - Criar deal vinculado à organização