Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa.

Desduplicação de registros no HubSpot

Ultima atualização: 26 de Junho de 2026

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

Todos os produtos e planos

A HubSpot desduplica os contatos automaticamente usando endereços de e-mail e empresas que utilizam nomes de domínio. Os IDs de Registro também podem ser usados para desduplicar manualmente contatos, empresas, negócios, tickets, produtos, objetos ativados pelo administrador (por exemplo, compromissos) e objetos personalizados. Para desduplicar por meio da importação, você pode incluir o ID do Registro propriedade ou as propriedades personalizadas que exigem valores exclusivos em seu arquivo de importação.

Desduplicação automática no HubSpot

O HubSpot desduplica automaticamente contatos e empresas criados no CRM (por exemplo, importações, envios de formulário) da seguinte forma:

Saiba mais sobre como os cookies são usados no rastreamento do HubSpot ou como gerenciar duplicatas de envios de formulário.

Desduplicação automática de contatos por endereço de e-mail

Quando um novo contato é adicionado, o HubSpot procurará um valor correspondente na propriedade E-mail.

Manual: se você tentar criar manualmente um contato com o mesmo endereço de e-mail de um contato existente, o HubSpot alertará que já existe um contato e você não poderá adicionar um outro contato.
Envio de formulário: se já existir um contato em sua conta com o mesmo endereço de e-mail, as novas informações do contato serão adicionadas ao contato existente. Se o contato enviar um formulário com seu endereço de e-mail secundário, o endereço de e-mail substituirá o existente para o contato. Saiba mais sobre as configurações de desduplicação de envios de formulário da HubSpot ou sobre formulários externos.
Importação:
- Se já existir um contato em sua conta com o mesmo endereço de e-mail, as informações importadas atualizarão o contato existente em vez de criar um novo. Apenas as propriedades mapeadas são atualizadas e a importação não excluirá os registros existentes.

- Se o arquivo de importação contiver colunas de e-mail secundário e ID de Registro e você estiver usando o e-mail secundário como identificador exclusivo, o e-mail secundário substituirá o principal no contato existente. Para evitar a substituição do e-mail principal, não inclua a coluna ID do Registro para o cenário acima.
- Se você não incluir a propriedade de E-mail ou outro identificador exclusivo na importação, cada linha do arquivo de importação será importada como um novo registro do contato.
- Se já existirem vários registros com o mesmo endereço de e-mail de um contato que está sendo importado, você receberá um erro de importação e esse contato não será importado.

Desduplição automática de empresas por domínio da empresa

Quando um novo empresa é adicionado, o HubSpot procura os valores principais do Empresa domínio propriedade para desduplicar empresas. Saiba como definir um domínio como principal. Se você estiver sincronizando empresas por meio de um aplicativo de sincronização de dados da HubSpot, regras personalizadas podem ser aplicadas. Saiba mais sobre aplicativos de sincronização de dados HubSpot.

Manual: se você tentar criar manualmente um empresa com o mesmo domínio que o domínio principal de um empresa existente, o HubSpot alertará que já existe um empresa.
Envio de formulário : se um envio de formulário incluir propriedades empresa, quando o Empresa domínio estiver incluído, uma empresa existente correspondente à domínio será atualizada ou uma nova será criada se O domínio não corresponde a um valor existente. Quando não houver domínio no envio, se aplicável, a empresa principal associada ao contato será atualizada.
Importar: quando adicionados por meio de importação, os valores de Empresa domínio principal e secundário são usados para desduplicar empresas, a menos que você tenha selecionado um valor exclusivo personalizado propriedade como identificador exclusivo. Se você usar um propriedade de valor exclusivo personalizado, seu arquivo poderá incluir nomes de empresa domínio duplicados.
- Se já existir uma empresa na sua conta com o mesmo nome de domínio ou valor de propriedade de ID exclusivo, as novas informações de empresa serão adicionadas à empresa existente.
- Se já existirem várias empresas com o mesmo nome de domínio ou valor de propriedade de ID exclusivo, você receberá um erro de importação e a empresa não será importada.

