Ir para o conteúdo principal
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. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.

Importar registros para vários objetos

Ultima atualização: 9 de Janeiro de 2026

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

Importe registros para vários objetos para adicionar ou atualizar dados em diferentes objetos. Você pode importar registros, como empresas ou negócios, bem como atividades, como chamadas ou reuniões, e criar associações entre eles. Dependendo de como os dados são estruturados, importe dois objetos usando um único arquivo ou vários arquivos.

Se você estiver importando apenas um objeto, siga as etapas de importação de objeto único .

Se você é novo no HubSpot e quer migrar seus dados de CRM existentes para o CRM da HubSpot, solicite uma migração de dados à equipe de Reformulação da HubSpot.

Antes de começar

Antes de importar, revise os requisitos para importação de arquivos e como as importações funcionam.

Observação: sua conta pode usar nomes personalizados para cada objeto (por exemplo, conta em vez de empresa). Este artigo se refere aos objetos por seus nomes padrão de HubSpot.

Noções básicas sobre os requisitos

Assinatura necessária

  • É necessária uma assinatura do Marketing Hub Starter, Professional ou Enterprise com contatos de marketing para marcar os contatos importados como contatos de marketing.
  • Uma assinatura Professional ou Enterprise é necessária para importar rótulos de associação.

Permissões necessárias É necessário importar permissões e editar permissões para o objeto que você está importando para importar registros e atividades.


Observação: os e-mails, as reuniões, as observações e as tarefas existentes não podem ser atualizados por meio de uma importação, independentemente de como os dados são importados.

Importar registros de vários objetos (arquivo único)

  1. Em sua conta HubSpot, acesse Gerenciamento de dados > Integração de dados. Você também pode clicar em Importar na parte superior direita de qualquer página de índice de objeto .
  2. Na seção Importar um arquivo , clique em Importar dados.
  3. Clique em Importações avançadas (todos os objetos).
  4. Selecione os objetos (por exemplo, negócios, reuniões) que você deseja importar e clique em Próximo.
  5. Selecione Arquivo único.
  6. Clique no menu suspenso Escolha como importar [objetos] para cada objeto e selecione como importar os dados:

    Captura de tela do menu suspenso "Escolher como importar contatos", mostrando opções para criar e/ou atualizar contatos.
    • Criar e atualizar [registros]: a importação criará novos registros e atividades, além de identificar e atualizar os registros existentes. Para criar novos registros ou atividades, o arquivo deve conter as propriedades necessárias para esse objeto/atividade. Para atualizar os registros existentes, o arquivo deve conter um identificador exclusivo.
    • Apenas criar novos [registros]: a importação apenas criará novos registros e atividades. Os registos existentes no arquivo de importação serão ignorados. Para criar novos registros ou atividades, seu arquivo deve conter as propriedades necessárias para esse objeto/atividade.
    • Apenas atualizar [registros] existentes: a importação apenas atualizará os registros existentes. Os novos registros ou atividades no arquivo de importação serão ignorados. Para atualizar os registros existentes, o arquivo deve conter um identificador exclusivo.
  7. Clique em Exibir requisitos da propriedade de importação para abrir uma caixa pop-up e revisar as propriedades necessárias.
  8. Clique em Escolher um arquivo e selecione o arquivo de importação.
  9. Se você estiver importando dados em um idioma diferente do padrão, clique em Selecionar o idioma dos cabeçalhos de coluna no menu suspenso do arquivo e selecione o idioma . Selecionar o idioma correto permite que o HubSpot corresponda melhor seus cabeçalhos de coluna às propriedades padrão existentes. Se não houver correspondência no idioma selecionado, o HubSpot pesquisará uma propriedade em inglês para corresponder.
  10. Clique em Próximo.
  11. Verifique se você mapeou os identificadores exclusivos corretos:
    • ID do Registro: na linha ID do Registro , clique no menu suspenso Propriedade do HubSpot e selecione ID do Registro. Se uma linha no arquivo não contiver um valor para o ID do registro, um novo registro será criado.
    • E-mail (somente contatos): na linha E-mail , clique no menu suspenso Propriedade do HubSpot e selecione E-mail. O correto exibe um ícone de chave.
    • Empresa domínio (somente empresas): na linha Nome da Empresa Domínio , clique no menu suspenso Propriedade da HubSpot e selecione Empresa Domínio Nome. O correto exibe um ícone de chave. O propriedade Nome do Empresa Domínio aceita apenas valores até o domínio de nível superior (por exemplo, .com, .edu).
    • propriedade personalizado que exige valores exclusivos (somente para contatos, empresas, negócios, tickets e objetos personalizados): se você criou um propriedade que requer valores únicos, mapeie a coluna a esse propriedade na coluna propriedade do HubSpot. Ao importar várias propriedades de valor único, selecione qual propriedade usar como identificador na página Detalhes antes de concluir a importação.
      Captura de tela da página de mapeamento da propriedade de importação HubSpot. A propriedade HubSpot com "ID do Registro" é realçada com uma caixa laranja.
  1. Mapeie outras propriedades:
    • Na linha desejada, clique no menu suspenso Propriedade do HubSpot e selecione uma propriedade.
    • Se não quiser importar uma linha, clique no menu suspenso Importar como e selecione Não importar coluna.
      GIF mostrando como alterar os menus suspensos "Importar como" e "Propriedade HubSpot" para corrigir campos mapeados.

