​
Introdução

Este guia apresenta uma visão geral sobre o Searching.
Consulte a API de Enriquecimentos para obter exemplos de solicitações usando a sua linguagem de programação favorita.

​
Pré-requisitos

As APIs da plataforma são protegidas. Solicite a sua chave de API através deste formulário.
Você pode seguir o tutorial com o seu cliente de API favorito, mas recomendamos que utilize Postman, Insomnia ou cURL.

​
Conceitos

O Searching é uma plataforma de enriquecimento de dados baseada em ações.Uma ação é uma unidade de trabalho, que recebem parâmetros de entrada (data points), executa uma tarefa de enriquecimento e fornece um resultado de saída.Cada ação possui uma finalidade específica. Por exemplo: “pesquisar empresa por CNPJ na base de dados da Receita Federal do Brasil”.
Ações podem ser encadeadas para produzir resultados mais relevantes. No contexto do Searching, esses encadeamentos são chamados de workflows.Um workflow é essencialmente uma coleção de ações organizadas em uma ordem específica, onde a saída de uma ação pode servir como entrada para a próxima.Workflows permitem a criação de processos de enriquecimento de dados multifásicos, otimizando a eficiência e a precisão dos dados enriquecidos.
Conjunto de dados fornecidos ao Searching como ponto de partida para o enriquecimento.
Resultados obtidos através de de um processo de enriquecimento.

​
Caso de uso: Prospecção ativa

Para fins de exemplo, vamos simular o processo de prospeção de uma empresa de tecnologia. Esta empresa está interessada em divulgar uma API para enriquecimento de dados. Os principais patrocinadores costumam ser pessoas técnicas e do setor de TI. Após receber uma lista de CNPJs de empresas brasileiras, precisamos buscar mais informações para entrar em contato e oferecer o produto. Vamos começar a nossa jornada pelo CNPJ 21.593.012/0001-47.

​
Plano

Geralmente, o pré-vendedor precisa executar uma série de tarefas manualmente.
1

Pesquisar empresa por CNPJ

Consultar a base de dados pública da Receita Federal para obter informações básicas sobre a empresa: razão social, atividades e afins.
2

Buscar mais informações sobre a empresa

Usando dados encontrados na etapa anterior, como o nome fantasia e o endereço, pesquisar a empresa no Google para descobrir o site e dados de contato.
3

Encontrar colaboradores

Após ter uma ideia geral da empresa, o pré-vendedor precisa procurar colaboradores com poder de decisão (patrocinadores) para oferecer o produto.Geralmente, isso inclui pesquisas no LinkedIn e no Google.
4

Descobrir formas de contato

Infelizmente, nem sempre os perfis em redes sociais incluem um email ou telefone para contato.Neste momento, o pré-vendedor deve recorrer a outras ferramentas, como o Hunter.io para descobrir emails associados ao nome e domínio corporativo.
5

Consolidar resultados

Por fim, o pré-vendedor deve agregar e analisar todos os dados coletados nas etapas anteriores, em um formato padronizado e coerente, antes de entrar em contato.
O Searching é capaz de realizar todas estas ações automaticamente.

​
Enriquecimento de empresas

Vamos iniciar o processo de descoberta usando o workflow de Enriquecimento de Empresa, fornecendo o CNPJ como único parâmetro de entrada: 
curl 'https://exact.ws/enrichments/company' \
  -H 'Authorization: Bearer <api_key>' \
  -d '{"id": "21593012000147"}'
Como resposta, recebemos o seguinte retorno: 
{
  "status": "RUNNING"
}
Isto significa que a solicitação foi recebida com sucesso e está em processamento. Podemos repetir a requisição até obter um resultado final de execução do workflow. Depois de algumas tentativas, recebemos a seguinte resposta: 
{
  "status": "COMPLETED",
  "data": {
    "id": "21.593.012/0001-47",
    "company_name": "EXACT DESENVOLVIMENTO E PROGRAMACAO DE SOFTWARE LTDA",
    "trade_name": "EXACT SALES",
    "street_type": "RODOVIA",
    "street": "VIRGILIO VARZEA",
    "number": "587",
    "district": "MONTE VERDE",
    "city": "FLORIANOPOLIS",
    "state": "SC",
    "zipcode": "88032-000",
    "site": "https://www.exactsales.com.br/",
    "domain_name": "exactsales.com.br",
    "domains": [
      /* ... */
    ],
    "emails": ["fiscal@totvs.com.br"],
    "phones": ["(11) 4004-0015", "(48) 3025-7750", "(48) 3181-0180"],
    "profiles": [
      {
        "platform": "FACEBOOK",
        "url": "https://facebook.com/exactsales"
      },
      {
        "platform": "LINKEDIN",
        "url": "https://linkedin.com/company/exact-sales"
      }
    ],
    "main_activity": "6203100",
    "secondary_activities": [
      "6201501",
      "6202300",
      "6204000",
      "6209100",
      "8230001",
      "8599604"
    ],
    "share_capital": "34429907.00",
    "size": "OTHER",
    "started_at": "2014-12-17",
    "partners": [
      {
        "name": "THEO OROSCO DA SILVA",
        "type": "PERSON"
      },
      {
        "name": "FELIPE SILVA ROMAN",
        "type": "PERSON"
      },
      {
        "name": "RD GESTAO E SISTEMAS S.A.",
        "type": "LEGAL_ENTITY"
      },
      {
        "name": "JULIANO DE MIRANDA TUBINO",
        "type": "PERSON"
      },
      {
        "name": "RAPHAEL SOARES DUARTE",
        "type": "PERSON"
      }
    ],
    "active": true,
    "headquarters": true,
    "mei": false,
    "simples": false,
    "last_updated_at": "2024-07-12T19:25:21.629941Z"
  }
}
Perceba que, além de recuperar informações cadastrais na base de dados da Receita Federal do Brasil, o Searching conseguiu identificar:
1

