Ir para o conteúdo

Como enriquecer contatos do HubSpot automaticamente?

Preencher registros de contatos manualmente é um trabalho lento, e a maior parte dos dados de CRM continua incompleta porque ninguém tem tempo de fazer isso com consistência. Este guia responde a uma pergunta específica: como fazer o HubSpot buscar automaticamente cargo, tamanho da empresa, setor e outros dados assim que um novo contato é criado? A resposta passa por conectar o HubSpot ao Clearbit por meio do Make.com, e tudo pode estar funcionando em menos de uma hora.

Contribuição de

SaaS Hackers
Blog

Resposta rápida: você pode enriquecer contatos do HubSpot automaticamente criando uma automação no Make.com que dispara na criação de um novo contato, chama a API de Enrichment do Clearbit e grava os dados retornados (cargo, tamanho da empresa, setor, URL do LinkedIn e mais) em propriedades personalizadas do HubSpot. O fluxo todo leva menos de uma hora para ser configurado e roda sem nenhuma intervenção manual.

Atualizar registros de contatos manualmente é o tipo de tarefa que parece produtiva, mas não gera resultado. Você adiciona um cargo aqui, um tamanho de empresa ali, e uma hora depois seu pipeline continua do mesmo tamanho. Se você usa o HubSpot como CRM, existe uma forma simples de parar de fazer isso de vez: conectar o Make.com ao Clearbit e deixar o enriquecimento acontecer automaticamente assim que um novo contato chega.

Este tutorial mostra o fluxo exato de gatilho, enriquecimento e gravação de volta. Ao final, você terá uma automação ativa que preenche mais de 40 dados em cada novo contato do HubSpot sem que você toque em nenhum registro.

O que é enriquecimento de contatos do HubSpot e por que ele importa?

Enriquecimento de contatos do HubSpot é o processo de adicionar automaticamente dados de terceiros a um registro de contato, cobrindo campos como cargo, receita da empresa, número de funcionários, setor, perfil do LinkedIn e stack de tecnologia.

A maioria das equipes começa com dados de contato incompletos. O envio de um formulário traz um nome e um e-mail. Todo o resto exige pesquisa, suposição ou consulta manual. Contatos enriquecidos dão ao time de vendas o contexto para priorizar a abordagem, ao time de marketing os sinais para segmentar campanhas e à área de RevOps a qualidade de dados para confiar nos relatórios.

A diferença entre um registro de contato com 3 campos e um com 40 é a diferença entre uma ligação fria e uma conversa quente e bem informada. Se você está construindo isso como parte de uma estratégia mais ampla de marketing digital para B2B SaaS e de CRM, o enriquecimento rapidamente deixa de ser opcional e passa a ser fundamental.

O que você precisa antes de começar

Antes de montar o fluxo, deixe estas três coisas prontas:

  • Uma conta do HubSpot com acesso à API (qualquer plano pago ou um sandbox de desenvolvedor)
  • Uma conta do Make.com (o plano gratuito suporta este fluxo)
  • Uma chave de API do Clearbit (o Clearbit oferece um plano gratuito de enriquecimento com 2.500 consultas por mês)

Você também precisa criar no HubSpot as propriedades personalizadas onde os dados enriquecidos serão gravados. O Clearbit retorna dados que não correspondem aos campos padrão do HubSpot, então é preciso criá-las antes.

Se você precisa de ajuda externa para implementar o HubSpot direito, pode valer a pena avaliar agências de HubSpot para B2B SaaS especializadas antes de construir mais automações sobre dados bagunçados.

Etapa 1: crie propriedades personalizadas no HubSpot

As propriedades de contato padrão do HubSpot não incluem campos como stack de tecnologia da empresa ou perfil do LinkedIn. Crie essas propriedades antes de montar a automação, caso contrário o Make não terá onde gravar os dados.

Vá em: Configurações > Propriedades > Propriedades de contato > Criar propriedade

Crie as propriedades a seguir (ajuste conforme o que o Clearbit retorna no seu caso):

  • clearbit_company_size (Número)
  • clearbit_industry (Texto de linha única)
  • clearbit_linkedin_url (Texto de linha única)
  • clearbit_company_revenue (Texto de linha única)
  • clearbit_role (Texto de linha única)
  • clearbit_seniority (Texto de linha única)
  • clearbit_enriched_at (Data)

Dê a cada propriedade um nome interno claro e agrupe todas em um grupo chamado "Clearbit Enrichment" para mantê-las organizadas no CRM.

Etapa 2: configure o gatilho no Make.com

O gatilho dispara sempre que um novo contato é criado no HubSpot. O Make.com faz isso com um módulo nativo do HubSpot.

  1. Abra o Make.com e crie um novo cenário
  2. Adicione o módulo HubSpot: Watch Contacts como gatilho
  3. Conecte sua conta do HubSpot via OAuth
  4. Configure o gatilho para disparar somente em novos contatos
  5. Escolha quais propriedades de contato trazer (no mínimo: e-mail, nome e sobrenome)