Observação: ao usar determinados identificadores exclusivos, o seguinte comportamento se aplica:

  • Se você usar o ID do registro como um identificador exclusivo, ele substituirá quaisquer outros identificadores exclusivos incluídos na importação.
  • Se você usar uma propriedade personalizada que exija valores exclusivos como identificador exclusivo:
    • Para empresas, a propriedade de Nome de domínio da empresa não exigirá mais valores exclusivos.
    • Para contatos, a propriedade E-mail ainda exigirá valores exclusivos.
  • Para contatos, se você usar o email secundário de um contato existente como identificador exclusivo, o email secundário não substituirá o email principal, desde que você o faça não inclua o Registro ID11 no seu arquivo. Se você incluir o e-mail secundário e o ID do registro no arquivo, o e-mail secundário substituirá o principal durante a importação.

  1. Se desejar, configure as seguintes opções avançadas ou pule para a próxima etapa:
    • Impedir a substituição da propriedade: se você estiver atualizando os registros existentes, impeça que a importação substitua os valores de propriedade existentes dos registros para a linha (por exemplo, Nome). 
      • Quando essa opção for selecionada para uma propriedade, a importação atualizará a propriedade para novos registros e registros existentes que nunca tiveram um valor para a propriedade.
      • Ela não atualizará a propriedade para registros existentes que tenham ou que já tiveram um valor, mesmo que estejam vazios no momento.
      • Na coluna Gerenciar valores existentes , marque a caixa de seleção Não substituir .
    • Importar rótulos de associação:
      • Na coluna Importar como, cliqueno menu suspenso e selecione Rótulo de associação . A importação de um novo rótulo de associação não substituirá um rótulo de associação existente. O rótulo importado será acrescentado ao registro como um rótulo de associação adicional. Saiba como remover manualmente um rótulo de associação de um registro .
      • Ao importar dois objetos, a coluna Propriedade do HubSpot preencherá automaticamente a relação dos objetos que estão sendo importados (por exemplo, Contato e Empresa). Ao importar mais de dois objetos, selecione os dois objetos cuja relação os rótulos de associação descrevem.
        GIF mostrando como usar o menu suspenso "Importar como" para definir uma coluna como "Rótulo de associação".
  2. Clique em Próximo.
  3. No campo de texto Importar nome , insira um nome.
  4. Marque a caixa de seleção Consentimento para concordar que os contatos esperam receber sua opinião e que seu arquivo de importação não inclui uma lista comprada. Saiba mais sobre a política de utilização responsável da HubSpot.
  5. Se desejar, configure as seguintes opções avançadas ou pule para a próxima etapa:
    • Selecione o propriedade de valor exclusivo (somente para contatos, empresas, negócios, tickets, objetos personalizados): se o arquivo incluir várias propriedades de valor exclusivo para um objeto, você deverá selecionar um propriedade para usar para desduplicação.
      • Esta opção não será exibida se você também tiver incluído a ID do Registro porque ela substituirá automaticamente os outros identificadores exclusivos.
      • Clique no menu suspenso Propriedade a usar para encontrar [objetos] existentes e selecione a propriedade que deseja usar para atualizar ou desduplicar registros.
    • Criar um segmento a partir de contatos importados: marque a caixa de seleção Criar um segmento de contatos a partir desta importação para criar automaticamente um segmento dos contatos importados.
    • Definir a base jurídica para o processamento de contatos: sevocê ativou as configurações de privacidade de dados na sua conta, clique no menu suspenso Definir a base jurídica para processar os dados de um contato e selecione uma base jurídica para processar .
    • Criar contatos de marketing: smarque a caixa de seleção Definir este contato como um contato de marketing para que possam ser usados em ferramentas de marketing, como e-mail de marketing. Saiba mais sobre a cobrança dos contatos de marketing .
      Página de configuração de importação mostrando "Registros enriquecidos" como o nome de importação, contrato verificado, opção de contatos de marketing e "Enriquecer com Breeze intelligence" marcado
    • Enriquecer registros: selecionea caixa de seleção Enriquecer registros para enriquecer contatos e empresas com o Breeze.
    • Configurar formatação de data e número:
      • Se você estiver importando propriedades de data ou data e hora, clique no menu suspenso Formato de data e confirme como os valores de data na planilha estão formatados. Para propriedades de data e hora, clique no menu suspenso Fuso horário para confirmar o fuso horário que a propriedade deve usar quando importada.
      • Se você estiver importando um arquivo com uma propriedade de número, clique no menu suspenso Formato de número e confirme o formato de número do país que deve ser usado nos dados.
  1. Clique em Finalizar importação.