Site e domínios associados da empresa

Pode ser utilizado para encontrar mais informações sobre a empresa, além de fornecer o domínio corporativo para envio de emails.
2

Perfis em redes sociais

Podem ser utilizados como fallback se não encontramos um email para contato com os colaboradores.
3

Números de telefone para contato

Este não é um número do setor de contabilidade, mas um telefone comercial com atendentes.

​
Buscar contatos

Em posse de informações básicas sobre a empresa, precisamos encontrar decisores interessados em nossa solução. Podemos usar o workflow de Buscar contatos, informando o nome fantasia e o CNPJ da empresa como parâmetros de entrada.
Utilize a saída do workflow anterior como entrada
curl 'https://exact.ws/enrichments/contacts' \
  -H 'Authorization: Bearer <api_key>' \
  -d '{"company_id": "21593012000147", "company_name":"Exact Sales"}'
Depois de alguns instantes, recebemos uma lista compreensiva de pessoas que trabalham na empresa. 
{
  "status": "COMPLETED",
  "data": {
    "contacts": [
      {
        "last_updated_at": "2024-07-12T19:46:15.341969Z",
        "name": "THEO OROSCO",
        "position": "CEO - Exact Sales",
        "profiles": [
          {
            "platform": "LINKEDIN",
            "url": "https://br.linkedin.com/in/theoorosco"
          }
        ]
      },
      {
        "last_updated_at": "2024-07-12T19:46:15.341990Z",
        "name": "FELIPE ROMAN",
        "position": "CTO - Exact Sales",
        "profiles": [
          {
            "platform": "LINKEDIN",
            "url": "https://br.linkedin.com/in/felipe-roman-35714b66"
          }
        ]
      },
      {
        "last_updated_at": "2024-07-12T19:46:15.341997Z",
        "name": "LUCAS RODRIGUES MIGUEL",
        "position": "Coordenador de pré-vendas - Exact Sales",
        "profiles": [
          {
            "platform": "LINKEDIN",
            "url": "https://br.linkedin.com/in/lucasrodriguesmiguel"
          }
        ]
      }
      // ...
    ]
  }
}

​
Identificar emails

Ótimo! Após analisar os resultados, identificamos que a empresa e o contato “Felipe Roman” se encaixam no perfil de cliente ideal. Agora, devemos adicionar este lead no nosso funil de vendas outbound! 🚀 Para isso, precisamos identificar o email do contato. Mais uma vez, vamos recorrer ao Searching. O workflow Encontrar emails realiza o processo de email guessing e retorna emails válidos para contato. Basta informar o domínio da empresa e o nome do contato, obtidos em etapas anteriores. 
curl 'https://exact.ws/enrichments/emails' \
  -H 'Authorization: Bearer <api_key>' \
  -d '{"domain_name": "exactsales.com.br", "name":"FELIPE ROMAN"}'
Depois de alguns instantes, recebemos uma lista com os prováveis emails do contato: 
{
  "status": "COMPLETED",
  "data": {
    "emails": [
      {
        "address": "froman@exactsales.com.br",
        "issues": [],
        "reason": "Este email foi validado com o servidor e temos certeza de que ele existe",
        "status": "deliverable"
      }
    ]
  }
}

​
Conclusão

Este guia mostrou como usar os enriquecimentos da API do Searching para descobrir contatos de uma empresa, partindo apenas de um CNPJ. Perceba que as saídas de cada workflow podem ser utilizadas como entradas para outros workflows.