Execute um teste do gatilho. Crie um contato fictício no HubSpot apenas com um e-mail e confirme que o Make o captura. Você deve ver os dados do contato no painel de saída do módulo, à direita.

Um ponto a verificar: confirme que o e-mail do contato está presente na saída do gatilho. A API de enriquecimento do Clearbit usa o e-mail como chave principal de busca. Sem ele, a chamada de enriquecimento falha silenciosamente.

Etapa 3: chame a API de Enrichment do Clearbit

O Clearbit não tem um módulo nativo no Make, então você usa o módulo HTTP: Make a Request para chamar a API do Clearbit diretamente.

  1. Adicione um módulo HTTP: Make a Request depois do gatilho do HubSpot
  2. Defina o método como GET
  3. Use este endpoint:
https://person.clearbit.com/v2/combined/find?email={{email}}

Substitua {{email}} com a variável de e-mail da saída do gatilho do HubSpot.

  1. Em Headers, adicione:
Authorization: Bearer YOUR_CLEARBIT_API_KEY
  1. Defina Parse Response como Sim

Execute um teste com um e-mail empresarial real. O Clearbit retorna um objeto JSON com duas seções principais: person (dados da pessoa) e company (dados da organização). Você vai mapear campos de ambas na próxima etapa.

O que o Clearbit retorna (lista parcial):

  • person.title (cargo)
  • person.seniority (sênior, gerente, diretor, VP, C-suite)
  • person.role (engenharia, vendas, marketing, finanças)
  • person.linkedin.handle
  • company.metrics.employees
  • company.metrics.estimatedAnnualRevenue
  • company.category.industry
  • company.name

Se você está comparando ferramentas para a parte técnica da sua stack, este tipo de fluxo também se beneficia de saber onde as plataformas diferem em rastreamento, auditoria e profundidade de dados, e é por isso que artigos como Screamingfrog vs SEMRush vs AHREFS podem ser um bom contexto para decisões mais amplas de operações e crescimento.

Etapa 4: trate a resposta assíncrona do Clearbit

Às vezes o Clearbit retorna uma resposta 202 Accepted em vez dos dados enriquecidos de imediato. Isso acontece quando o Clearbit precisa buscar o registro em vez de servi-lo do cache.

Adicione um módulo Router depois da chamada HTTP com dois caminhos:

  • Caminho A: O código de status é 200 (dados retornados imediatamente, siga para a gravação)
  • Caminho B: O código de status é 202 (dados pendentes, adicione um módulo Wait de 60 segundos e tente a chamada de API mais uma vez)

Para a maioria dos e-mails empresariais, o Clearbit retorna 200 na primeira chamada. O caminho 202 é uma rede de segurança, não algo que acontece com frequência.

Etapa 5: grave os dados enriquecidos de volta no HubSpot

Com os dados do Clearbit em mãos, grave-os no registro do contato usando o módulo HubSpot: Update a Contact.

  1. Adicione o módulo HubSpot: Update a Contact
  2. Use o ID do contato da saída original do gatilho para identificar o registro
  3. Mapeie os campos do Clearbit para suas propriedades personalizadas do HubSpot:
Campo do ClearbitPropriedade do HubSpot
person.titleJob Title (padrão)
person.seniorityclearbit_seniority
person.roleclearbit_role
person.linkedin.handleclearbit_linkedin_url
company.metrics.employeesclearbit_company_size
company.category.industryclearbit_industry
company.metrics.estimatedAnnualRevenueclearbit_company_revenue
  1. Adicione um valor estático para clearbit_enriched_at usando a função de now data do Make. Isso gera um registro de data e hora que você pode usar para filtrar dentro do HubSpot.

Execute um teste completo, de ponta a ponta. Crie um novo contato no HubSpot com um e-mail empresarial real. Acompanhe a execução do cenário no histórico de execuções do Make. Abra o contato no HubSpot e confirme que as propriedades personalizadas foram preenchidas.

Etapa 6: adicione tratamento de erros

Um fluxo em produção precisa lidar com os casos em que o Clearbit não retorna dados. Isso acontece quando o e-mail pertence a um domínio pessoal (Gmail, Hotmail) ou quando a pessoa não está na base do Clearbit.

Adicione um módulo Error Handler na chamada HTTP:

  • Se o Clearbit retornar um 404, defina clearbit_enriched_at como a data de hoje e adicione uma propriedade personalizada clearbit_found: false
  • Isso evita que o cenário falhe e dá a você uma forma de filtrar depois, no HubSpot, os contatos não enriquecidos