Importar registros de vários objetos (vários arquivos)

Assinatura necessária É necessária uma subscrição profissional ou empresarial para importar etiquetas de associação.

  1. Inicie uma importação.
  2. Selecione os dois objetos desejados.
  3. Selecione como você deseja importar seus dados.
  4. Na seção Seus dados estão em um ou vários arquivos? , clique em Vários arquivos.
  5. Selecione um arquivo para cada objeto.
  6. Clique em Próximo.
  7. Indique qual coluna está incluída nos dois arquivos:
    • Clique no menu suspenso Cabeçalhos de coluna comuns encontrados em seus arquivos e selecione o nome da coluna comum.
    • Clique no menu suspenso Qual objeto é [coluna comum] a chave exclusiva para? e selecione o objeto para o qual a propriedade deve ser importada. Por exemplo, se estiver importando contatos e empresas e usar o nome da Empresa como coluna comum, selecione Empresa para carregar os dados em registros de empresa. Revise um arquivo de amostra.
  8. Mapeie as propriedades.
  9. Insira o nome da sua importação e defina as configurações opcionais.
  10. Clique em Concluir importação.

Gerenciar erros durante o mapeamento

Dependendo do erro, resolva-o na fase de mapeamento do processo de importação.  

  1. Na tela Mapear colunas em seu arquivo , clique em [x] erros para saber como resolvê-los.
    Imagem de um erro de importação em um campo mapeado.
  2. No painel direito:
    • Revise os detalhes do erro.
    • Clique em Editar valores com erro e selecione uma das seguintes opções:
      • Insira ou selecione um valor de substituição para cada linha.
      • Clique no verticalMenuIcon ícone de três pontos verticais e clique em Não importar este valor para interromper a importação do valor selecionado.
      • Clique em Concluído quando terminar.
  3. Prossiga com o restante da importação.

Próximas etapas

Depois da importação, você pode visualizar:

Se a importação continha erros, saiba como resolver esses erros.
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.