LINKEDIN COMPANY GET - Obter Informações de Empresa

O que é esta operação?

O LinkedIn Company Get é a operação responsável por obter informações detalhadas de uma empresa/organização no LinkedIn usando seu ID único.

Por que esta operação existe?

Enriquecimento de dados corporativos e pesquisa de mercado. O Company Get existe para:

1. Enriquecimento de CRM: Adicionar dados da empresa ao Salesforce/HubSpot
2. Pesquisa de prospects: Obter informações de empresas-alvo
3. Análise competitiva: Estudar empresas concorrentes
4. Lead qualification: Validar tamanho e setor da empresa
5. Account-based marketing: Personalizar abordagem por empresa

Como funciona internamente?

Quando o Company Get é executado, o sistema:

1. Valida access token com permissões de leitura
2. Extrai companyId dos parâmetros ou variáveis
3. Faz GET para /v2/organizations/{companyId}
4. Envia headers de autorização
5. Recebe dados da empresa (nome, setor, tamanho, localização)
6. Armazena resultado na variável especificada
7. Retorna contexto atualizado

Código interno (linkedin.executor.ts:127-140):

private async handleCompanies(operation: string, data: any, accessToken: string, context: ExecutionContext): Promise<any> {
  const baseUrl = 'https://api.linkedin.com/v2';

  switch (operation) {
    case 'get':
      // Get company info
      const companyId = this.replaceVariables(data.companyId || '', context.variables);
      const companyResponse = await axios.get(`${baseUrl}/organizations/${companyId}`, {
        headers: {
          'Authorization': `Bearer ${accessToken}`,
          'Content-Type': 'application/json',
        },
      });
      return companyResponse.data;
    // ...
  }
}

Quando você DEVE usar esta operação?

Use Company Get sempre que precisar dados detalhados de uma empresa:

Casos de uso:

1. Enriquecer lead: Lead veio de empresa X, buscar dados dela
2. Qualificar prospect: Verificar tamanho e setor antes de abordar
3. Research de mercado: Coletar dados de múltiplas empresas
4. Account profiles: Criar perfis detalhados de contas-alvo
5. Validação: Confirmar que empresa existe e está ativa
6. Personalização: Usar nome/setor para personalizar outreach

Quando NÃO usar Company Get:

• Sem companyId: Você precisa do ID numérico da empresa
• Busca por nome: API não busca por nome (apenas por ID)
• Listar suas empresas: Use Company List Managed

Parâmetros Detalhados

companyId (string, obrigatório)

O que é: ID numérico da organização no LinkedIn.

Formato: Número (ex: "1234567")

Como obter: - URL da empresa: linkedin.com/company/1234567/ - Resposta de outras APIs - Busca manual no LinkedIn

Flow completo para testar:

{
  "name": "LinkedIn - Obter Dados de Empresa",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "variable_1",
      "type": "variable",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Configurar",
        "parameters": {
          "name": "linkedin_token",
          "value": "SEU_TOKEN"
        }
      }
    },
    {
      "id": "variable_2",
      "type": "variable",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Company ID",
        "parameters": {
          "name": "target_company",
          "value": "1234567"
        }
      }
    },
    {
      "id": "linkedin_1",
      "type": "linkedin",
      "position": { "x": 700, "y": 100 },
      "data": {
        "label": "Buscar Empresa",
        "resource": "companies",
        "operation": "get",
        "config": {
          "accessToken": "{{linkedin_token}}"
        },
        "companyId": "{{target_company}}",
        "responseVariable": "empresaData"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 900, "y": 100 },
      "data": {
        "label": "Mostrar Dados",
        "parameters": {
          "message": "🏢 DADOS DA EMPRESA\n\nNome: {{empresaData.localizedName}}\nVanity Name: {{empresaData.vanityName}}\nWebsite: {{empresaData.localizedWebsite}}"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 1100, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "variable_1" },
    { "source": "variable_1", "target": "variable_2" },
    { "source": "variable_2", "target": "linkedin_1" },
    { "source": "linkedin_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Teste: Execute com ID de empresa real para ver dados!

Parâmetros

Campo	Tipo	Obrigatório	Descrição
resource	string	Sim	Sempre "companies"
operation	string	Sim	Sempre "get"
companyId	string	Sim	ID numérico da empresa
config.accessToken	string	Sim	Token OAuth 2.0
responseVariable	string	Não	Nome da variável de resposta (padrão: linkedInResult)

Exemplo 1: Enriquecer Lead no Salesforce

Objetivo: Lead veio de empresa X, buscar dados e adicionar ao Salesforce

JSON para Importar

{
  "name": "LinkedIn → Salesforce Company Enrichment",
  "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": "Pedir Company ID",
        "parameters": {
          "message": "Digite o LinkedIn Company ID:",
          "variable": "companyId"
        }
      }
    },
    {
      "id": "variable_1",
      "type": "variable",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Token",
        "parameters": {
          "name": "linkedin_token",
          "value": "SEU_TOKEN"
        }
      }
    },
    {
      "id": "linkedin_1",
      "type": "linkedin",
      "position": { "x": 700, "y": 100 },
      "data": {
        "label": "Buscar Empresa",
        "resource": "companies",
        "operation": "get",
        "config": {
          "accessToken": "{{linkedin_token}}"
        },
        "companyId": "{{companyId}}",
        "responseVariable": "company"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 900, "y": 100 },
      "data": {
        "label": "Resumo",
        "parameters": {
          "message": "✅ Empresa encontrada!\n\n🏢 {{company.localizedName}}\n🌐 {{company.localizedWebsite}}\n\n📊 Atualizando Salesforce..."
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 1100, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "input_1" },
    { "source": "input_1", "target": "variable_1" },
    { "source": "variable_1", "target": "linkedin_1" },
    { "source": "linkedin_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Exemplo 2: Qualificação de Prospect

Objetivo: Verificar tamanho e setor da empresa antes de abordar

JSON para Importar

{
  "name": "LinkedIn - Qualificar Prospect",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "variable_1",
      "type": "variable",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Config",
        "parameters": {
          "name": "linkedin_token",
          "value": "SEU_TOKEN"
        }
      }
    },
    {
      "id": "variable_2",
      "type": "variable",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Target Company",
        "parameters": {
          "name": "prospect_company_id",
          "value": "1234567"
        }
      }
    },
    {
      "id": "linkedin_1",
      "type": "linkedin",
      "position": { "x": 700, "y": 100 },
      "data": {
        "label": "Buscar Dados",
        "resource": "companies",
        "operation": "get",
        "config": {
          "accessToken": "{{linkedin_token}}"
        },
        "companyId": "{{prospect_company_id}}",
        "responseVariable": "prospectCompany"
      }
    },
    {
      "id": "condition_1",
      "type": "condition",
      "position": { "x": 900, "y": 100 },
      "data": {
        "label": "É Grande Empresa?",
        "parameters": {
          "variable": "prospectCompany.staffCount",
          "operator": "greater_than",
          "value": "500"
        }
      }
    },
    {
      "id": "message_qualified",
      "type": "message",
      "position": { "x": 1100, "y": 50 },
      "data": {
        "label": "Qualificado",
        "parameters": {
          "message": "✅ PROSPECT QUALIFICADO\n\n🏢 {{prospectCompany.localizedName}}\n👥 Funcionários: {{prospectCompany.staffCount}}+\n\n🎯 Seguir com abordagem enterprise!"
        }
      }
    },
    {
      "id": "message_not_qualified",
      "type": "message",
      "position": { "x": 1100, "y": 150 },
      "data": {
        "label": "Não Qualificado",
        "parameters": {
          "message": "⚠️ Empresa pequena (< 500 funcionários)\n\nDirecionar para plano SMB."
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 1300, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "variable_1" },
    { "source": "variable_1", "target": "variable_2" },
    { "source": "variable_2", "target": "linkedin_1" },
    { "source": "linkedin_1", "target": "condition_1" },
    { "source": "condition_1", "target": "message_qualified", "label": "true" },
    { "source": "condition_1", "target": "message_not_qualified", "label": "false" },
    { "source": "message_qualified", "target": "end_1" },
    { "source": "message_not_qualified", "target": "end_1" }
  ]
}

Resposta do Node

{
  "id": 1234567,
  "localizedName": "Tech Startup Inc",
  "vanityName": "tech-startup",
  "localizedWebsite": "https://techstartup.com",
  "logo": {
    "url": "https://media.licdn.com/..."
  },
  "locations": [],
  "staffCount": 250,
  "description": {
    "localized": {
      "en_US": "We build amazing software..."
    }
  }
}

Campos Retornados

Campo	Tipo	Descrição
id	number	ID numérico da empresa
localizedName	string	Nome da empresa
vanityName	string	URL amigável (linkedin.com/company/ISTO)
localizedWebsite	string	Website da empresa
staffCount	number	Número de funcionários
description	object	Descrição da empresa

Boas Práticas

✅ SIM: - Valide se companyId existe antes da chamada - Trate erro 404 (empresa não encontrada) - Cache dados da empresa (mudam raramente) - Use para enriquecer CRM automaticamente

❌ NÃO: - Não busque empresa sem ID válido - Não assuma que todos os campos existem - Não faça múltiplas chamadas para mesma empresa

Dicas

💡 Obter ID: Vá para página da empresa no LinkedIn, veja URL 💡 Cache: Salve dados por 30 dias (mudam pouco) 💡 Validação: Sempre valide staffCount e outros campos numéricos

Próximo Node

→ Company List Managed - Listar suas empresas → Company Create Post - Publicar em nome de empresa → Profile Get - Obter dados do perfil