Você também pode adicionar uma etapa Create Note do HubSpot no caminho do 404, registrando "Clearbit enrichment: no record found" no contato. Assim sua equipe fica informada sem poluir os campos de propriedades.

Para equipes que querem que este fluxo alimente estágios do ciclo de vida, atribuição e regras de handoff mais limpos, trabalhar com agências de marketing ops para B2B SaaS dedicadas pode ajudar a transformar os dados de enriquecimento em algo útil na operação.

Etapa 7: ative e monitore o cenário

Quando os testes passarem, defina o cenário como Active no Make. Programe a execução a cada 15 minutos (ou use um gatilho instantâneo, se o seu plano do Make suportar webhooks).

Monitore nas primeiras 48 horas:

  • Verifique no histórico de execuções do Make se há execuções com falha
  • Confira por amostragem 10 contatos enriquecidos no HubSpot para validar a qualidade dos dados
  • Procure padrões nas buscas que falharam (e-mails pessoais, domínios com erro de digitação)

Depois de 48 horas, o fluxo funciona sozinho. Todo novo contato é enriquecido antes mesmo de o time de vendas abrir o registro.

O que fazer com contatos enriquecidos no HubSpot

Dados enriquecidos só são úteis se você agir com base neles. Aqui estão três aplicações imediatas:

Lead scoring: Adicione pontos na ferramenta de lead scoring do HubSpot com base em clearbit_seniority (Diretor ou acima) e clearbit_company_size (mais de 100 funcionários). Contatos que combinam com o seu ICP sobem para o topo automaticamente.

Inscrição em workflows: Crie um workflow no HubSpot que inscreva contatos com clearbit_industry = SaaS e clearbit_seniority = VP em uma sequência de vendas de alto contato poucos minutos depois da criação.

Segmentação de listas: crie listas ativas filtradas por tamanho da empresa, setor ou senioridade enriquecidos. Essas listas se atualizam em tempo real conforme novos contatos enriquecidos chegam, mantendo seus segmentos precisos sem curadoria manual.

Isso fica ainda mais eficaz quando combinado com uma operação inbound bem definida, e é por isso que muitas equipes conectam o trabalho de enriquecimento a programas mais amplos conduzidos por agências de inbound marketing para B2B SaaS ou por agências de ABM para B2B SaaS especializadas.

Perguntas frequentes

Como enriquecer automaticamente contatos do HubSpot sem pagar pelo enriquecimento nativo do HubSpot?

Use o Make.com para conectar o HubSpot a um provedor de enriquecimento de terceiros, como Clearbit, Apollo ou Hunter. O plano gratuito do Clearbit cobre 2.500 consultas de enriquecimento por mês. O plano gratuito do Make.com comporta a lógica da automação. Essa abordagem não custa nada para a maioria das equipes em estágio inicial e dá a você mais controle sobre quais campos são gravados de volta no HubSpot.

Quais dados o Clearbit retorna ao enriquecer um contato por e-mail?

O Clearbit retorna dados da pessoa (cargo, senioridade, função, perfil do LinkedIn, localização) e dados da empresa (número de funcionários, receita estimada, setor, stack de tecnologia, domínio da empresa). Os campos disponíveis dependem de o Clearbit ter ou não um registro para aquele endereço de e-mail. E-mails pessoais, como contas do Gmail, retornam poucos dados ou nenhum.

Posso enriquecer contatos que já existem no HubSpot, e não só os novos?

Sim. Em vez de usar o gatilho "Watch Contacts" no Make, use o módulo "Search Contacts" para buscar os contatos em que clearbit_enriched_at seja desconhecido. Percorra os contatos em lotes e passe cada e-mail pela mesma chamada de API do Clearbit. Adicione um intervalo entre as requisições para respeitar os limites de taxa do Clearbit (600 requisições por minuto no plano gratuito).

O que acontece se o Clearbit não encontrar um registro para o e-mail de um contato?

O Clearbit retorna um código de status 404. No seu cenário do Make, direcione as respostas 404 para um tratador de erros que defina a propriedade clearbit_found: false no contato do HubSpot. Isso marca o registro como já tentado e evita que o cenário tente o mesmo e-mail a cada execução.

Esse fluxo de trabalho está em conformidade com o GDPR?

Enriquecer dados de contatos com provedores de terceiros exige uma base legal sob o GDPR, normalmente o legítimo interesse no caso de contatos B2B. O Clearbit processa os dados de acordo com a própria política de privacidade e oferece um Acordo de Processamento de Dados (DPA). Revise sua base legal de tratamento antes de ativar o fluxo de trabalho em mercados cobertos pelo GDPR ou por legislação semelhante.

Contribuição de

SaaS Hackers

Encontre um especialista em B2B SaaS

Reunimos um diretório de especialistas e agências de B2B SaaS que avaliamos e categorizamos por serviço e especialização para você analisar.

Encontre um especialista
Ver tudo