PIPEDRIVE_ORGANIZATION_GET - Buscar Organização no Pipedrive

O que é este Node?

O PIPEDRIVE_ORGANIZATION_GET é o node responsável por buscar informações detalhadas de uma organização específica no Pipedrive CRM usando o ID da organização.

Por que este Node existe?

Acessar dados de empresas é essencial para vendas B2B. O PIPEDRIVE_ORGANIZATION_GET existe para:

1. Consulta de Dados: Verificar informações da empresa cliente
2. Validação: Conferir se organização existe
3. Contexto: Obter dados para personalizar atendimento
4. Análise: Ver pessoas e deals vinculados à organização

Como funciona internamente?

Quando o PIPEDRIVE_ORGANIZATION_GET é executado, o sistema:

1. Recebe ID: Coleta ID da organização
2. Processa variáveis: Substitui {{org_id}}
3. Faz requisição GET: Busca em /api/v1/organizations/{id}
4. Retorna dados: Pipedrive responde com informações completas
5. Salva na variável: Armazena resposta

Código interno (pipedrive.executor.ts:68-71):

else if (operation === 'get') {
  const orgId = this.replaceVariables(node.data.organizationId, context.variables);
  const response = await axios.get(`${endpoint}/${orgId}?${authParam}`, { headers });
  result = response.data;
}

Quando você DEVE usar este Node?

Use PIPEDRIVE_ORGANIZATION_GET quando precisar consultar dados de empresa:

Casos de uso

1. Atendimento B2B: Buscar dados da empresa do cliente
2. Validação: Verificar se organização existe antes de operar
3. Relatórios: Obter informações para análises

Quando NÃO usar PIPEDRIVE_ORGANIZATION_GET

• Não tem ID: Busque por nome primeiro
• Criar organização: Use ORGANIZATION_CREATE

Parâmetros

Campo	Tipo	Obrigatório	Descrição
resource	string	Sim	Deve ser "organizations"
operation	string	Sim	Deve ser "get"
organizationId	string/number	Sim	ID da organização
config.apiToken	string	Sim	Token API
config.companyDomain	string	Sim	Subdomínio

Exemplo: Buscar Dados da Empresa

{
  "name": "Pipedrive - Buscar 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": "ID Empresa",
        "parameters": {
          "message": "ID da organização:",
          "variableName": "org_id"
        }
      }
    },
    {
      "id": "pipedrive_1",
      "type": "pipedrive",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Buscar",
        "resource": "organizations",
        "operation": "get",
        "config": {
          "apiToken": "{{pipedrive_token}}",
          "companyDomain": "sua-empresa"
        },
        "organizationId": "{{org_id}}"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 700, "y": 100 },
      "data": {
        "label": "Mostrar",
        "parameters": {
          "message": "Empresa: {{pipedriveResult.data.name}}\nEndereço: {{pipedriveResult.data.address}}"
        }
      }
    },
    {
      "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" }
  ]
}

Resposta do Node

{
  "success": true,
  "data": {
    "id": 456,
    "name": "TechCorp Sistemas",
    "address": "Rua das Flores, 123",
    "people_count": 5,
    "deals_count": 3,
    "owner_id": 1
  }
}

Boas Práticas

✅ SIM: - Valide se organização existe - Use CONDITION para tratar erros - Salve dados para reutilizar

❌ NÃO: - Assumir que sempre existirá - Buscar repetidamente

Próximos Nodes

→ PIPEDRIVE_ORGANIZATION_UPDATE - Atualizar organização → PIPEDRIVE_ORGANIZATION_CREATE - Criar organização