Automatically Import Leads into HubSpot: The Complete Guide

Importar leads para o HubSpot funciona por quatro vias: por importação manual de CSV através da ferramenta de importação do HubSpot, através de integrações nativas e middleware no-code como o Zapier, através da API do HubSpot ou por exportação direta com 1 clique a partir de um software de geração de leads como a anilead.io. Qual é o caminho certo depende da frequência com que você importa, de quão limpos estão os seus dados de origem e de quanto trabalho manual aceita. Este guia explica os quatro métodos passo a passo — com campos obrigatórios, mapeamento de campos, tratamento de duplicados, uma tabela comparativa e os erros de importação mais frequentes com a respetiva solução.

Para delimitar: este artigo trata da importação em si — ou seja, da questão de como leads existentes chegam ao HubSpot de forma tecnicamente limpa. Como construir, além disso, um fluxo de leads permanente e automatizado, que preenche o seu CRM semana após semana com contactos novos e qualificados, mostra-o o nosso guia separado preencher o CRM HubSpot automaticamente com leads B2B.

Que caminhos existem para importar leads para o HubSpot?

Existem quatro caminhos estabelecidos para importar leads B2B para o HubSpot: a importação manual de ficheiros (CSV, XLSX, XLS), as integrações nativas incluindo middleware como Zapier ou Make, a API do HubSpot para programadores e a exportação direta a partir de uma ferramenta de geração de leads. Os quatro caminhos criam, no fim, contactos (e opcionalmente empresas ou negócios) no HubSpot — distinguem-se sobretudo no esforço, na propensão a erros e no grau de automação.

• Importação CSV: ideal para importações pontuais ou ocasionais de listas existentes, por exemplo na mudança de CRM ou depois de uma feira
• Integrações nativas e Zapier: adequadas quando os leads nascem regularmente noutra ferramenta (formulários, Google Sheets, software de webinars) e devem fluir automaticamente para o HubSpot
• API do HubSpot: a solução mais flexível para equipas de desenvolvimento com fontes de dados próprias, por exemplo registos de produto ou um data warehouse
• Exportação direta de uma ferramenta de leads: o caminho mais rápido para equipas que geram ativamente novos leads B2B e querem transferir contactos selecionados para o CRM sem passo intermédio

Uma pipeline limpa não começa na importação, mas na seleção: só leads qualificados pertencem ao CRM. O nosso artigo sobre lead scoring com IA explica como priorizar leads antes da importação.

Como funciona a importação CSV no HubSpot, passo a passo?

A importação CSV corre no HubSpot através de CRM → Contactos → Importar e é composta por cinco passos: preparar o ficheiro, escolher o tipo de objeto, carregar o ficheiro, atribuir as colunas às propriedades do HubSpot e verificar as definições de duplicados. Para importações ocasionais, é a entrada mais simples — sem ferramentas adicionais.

1. Preparar o ficheiro: segundo a documentação oficial, o HubSpot aceita ficheiros CSV, XLSX e XLS com exatamente uma folha, uma linha de cabeçalho com os nomes das colunas e menos de 1.000 colunas. Se o ficheiro contiver tremas ou caracteres especiais, tem de estar codificado em UTF-8 — o obstáculo mais frequente em registos alemães.
2. Iniciar a importação: no HubSpot, clicar em Contactos → Importar → Iniciar importação e escolher "Ficheiro do computador".
3. Escolher o tipo de objeto: só contactos, só empresas — ou ambos em simultâneo num ficheiro (importação multiobjeto). Para leads B2B recomenda-se a importação combinada, para que os contactos fiquem automaticamente associados às suas empresas.
4. Atribuir colunas (mapeamento): o HubSpot propõe automaticamente uma propriedade para cada coluna. Verifique cada atribuição manualmente — sobretudo com nomes de coluna alemães como "Telefonnummer" ou "Ort", que o HubSpot nem sempre reconhece corretamente. As colunas desnecessárias podem ser excluídas da importação.
5. Duplicados e conclusão: nos contactos, o endereço de e-mail é o identificador único primário. Se já existir um contacto com o mesmo e-mail, o HubSpot atualiza o registo existente em vez de criar um duplicado. Após a importação, o HubSpot mostra um resumo com sucessos e linhas com erro.

Dica: crie logo na importação uma lista (p. ex. "Import Leads março 2026"). Assim tem todos os contactos importados imediatamente como segmento para pós-processamento, tarefas ou relatórios. O HubSpot documenta os requisitos completos dos ficheiros no seu guia oficial de configuração de ficheiros de importação.

Que campos obrigatórios exige o HubSpot na importação de contactos?

Na importação de contactos, o HubSpot exige pelo menos um dos três campos primeiro nome, apelido ou endereço de e-mail; na importação de empresas, pelo menos o nome da empresa ou o domínio. Na prática, você deve mesmo assim fornecer sempre o endereço de e-mail, porque só ele, como chave única, evita duplicados de forma fiável. Para os tamanhos de ficheiro valem, segundo a documentação do HubSpot (à data de julho de 2026), no máximo 20 MB por ficheiro em contas gratuitas, em contas pagas até 512 MB e no máximo 1.048.576 linhas por ficheiro.

