Que propriedades o HubSpot usa para desduplicar registros

O HubSpot bloqueia alguns duplicados por conta própria. Ele faz isso comparando uma propriedade por objeto quando um registro entra. Saber qual propriedade ele usa e onde ela se aplica explica muitos dos duplicados que ainda passam.

A resposta depende do ponto de entrada. Um registro digitado à mão, um envio de formulário, uma importação e uma chamada de API são tratados de forma um pouco diferente.

Neste artigo, são indicadas as propriedades que o HubSpot compara em cada objeto e em cada ponto de entrada. Também se explica o que não compara e como definir uma chave para os seus próprios objetos. O que cada plano do HubSpot acrescenta está descrito na nossa página sobre Duplicados no HubSpot.

Resposta curta: uma propriedade por objeto

A deduplicação automática do HubSpot usa o email para contatos e o nome de domínio da empresa para empresas. Cada objeto tem também um Record ID, e pode criar propriedades que exigem valores únicos. Eis como isso funciona em cada objeto, a partir de outubro de 2026.

Fonte, a outubro de 2026: base de conhecimento do HubSpot, Eliminar registros duplicados no HubSpot.

O ID do registro é uma propriedade padrão que guarda o valor único de cada registro. É mais útil nas importações, onde indica ao HubSpot exatamente qual registro existente cada linha deve atualizar.

O que o HubSpot compara em cada ponto de entrada

A mesma propriedade comporta-se de forma diferente consoante a forma como um registro chega.

Registros criados manualmente

Se você adicionar um contato com um email que já existe, o HubSpot avisa e não deixa adicioná-lo. Para empresas, o HubSpot avisa que já existe uma empresa com esse domínio.

Formulários

Uma submissão com um e-mail conhecido acrescenta as suas informações ao contato existente. Se alguém submeter um formulário com o seu e-mail secundário, esse endereço substitui o e-mail principal no contato.

Propriedades que exigem valores únicos não são suportadas em formulários. Uma submissão sem email é associada através de cookies do navegador, e um visitante não reconhecido pode tornar-se um novo contato. O nosso artigo sobre porque é que os formulários web criam contatos duplicados aborda esta fonte em profundidade.

Importações

Uma linha com um e-mail existente atualiza esse contato em vez de criar um novo. As empresas são comparadas pelos domínios principal e secundário, a menos que escolha uma propriedade de valor único personalizada.

Linhas sem e-mail, domínio, ID de registro ou valor único tornam-se cada uma um novo registro. Uma linha que corresponda a vários contatos existentes devolve um erro de importação e não é importada.

A API e os aplicativos de sincronização

A documentação para desenvolvedores do HubSpot define o email como chave primária dos contatos, e um upsert por email atualiza os contatos já existentes. Empresas criadas pela API não são deduplicadas por domínio. Isso inclui empresas de aplicativos de sincronização de terceiros instalados, nos quais o HubSpot observa que regras personalizadas podem se aplicar.

Fontes, a outubro de 2026: base de conhecimento do HubSpot, Eliminar registros duplicados no HubSpot e Submissões de formulários sem endereços de email, e a documentação para programadores do HubSpot, API de Contatos.

O que o HubSpot não compara quando os registros entram

Na entrada, o HubSpot compara apenas essa propriedade. Assim, alguns duplicados comuns ficam fora do seu alcance.

• Nomes: dois contatos com o mesmo nome, empresa e telefone mas emails diferentes continuam a ser dois contatos.
• Números de telefone e endereços: nenhum dos dois faz parte da verificação na entrada.
• Um segundo email: uma pessoa com um endereço profissional e outro pessoal pode existir duas vezes. O nosso artigo sobre comparar e-mails pessoais e profissionais explica como conectá-los.
• Empresas sem domínio: sem nada com que comparar, cada um é novo.
• Negócios e tickets: A página de deduplicação do HubSpot não indica nenhuma propriedade automática para nenhuma das duas.

Os domínios têm armadilhas próprias, como terminações de país e subsidiárias que compartilham um só site. O nosso guia sobre encontrar empresas duplicadas pelo domínio aborda-os.

Onde os nomes e os números de telefone contam

A ferramenta de gestão de duplicados do HubSpot atua sobre registros já existentes no CRM. Compara diariamente uma lista definida de propriedades e sugere pares de contatos e empresas para revisão.

As regras de duplicados personalizadas permitem escolher as propriedades. Você pode criar até duas regras por objeto para contatos ou empresas, cada uma com até nove propriedades. Tanto a ferramenta quanto as regras personalizadas dependem da sua assinatura, que o guia de planos do HubSpot acima explica.

Fonte, a outubro de 2026: base de conhecimento do HubSpot, Revise e gerencie registros duplicados.

Como atribuir a cada objeto uma chave em que possa confiar

O que conta como duplicado depende de cada caso: o que uma equipe considera duplicado, outra pode não considerar. Assim, a chave que mantém os seus registros únicos depende dos dados. Estes princípios ajudam.

Mantenha o email e o domínio preenchidos

A proteção do HubSpot só funciona quando a propriedade tem valor. Torne o email obrigatório nos formulários sempre que possível e adicione um domínio a cada empresa que criar manualmente.

Defina uma propriedade única para negócios e objetos personalizados

O exemplo do próprio HubSpot é um número de pedido que exige um valor único para cada negócio. Qualquer ID de outro sistema funciona da mesma forma, desde que cada registro tenha um.

Importe com a chave que o seu arquivo tem

Inclua o Record ID ao atualizar registros exportados do HubSpot. Quando um arquivo usar e-mails secundários como identificador, deixe de fora a coluna Record ID, ou o e-mail secundário substituirá o principal.

Pergunte a cada integração em que se baseia a correspondência

As empresas vindas da API e de apps de sincronização não passam pela verificação de domínio. Para cada ferramenta que escreve no HubSpot, descubra qual propriedade usa para encontrar um registro existente antes de criar um novo.

Conheça as suas chaves antes de limpar

A deduplicação nativa do HubSpot assenta numa propriedade por objeto: email para contatos e domínio para empresas. As importações acrescentam o Record ID e qualquer propriedade que tenha definido como valor único obrigatório. Cada ponto de entrada aplica essas chaves de forma ligeiramente diferente, e negócios, tickets e empresas criadas pela API não têm qualquer verificação automática.

Muitos duplicados que chegam ao HubSpot entram por uma dessas lacunas. Saber que chave usa cada origem indica onde procurar primeiro e que campos comparar durante a limpeza.

Perguntas frequentes