- Se você não incluir o Empresa domínio principal ou secundário ou outro ID exclusivo personalizado propriedade na importação, cada linha do arquivo será importada como um novo empresa. Saiba mais sobre o formato necessário para domínio propriedade valores.

Observação: as empresas criadas por meio da API não serão desduplicadas pelo Empresa domínio propriedade. Isso inclui aplicativos de sincronização de terceiros instalados.

Desduplicação manual no HubSpot

Você pode desduplicar manualmente objetos (por exemplo, contatos, listagens, objetos personalizados) criados no CRM da seguinte forma:

Desduplicação manual de registros pela propriedade de ID do registro

Quando você deseja importar registros de contato, empresa, negócio, ticket, produto, objeto ativado pelo administrador (por exemplo, serviço) ou objeto personalizado, pode usar a propriedade de ID de registro para fazer a correspondência desses registros com os registros existentes no HubSpot. Essa é uma propriedade padrão que armazena o valor exclusivo do registro e pode ser usada para desduplicar registros durante o processo de importação ou para pesquisar um registro específico no HubSpot.

Para obter os IDs de registro, exporte seus registros ou visualize o valor de um registro individual para ver o ID de registro.
Inclua uma coluna de ID de Registro em seu arquivo ao importar seus registros para o HubSpot. Se você incluir a coluna ID de registro no arquivo, qualquer linha sem um valor para ID de registro criará novos registros.
Durante a importação, você será solicitado a corresponder a coluna ao ID de registro na coluna Propriedade do HubSpot.

Saiba mais sobre como importar IDs de registro e como configurar seus arquivos de importação.

Observe: se você usar apenas IDs de Registro para desduplicar, é recomendável verificar se há registros existentes no HubSpot antes de importar um arquivo externo. Para fazer isso, você pode:

Exporte os registros com as IDs de registro e pelo menos uma propriedade que esteja incluída no arquivo externo.
Usar a função VLOOKUP para cruzar as informações do novo arquivo com o arquivo exportado. Saiba mais sobre como usar PROCV no Excel ou no Google Planilhas.
Atribua os valores corretos da ID de registro a qualquer dado duplicado que você tenha identificado.
Separe os dados em dois arquivos de importação: um com os registros existentes e suas IDs de registro e outro contendo todos os novos registros.
Importe os arquivos. O arquivo com as IDs de registro atualizará os registros existentes e o outro arquivo criará novos registros.

Desduplicação manual de registros pelas propriedades personalizadas de valor exclusivo

Para cada objeto, você pode criar até dez propriedades personalizadas que exigem valores exclusivos. Quando uma propriedade exige valores exclusivos, os usuários não poderão inserir o mesmo valor para vários registros.

Por exemplo, sua empresa cria um número de pedido para cada compra online. Você pode configurar uma propriedade de Número do pedido que exija um número exclusivo para cada negócio. Se um usuário tentar criar ou editar um negócio usando um valor de Número de pedido existente, ele será notificado de que o número já está em uso e não poderá salvar o negócio.

O seguinte comportamento é esperado para propriedades de valor exclusivo:

Compatível ao criar ou editar manualmente um registro no HubSpot e ao criar, atualizar ou associar registros por meio de importação.
Não compatível com formulários. Se o seu meta for atualizar ou associar registros existentes por meio de envios de formulários, é recomendado usar as propriedades padrão desduplicação (ou seja, E-mail, Empresa domínio Registro ID).
Suporte na conversão de visitantes em contatos; Os valores de propriedade do visitante que violam os requisitos de valor exclusivo serão apagados. Saiba mais sobre como identificar visitantes.

Próximas etapas

Saiba como revisar e gerenciar possíveis registros duplicados.

Esse artigo foi útil?

Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot.

Índice /pt/records/deduplication-of-records?error=error_code Menu