O que conseguem as integrações nativas e o Zapier na importação para o HubSpot?

As integrações nativas e o middleware como o Zapier ligam permanentemente as suas fontes de leads ao HubSpot: assim que na fonte nasce um novo registo, ele é automaticamente criado ou atualizado como contacto — sem ficheiro CSV e sem mapeamento manual em cada execução. Isso compensa a partir do momento em que os leads chegam regularmente no mesmo formato.

• Zapier: liga centenas de ferramentas ao HubSpot. Exemplo típico: nova linha no Google Sheets → automaticamente contacto no HubSpot. Configuração rápida, mas limitado por execução pela quota do Zapier.
• Make (antigo Integromat): mais flexível em transformações de dados e ramificações — mais adequado quando os dados têm de ser limpos ou enriquecidos antes da importação.
• HubSpot App Marketplace: muitas ferramentas de formulários, webinars e eventos trazem integrações HubSpot prontas, que dispensam middleware.
• HubSpot Data Sync: a sincronização nativa do HubSpot mantém os dados atualizados de forma bidirecional entre o HubSpot e outros sistemas, consoante o âmbito funcional e o tarifário usados.

A desvantagem de todas as soluções de middleware: cada ligação adicional é uma potencial fonte de erros. Alterações de campos na fonte quebram silenciosamente a atribuição, e a procura de erros distribui-se por três sistemas. Para fluxos de leads críticos para o negócio, você deve prever monitorização.

Quando compensa a importação através da API do HubSpot?

A API do HubSpot compensa quando os leads nascem em sistemas próprios — por exemplo, registos de produto, um data warehouse ou uma aplicação desenvolvida internamente — e a sua equipa tem capacidade de desenvolvimento. Através da API de CRM podem criar-se contactos, empresas e negócios individualmente ou em lote, fazer upsert por endereço de e-mail (criar ou atualizar numa só chamada) e preencher com quaisquer custom properties.

O acesso faz-se através de uma Private App com access token, que você cria nas definições do HubSpot. A API é o caminho mais poderoso, mas também o mais trabalhoso: você é responsável pelo tratamento de erros, pela gestão de rate limits e pela lógica de duplicados. Para casos de uso padrão — levar leads de um software de geração de leads para o CRM —, uma integração pronta é quase sempre a escolha mais económica, porque já traz exatamente esse tratamento de erros.

Como exporta a anilead.io leads para o HubSpot com um clique?

A anilead.io é um software de geração de leads B2B para o mercado DACH que encontra empresas através do Google Places, extrai endereços de e-mail e avalia cada lead com Claude AI. Os leads encontrados são exportados diretamente da lista de leads para o HubSpot — sem ficheiro CSV, sem mapeamento, sem middleware:

1. Selecionar os leads na anilead.io — por exemplo, filtrados por score de IA, estado ou setor
2. Clicar em "HubSpot Export"
3. A anilead.io cria os leads como contactos no HubSpot — com e-mail, primeiro nome e apelido, telefone, nome da empresa, cargo e site; a lifecycle stage é definida automaticamente como "Lead"
4. Para cada contacto é adicionalmente criado um negócio associado na pipeline padrão, cujo nome contém a empresa e o projeto — assim a origem de cada lead permanece rastreável no CRM

A exportação trata os duplicados automaticamente: antes de criar, a anilead.io verifica pelo endereço de e-mail se o contacto já existe no HubSpot. Se sim, o registo existente é atualizado em vez de duplicado; os leads já exportados anteriormente são ignorados. Cada exportação é, além disso, registada, para que você possa verificar a qualquer momento que lead foi transferido e quando. A exportação para o HubSpot está incluída em todos os planos — também no plano Free com 50 créditos de leads por mês, sem cartão de crédito. Pode, portanto, testar gratuitamente o caminho completo, da pesquisa à entrada no CRM.

Caminhos de importação em comparação: esforço, propensão a erros, automação

Os quatro caminhos de importação diferem claramente no esforço de configuração, no esforço contínuo e no risco de erro. A tabela resume que caminho se adequa a que cenário:

Que erros típicos acontecem na importação para o HubSpot — e como evitá-los?

Os erros de importação mais frequentes no HubSpot são codificação de caracteres errada, atribuição de colunas incorreta, formatos de data inconsistentes e duplicados por falta de endereços de e-mail. Quase todos podem ser evitados com cinco minutos de preparação:

• Tremas corrompidos (ä em vez de ä): o ficheiro não está codificado em UTF-8. Solução: exportar no Excel via "Guardar como → CSV UTF-8" ou voltar a guardar o ficheiro num editor de texto com UTF-8.
• Colunas caem no campo errado: o mapeamento automático foi aceite sem verificação. Solução: controlar cada atribuição na importação e definir um esquema de colunas uniforme para todas as importações futuras.
• Erros de data: o HubSpot espera um formato de data consistente dentro de uma coluna e pergunta o formato na importação. Solução: antes da exportação, uniformizar todas as colunas de data num formato, p. ex. DD.MM.AAAA.
• Duplicados apesar da importação: linhas sem endereço de e-mail não podem ser desduplicadas. Solução: separar registos sem e-mail antes da importação ou tratá-los à parte.
• Ponto e vírgula em vez de vírgula: as versões alemãs do Excel exportam CSV por padrão com ponto e vírgula como separador. Se o HubSpot mostrar todos os dados numa coluna, exporte o ficheiro de novo com separação por vírgula ou use XLSX.
• Listas em massa não qualificadas: o maior erro não é técnico: quem importa listas não filtradas dilui os relatórios e a pipeline. Importe apenas leads que encaixem no seu perfil de cliente-alvo — o nosso guia sobre o Ideal Customer Profile no B2B mostra como o definir.

Boas práticas para importações de leads limpas no HubSpot

Independentemente do caminho de importação escolhido, cinco regras garantem que a sua base de dados HubSpot se mantém limpa e analisável a longo prazo:

• Usar sempre o endereço de e-mail como identificador único — é o único travão fiável de duplicados nos contactos
• Definir a lifecycle stage de forma consequente: marcar novos leads como "Lead", para que listas, relatórios e automações posteriores funcionem de forma limpa
• Documentar a fonte do lead: sem indicação de origem, você não consegue avaliar mais tarde que canal traz faturação
• Atribuir um proprietário: cada lead importado precisa de um sales rep responsável — senão fica parado
• Organizar o follow-up: logo após a importação, criar tarefas ou lembretes para que nenhum lead fique por trabalhar. No contacto por e-mail aplicam-se na Alemanha limites legais estritos — o que é permitido explica-o o nosso artigo sobre prospeção fria B2B por e-mail.

Conclusão: que caminho de importação se adequa a que equipa?

Para importações esporádicas de listas existentes basta a importação CSV — com codificação UTF-8, mapeamento verificado e e-mail como chave de duplicados. Quem recebe leads regularmente de formulários ou ferramentas automatiza o fluxo com Zapier, Make ou integrações nativas. As equipas de desenvolvimento com fontes de dados próprias recorrem à API do HubSpot. E as equipas que geram ativamente novos leads B2B no mercado DACH poupam por completo o passo intermédio: com a anilead.io, você seleciona leads pontuados e exporta-os com um clique como contactos e negócios para o HubSpot. O guia de automação de vendas B2B mostra como transformar isto num processo permanentemente automatizado.

Perguntas frequentes sobre a importação de leads no HubSpot

Posso importar leads gratuitamente para o HubSpot?

Sim. A importação de ficheiros faz parte do CRM gratuito do HubSpot, com limites reduzidos face às contas pagas — segundo a documentação do HubSpot (à data de julho de 2026), cerca de 20 MB no máximo por ficheiro em contas gratuitas. Também a exportação direta da anilead.io funciona no plano Free: 50 créditos de leads por mês, exportação para o HubSpot incluída, sem necessidade de cartão de crédito.

Como evita o HubSpot duplicados na importação?

O HubSpot usa o endereço de e-mail como identificador único primário para contactos: se na importação já existir um contacto com o mesmo e-mail, o registo existente é atualizado em vez de criado de novo. Registos sem endereço de e-mail não podem ser desduplicados de forma fiável pelo HubSpot — separe-os antes da importação ou trate-os manualmente depois.

Posso importar contactos e empresas em simultâneo?

Sim. O HubSpot suporta importações multiobjeto, nas quais um ficheiro contém tanto dados de contactos como de empresas. O HubSpot cria ambos os objetos e associa-os automaticamente. Para importações B2B, este é o caminho recomendado, porque a pessoa de contacto e a empresa ficam ligadas de forma limpa desde o início.

Que formatos de ficheiro aceita o HubSpot na importação?

O HubSpot aceita ficheiros CSV, XLSX e XLS com exatamente uma folha, uma linha de cabeçalho e menos de 1.000 colunas. Os ficheiros com tremas ou outros caracteres especiais têm de estar codificados em UTF-8. Quem quer evitar problemas de mapeamento com ficheiros CSV alemães separados por ponto e vírgula usa, mais simplesmente, o formato XLSX.

Que dados transfere a exportação da anilead.io para o HubSpot?

A exportação cria contactos com e-mail, primeiro nome e apelido, telefone, nome da empresa, cargo e site, e define a lifecycle stage como "Lead". Adicionalmente, nasce por lead um negócio associado na pipeline padrão, cujo nome contém a empresa e o projeto anilead.io. O score do Claude AI serve como filtro de seleção: você exporta de forma direcionada apenas os leads acima do seu score mínimo.