> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/b2b-enrichment/people-data-labs.md).

# People Data Labs

Os passos do People Data Labs oferecem acesso a dados abrangentes de inteligência de negócios para empresas e profissionais. Estas ferramentas poderosas ajudam a enriquecer o seu CRM, melhorar a geração de leads e criar abordagens personalizadas, recuperando perfis detalhados tanto de empresas como de indivíduos.

### Passos do People Data Labs disponíveis

A AirOps oferece os seguintes passos de integração com o People Data Labs:

* [**People Data Labs - Enriquecimento de Empresas** ](#people-data-labs-company-enrichment)-- aceda a informações detalhadas da empresa, incluindo dados de financiamento, dimensão e setor
* [**People Data Labs - Enriquecimento de Pessoas** ](#people-data-labs-person-enrichment)-- recolha perfis profissionais abrangentes, incluindo histórico de trabalho e detalhes de contacto

### People Data Labs - Enriquecimento de Empresas

Este passo permite-lhe aceder a informações detalhadas da empresa, incluindo dados de financiamento, dimensão e setor. Fornece inteligência de negócios abrangente que pode melhorar os seus processos de qualificação e segmentação de leads.

**Configuração**

Tem de fornecer **um** dos seguintes identificadores para procurar uma empresa:

* **Nome**: O nome da empresa pelo qual é normalmente conhecida (por exemplo, "AirOps", "Microsoft Corporation")
* **Ticker**: O símbolo ticker da empresa na bolsa de valores, se for cotada em bolsa (por exemplo, "MSFT" para a Microsoft)
* **Website**: O domínio do website da empresa ou o URL completo (por exemplo, "airops.com" ou "<https://www.airops.com>")
* **Perfil**: Um URL para o perfil da empresa numa plataforma social como o LinkedIn (por exemplo, "<https://www.linkedin.com/company/airops/>")

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-91693551f60540d65c36523cf396d14d5906e3cc%2Fpdl-01-company-enrichment.png?alt=media" alt="People Data Labs Company Enrichment step with a company name, website, and profile"><figcaption><p>Enriqueça uma empresa por nome, website ou perfil.</p></figcaption></figure>

**Formato de saída**

```json
{
  "id": "1a2b3c4d5e",
  "name": "AirOps",
  "display_name": "AirOps",
  "size": "11-50",
  "employee_count": 25,
  "founded": 2021,
  "industry": "Software",
  "naics": [
    {
      "name": "Editoras de software",
      "naics": "511210"
    }
  ],
  "location": {
    "name": "Nova Iorque, Nova Iorque, Estados Unidos",
    "locality": "Nova Iorque",
    "region": "Nova Iorque",
    "country": "Estados Unidos",
    "continent": "América do Norte"
  },
  "website": "https://www.airops.com",
  "ticker": null,
  "type": "privada",
  "summary": "A AirOps é uma plataforma para criar e implementar fluxos de trabalho com IA para marketing e criação de conteúdo.",
  "tags": [
    "inteligência artificial",
    "aprendizagem automática",
    "automação de marketing"
  ],
  "metrics": {
    "annual_revenue": "1M-10M",
    "estimated_annual_revenue": 5000000,
    "raised": 15000000
  },
  "profiles": {
    "facebook": "https://www.facebook.com/airopsai",
    "linkedin": "https://www.linkedin.com/company/airops/"
  },
  "phone": "+1 (555) 123-4567",
  "emails": [
    "info@airops.com"
  ]
}
```

### People Data Labs - Enriquecimento de Pessoas

Este passo permite-lhe recolher perfis profissionais abrangentes, incluindo histórico de trabalho e detalhes de contacto. Fornece informações do LinkedIn, informações de contacto e muito mais para potenciar a abordagem personalizada.

**Configuração**

Tem de fornecer **um** dos seguintes identificadores para procurar uma pessoa:

* **Perfil social**: Um URL para o perfil da pessoa numa plataforma social como o LinkedIn (por exemplo, "<https://www.linkedin.com/in/johndoe/>")
* **Email**: O endereço de email da pessoa (por exemplo, "<john.doe@company.com>")
* **Número de telefone**: O número de telefone da pessoa em formato internacional (por exemplo, "+14155559876")
* **Nome e empresa**: Se não tiver os identificadores acima, pode pesquisar usando:
  * **Nome próprio**: O nome próprio da pessoa
  * **Apelido**: O apelido da pessoa
  * **Nome da empresa**: O nome da empresa onde a pessoa trabalha

**Formato de saída**

```json
{
  "id": "pGj2y4NzB9aKpEWM3nGRdJ",
  "full_name": "John Smith",
  "first_name": "John",
  "last_name": "Smith",
  "middle_name": "Michael",
  "gender": "masculino",
  "birth_date": "1985-06-15",
  "location": {
    "name": "São Francisco, Califórnia, Estados Unidos",
    "locality": "São Francisco",
    "region": "Califórnia",
    "country": "Estados Unidos"
  },
  "work_email": "john.smith@company.com",
  "personal_emails": [
    "johnsmith85@gmail.com"
  ],
  "mobile_phone": "+14155551234",
  "work_phone": "+14155559876",
  "industry": "Software",
  "job_title": "Gestor Sénior de Produto",
  "job_title_role": "produto",
  "job_title_levels": [
    "sénior"
  ],
  "job_company_name": "Acme Inc",
  "job_company_website": "acmeinc.com",
  "job_company_size": "201-500",
  "job_start_date": "2020-03-01",
  "skills": [
    "Gestão de Produto",
    "Estratégia de Produto",
    "SaaS"
  ],
  "experience": [
    {
      "company": {
        "name": "Acme Inc",
        "size": "201-500",
        "industry": "Software"
      },
      "title": "Gestor Sénior de Produto",
      "start_date": "2020-03-01",
      "end_date": null,
      "is_current": true
    },
    {
      "company": {
        "name": "Tech Solutions",
        "size": "51-200",
        "industry": "Software"
      },
      "title": "Gestor de Produto",
      "start_date": "2017-05-01",
      "end_date": "2020-02-28",
      "is_current": false
    }
  ],
  "education": [
    {
      "school": {
        "name": "Universidade de Stanford",
        "type": "universidade"
      },
      "degrees": [
        "MBA"
      ],
      "start_date": "2015-09-01",
      "end_date": "2017-06-01"
    }
  ],
  "profiles": {
    "linkedin": "https://www.linkedin.com/in/johnsmith",
    "facebook": "https://www.facebook.com/johnsmith",
    "twitter": "https://twitter.com/johnsmith"
  }
}
```

### Casos de uso comuns

#### Qualificação de leads aprimorada

1. Importe uma lista de empresas-alvo
2. Utilize **People Data Labs - Enriquecimento de Empresas** para obter informações detalhadas sobre a empresa
3. Use um passo de Código para filtrar empresas com base no tamanho, setor ou financiamento
4. Para qualificar empresas, use **People Data Labs - Enriquecimento de Pessoas** para encontrar decisores
5. Crie contactos personalizados com base em pontos de dados abrangentes

#### Abordagem comercial personalizada

1. Comece com uma lista de contactos de nomes e empresas
2. Utilize **People Data Labs - Enriquecimento de Pessoas** para obter perfis profissionais detalhados
3. Use um passo de LLM para gerar uma abordagem personalizada, referindo:
   * Função e responsabilidades atuais
   * Experiência anterior
   * Formação académica
   * Competências relevantes para a sua solução
4. Envie mensagens direcionadas através da sua plataforma de email ligada

#### Enriquecimento de dados do CRM

1. Exporte os dados de contactos do seu CRM
2. Utilize **People Data Labs - Enriquecimento de Empresas** para enriquecer registos de empresas
3. Utilize **People Data Labs - Enriquecimento de Pessoas** para completar perfis de contactos
4. Use um passo de Código para combinar e formatar os dados enriquecidos
5. Importe os dados enriquecidos de volta para o seu CRM

### Tratamento de erros

Por predefinição, os passos do People Data Labs terminarão o fluxo de trabalho se falharem. Para continuar o fluxo de trabalho se um passo falhar, clique em "Continuar" na parte inferior do painel de definições.

\[IMAGEM: Captura de ecrã que mostra a opção "Continuar" nas definições do passo]

O passo devolverá as seguintes chaves quando falhar:

* `saída`: será `nulo`
* `erro`:
  * `mensagem`: a mensagem devolvida pelo passo
  * `código`: o código de erro que representa o erro

As causas comuns do erro incluem:

* Informação fornecida insuficiente
* Nenhum registo correspondente encontrado
* Limites de taxa excedidos

### Exemplo de fluxo de trabalho

Aqui está um exemplo de fluxo de trabalho que usa ambos os passos do People Data Labs para um processo abrangente de enriquecimento de leads:

1. Comece com uma lista de empresas-alvo
2. Utilize **People Data Labs - Enriquecimento de Empresas** para obter informações detalhadas sobre a empresa
3. Use um passo de Código para filtrar empresas com base em critérios (tamanho, setor, financiamento, etc.)
4. Para cada empresa qualificada, use outro passo de Código para construir uma consulta para encontrar decisores relevantes (por exemplo, "VP de Marketing", "Diretor de Conteúdo")
5. Utilize **People Data Labs - Enriquecimento de Pessoas** para encontrar os contactos certos nessas empresas
6. Use um passo de LLM para analisar os perfis enriquecidos e gerar mensagens de abordagem personalizadas
7. Envie mensagens direcionadas através da sua plataforma de email ligada

Este fluxo de trabalho permite uma abordagem altamente direcionada e orientada por dados, baseada em informações abrangentes sobre empresas e contactos, melhorando significativamente as taxas de envolvimento em comparação com abordagens genéricas.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/b2b-enrichment/people-data-labs.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
