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.

Configurar arquivos de importação

Ultima atualização: Março 6, 2025

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

Todos os produtos e planos

Antes de importar dados no HubSpot, revise os limites e requisitos a seguir. Você também pode acessar arquivos de amostra ou gerar arquivos de exemplo para começar.

Para saber mais sobre a ferramenta de importação, consulte este artigo. Se o arquivo estiver pronto, saiba como importar.

Requisitos e limites técnicos

Todos os arquivos sendo importados para o HubSpot devem:

Ser um arquivo .csv, .xlsx ou .xls.
Ter apenas uma planilha.
Inclua uma linha de cabeçalho na qual cada cabeçalho de coluna corresponda a uma propriedade no HubSpot. Os cabeçalhos de colunas podem ser organizados em qualquer ordem sem afetar a importação. Você pode confirmar se uma propriedade padrão já existe para corresponder ao cabeçalho ou criar uma propriedade personalizada antes da importação. Saiba mais sobre os requisitos de propriedade.

Conter menos de 1000 colunas.
Ser codificado em UTF-8 se os caracteres de idiomas estrangeiros estiverem incluídos.
Se estiver importando um arquivo do Excel:
- Conter dados que permanecem abaixo dos limites máximos de planilhas e pastas de trabalho do Excel.
- Contém células no Formato de número ao importar propriedades de seletor de data e hora.

Existem limites técnicos adicionais para a ferramenta de importação, dependendo da sua assinatura do HubSpot. Estes limites incluem o tamanho e os limites de linha de um arquivo de importação, bem como quantos arquivos e linhas podem ser importados por dia.

Com as ferramentas gratuitas do HubSpot, você pode:
- Importar arquivos de até 20 MB.
- Realizar até 50 importações por dia.
- Importar até 500.000 linhas por dia. A importação de um arquivo com mais de 500.000 linhas levará vários dias para ser concluída.
Se sua conta tem uma assinatura Starter, Professional ou Enterprise, você pode:
- Importar arquivos de até 512 MB.
- Realizar até 500 importações por dia.
- Importar até 10.000.000 linhas por dia, com um limite de 1.048.576 linhas por arquivo. Com a API de importações, você pode importar até 80.000.000 linhas por dia.

Esses limites se aplicam a um período de 24 horas e não são redefinidos em um horário específico do dia. Saiba mais sobre a assinatura do HubSpot e suas limitações.

Formatar valores

Para cada linha do arquivo de importação, você pode adicionar valores para as colunas de propriedades. A formatação de um valor depende do tipo de campo da propriedade e do objetivo da importação.

Formatar valores com base no tipo de campo de propriedade

Dependendo do tipo de campo da propriedade, há requisitos de formatação específicos:

Tipo de campo	Requisitos
Seletor de data Seletor de data e hora	Os meses podem ser um número, três letras ou um nome completo (10, OUT, Out, OUTUBRO, Outubro), os anos podem ser dois ou quatro dígitos (2023, 23) e os separadores podem ser uma barra, hífen ou ponto (28/10/2023, 28-10-2023, 28.10.2023). Os formatos de data válidos são: dia, mês, ano (por exemplo, 28/10/2023); mês, dia, ano (por exemplo, 10-28-23); ou ano, mês, dia (por exemplo, 2023.OUT.28). Se você tiver definido regras de validação, os valores importados deverão seguir as regras ou não serão importados.
Seletor de data e hora	Os carimbos de data/hora podem ser adicionados como hh:mm (28/10/2020 14:30) em todos os tipos de arquivo ou como um carimbo de data/hora UNIX em milissegundos em arquivos CSV ou Excel com células no formato de número como texto. Se não incluir um carimbo de data/hora, a hora será definida por padrão como meia-noite.
Duração	Para propriedades que contêm uma duração, como a propriedade Duração da chamada, seus valores devem ser formatados como um carimbo de data/hora UNIX em milissegundos. Saiba mais sobre como formatar valores de registro de data e hora e converter uma data para o formato UNIX.
Enumeração	Os valores no arquivo de importação devem corresponder ao rótulo ou ao valor interno das opções definidas para a propriedade. Para propriedades de enumeração padrão do HubSpot (por exemploFase do ciclo de vida, Setor), os valores devem corresponder ao valor interno ou ao rótulo em inglês.
Arquivo	Para adicionar arquivos existentes a uma propriedade de arquivo, inclua o ID do arquivo como seu valor. Você pode encontrar o ID de um arquivo na seção Geral dos detalhes de um arquivo.
Várias caixas de seleção	Para importar vários valores, adicione um ponto e vírgula entre cada valor sem espaços (valor 1;valor 2). Essas opções de propriedade devem ser criadas antes da importação. Para adicionar ou anexar valores, adicione um ponto e vírgula antes do primeiro valor (;valor 3;valor 4). Isso acrescentará o valor em vez de substituí-lo da propriedade existente.
Número	Formate o valor com base no tipo de propriedade numérica criada: Moeda: para propriedades que contêm um valor de moeda ou preço, você deve usar uma das moedas aceitas pelo HubSpot. A lista de moedas aceitas e seus códigos de moeda podem ser encontrados na guia Moeda das configurações padrão da conta. Para USD, os dados de moeda devem ser formatados com decimais (por exemplo, 123,45) Porcentagem: formate seus valores com um sinal de porcentagem (%) ou como um decimal. Por exemplo, para importar 25%, sua célula deve conter 25% ou 0,25. Número de telefone: as propriedades de contato Número de telefone e Número de telefone celular, para importar e formatar automaticamente o número de telefone com base no código do país, formate-os como +[código do país][número]. Se houver uma extensão, adicione ext[número]. Por exemplo, um número de telefone com um código de país dos Estados Unidos seria +11234567890 ramal 123. Se você tiver definido regras de validação, os valores importados deverão seguir as regras ou não serão importados.
Caixa de seleção única	Crie uma coluna para o campo de caixa de seleção única e defina o valor em cada linha como Verdadeiro ou Sim para exibir como "Sim" ou marcado no HubSpot ou como Falso ou Não para exibir como "Não" ou não marcado no HubSpot.
Propriedades de vigência	A Vigência da propriedade de item de linha deve ser adicionada nos formatos de período ISO-8601: PnYnMnD ou PnW. Por exemplo, P12M ou P24M para vigências anuais. Se deixado em branco, as vigências padrão serão definidas.
Texto	Se você tiver definido regras de validação, os valores importados deverão seguir as regras ou não serão importados.
Usuário (Proprietário)	Para atribuir um proprietário a um registro ou atividade durante a importação: Para objetos, inclua o cabeçalho Proprietário do [Objeto]. Para atividades, inclua o cabeçalho Atividade atribuída a. Adicione o nome do usuário, o endereço de e-mail ou o valor interno da propriedade Proprietário para cada linha nessa coluna. Se existir mais de um usuário com o mesmo nome em sua conta, é recomendado usar o endereço de e-mail ou o valor interno da propriedade Proprietário. Os usuários atribuídos como proprietários via importação não receberão uma notificação de que receberam um novo registro/atividade.

E-mails de contato adicionais ou domínios de empresa

Se você estiver importando contatos com mais de um endereço de e-mail, inclua a coluna Endereços de e-mail adicionais em seus e-mails secundários. Se você estiver importando empresas com mais de um nome de domínio, inclua uma coluna Domínios adicionais com seus domínios secundários. Para incluir vários e-mails ou domínios em uma célula, separe os valores com ponto e vírgula (por exemplo email@email.com; emailtwo@email.com).

Se você estiver importando para criar contatos ou empresas, você não pode definir o E-mail de um novo contato ou o nome de domínio de uma nova empresa como um e-mail ou domínio que seja um e-mail/domínio adicional existente em outro registro.

Células em branco

A ferramenta de importação ignora células em branco em uma planilha. Por isso, ao importar novos dados de propriedade, deixe as células em branco para registros que não tenham um valor para a propriedade. Se um registro existente já tiver um valor para a propriedade no HubSpot, as células em branco não apagarão o valor existente. Para limpar valores de propriedade existentes em massa, você pode editar manualmente os valores ou utilizar a ação de fluxo de trabalho Limpar valor da propriedade.

Colaboradores do negócio

Se você estiver adicionando colaboradores a um negócio via importação, inclua o cabeçalho Colaborador do negócio. Em cada célula, você precisa incluir dois ou mais usuários, separados por ponto e vírgula (por exemplo, user1@example.com;user2@example.com).

Vigência do produto e frequências de cobrança

Ao importar um valor de propriedade de Vigência, você pode formatar o valor na coluna Período como um número de meses (por exemplo, 10 para 10 meses), PXM, onde X é o número de meses (por exemplo, P6M, para um período de seis meses) ou PXY, onde X é o número de anos (por exemplo, P1Y, para um período de um ano).

Ao importar um valor de propriedade de Frequência de cobrança, use mensalmente, anualmente ou trimestralmente se o produto tiver um tipo de preço recorrente. Deixe a célula em branco se o produto tiver um preço único.

Propriedades obrigatórias

Dependendo dos objetos ou atividades que você está importando, as seguintes propriedades serão necessárias para criar registros e devem ser incluídas como cabeçalhos de coluna nos arquivos. Se você estiver atualizando registros, deverá incluir um identificador exclusivo (por exemplo, ID de registro, E-mail, Nome de domínio da empresa).

Embora não seja obrigatório, você pode importar propriedades adicionais para cada objeto, incluindo propriedades personalizadas e padrão. Consulte as propriedades padrão para contatos, empresas, negócios, tickets, chamadas, e-mails, reuniões, observações e tarefas. Você também pode exibir todas as propriedades e seus valores nas configurações da propriedade.

Contatos: pelo menos um dos seguintes: Nome, Sobrenome ou E-mail.
Empresas: pelo menos um dos seguintes: Nome ou Nome de domínio da empresa.
Negócios: ao criar novos negócios, o Nome, Pipeline e Fase do negócio.
Tickets: ao criar novos tickets, nome do ticket, Pipeline e Status do ticket.
Compromissos: Início do compromisso. O início do compromisso deve ser formatado como uma propriedade de data e hora.
Cursos: Nome do curso.
Listagens: Nome.
Serviços: Nome, Pipeline e Fase do pipeline.
Produtos: se estiver criando produtos, Preço unitário e Nome.
Pedidos: Nome, Pipeline e Fase do pipeline.
Carrinhos: Nome.

Itens de linha: Nome, Quantidade, Preço e o ID do registro do negócio associado ou o nome do negócio. Inclua o ID do produto se também estiver associando o item de linha a um produto, que será mapeado como uma propriedade do item de linha durante a importação.

Observação: ao importar itens de linha com negócios, a importação não atualizará o valor do negócio. Para atualizar o valor do negócio associado, você pode editar manualmente os itens de linha ou associá-los a um negócio no HubSpot.

Chamadas: Observações da chamada. Ao importar novas chamadas, também é recomendado incluir adata da atividade.
E-mails: Corpo do e-mail e Direção do e-mail.
Reuniões: Descrição da reunião, hora de início da reunião e hora de término da reunião. Ao importar novas reuniões, também é recomendado incluir a data da atividade. Os valores de hora de início, hora de término e data da atividade devem ser formatados como propriedades de data e hora.
Observações: Corpo da observação.
Tarefas: Título da tarefa e Data de conclusão. A data de vencimento deve ser formatada como uma propriedade de data e hora.

Observação: embora não seja obrigatório, é recomendado incluir a data da atividade ao importar novas atividades para especificar a data e a hora em que uma atividade ocorreu. Se você não incluir esta propriedade, os valores de Data da atividade serão definidos automaticamente para a data e hora da importação.

Requisitos para atualizar registros existentes ou evitar duplicações

Para atualizar os registros existentes e evitar duplicatas, seus arquivos devem incluir uma propriedade de identificador exclusivo para cada objeto. Para todos os objetos, você pode exportar os registros existentes e usar a ID do registro como um identificador exclusivo , ou usar uma propriedade personalizada que exija valores exclusivos. Para contatos, você também pode utilizar E-mail. Para empresas, você também pode utilizar o nome de domínio da Empresa.

Se você importar vários objetos e incluir IDs de registro, recomenda-se diferenciar os cabeçalhos das colunas do arquivo de modo a corresponder o ID com o objeto correto (por exemplo, uma coluna chamada ID de registro - Contatos e outra chamada ID de registro - Empresas).

Observação: o comportamento a seguir se aplica se o E-mail ou Nome de domínio da empresa estiver incluído no seu arquivo:

Se você estiver usando uma propriedade de valor exclusivo personalizada para desduplicar contatos, a propriedade E-mail ainda exigirá valores exclusivos.
Se você estiver usando uma propriedade de valor exclusivo personalizada para desduplicar empresas, a propriedade Nome de domínio da empresa não exigirá valores exclusivos. Isso significa que você pode importar domínios duplicados da empresa. Se não quiser várias empresas com o mesmo domínio, você deverá remover os domínios duplicados do seu arquivo antes de importá-lo ou usar o nome de domínio da empresa como identificador exclusivo.
Você pode usar um e-mail secundário como identificador exclusivo para contatos existentes que têm um endereço de e-mail secundário listado no HubSpot. Se você usar um e-mail secundário e não incluir a coluna ID do registro no arquivo, o e-mail secundário não substituirá o e-mail principal. No entanto, se você incluir o e-mail secundário e o ID do registro como colunas no arquivo, o e-mail secundário substituirá o principal durante a importação.

Requisitos para associar registros

Importar associações em um arquivo

Em um arquivo, você pode associar dois ou mais registros por linha. Inclua informações sobre registros e/ou atividades associados na mesma linha e inclua um identificador exclusivo para cada objeto. Para associar um registro a vários registros ou atividades de outro objeto, inclua o identificador exclusivo do registro em várias linhas para cada registro que deseja associar.

Por exemplo, Luke Danes é gerente no Luke's Diner, mas um empreiteiro no The Dragonfly Inn. Para associá-lo às duas empresas, seria necessário incluir duas linhas para Luke Danes com as colunas E-mail (ou ID do registro) e o Nome do domínio da empresa (ou ID do registro) para cada empresa.

Observação: se você não incluir identificadores exclusivos (por exemplo, E-mail, Nome do domínio da empresa, ID do registro), a importação criará registros duplicados, em vez de associar cada um ao mesmo registro.

Se você estiver importando associações de um mesmo de objeto, há requisitos adicionais.

Importar associações em dois arquivos

Para associar registros de dois objetos em dois arquivos, use uma coluna comum para conectar os registros de cada arquivo. Você pode consultar os arquivos de exemplo para obter mais ajuda sobre a importação e associação de registros.

Associações de um mesmo objeto

Você pode importar um arquivo para associar registros do mesmo objeto em massa. Durante o processo de importação, é preciso marcar uma caixa de seleção para incluir associações de mesmo objeto.

Ao configurar o arquivo, inclua informações sobre os registros associados na mesma linha e inclua um identificador exclusivo para cada registro. Os seguintes requisitos adicionais são específicos para importações de mesmo objeto:

Pelo menos um registro em um par de registros já deve existir no HubSpot antes da importação. Por exemplo, você pode importar um novo contato e associá-lo a um contato existente, mas não pode importar para criar e associar dois novos contatos.
Ao associar contatos/empresas existentes, você somente pode usar o e-mail/domínio da empresa principal como identificador exclusivo. E-mails ou domínios secundários não são permitidos.
Quando associar vários registros a um registro, separe os valores do identificador exclusivo dos registros por um ponto e vírgula na mesma célula (por exemplo, luke@lukesdiner.com; rory@yale.edu; sookie@dragonfly.com).

No arquivo de exemplo abaixo, Rory e Jackson são novos contatos associados com rótulos exclusivos para contatos existentes, usando os seus valores de E-mail como o identificador exclusivo. Sookie é um contato existente que está associado a dois contatos existentes com o mesmo rótulo. Na primeira linha, o rótulo de associação faz parte de um par de rótulos, o que significa que, uma vez concluída a importação, o registro associado terá o rótulo de Principal e Rory terá o rótulo combinado, Secundário.

Associações de empresas matrizes/afiliadas

Para criar associações de empresas matrizes/afiliadas via importação, saiba mais sobre a importação de empresas afiliadas.

Rótulos de associações personalizados (somente para Professional e Enterprise)

Para importar rótulos de associações, inclua uma coluna de Rótulo de associação. Esta coluna deve ser adicionada somente se você quiser adicionar rótulos para descrever associações. Se você não precisar rotular associações, a coluna não será necessária.

Você deve criar os rótulos de associação no HubSpot antes da importação.
Para definir uma associação de empresa como principal, inclua o valor Principal na coluna Rótulo de associação dessa linha.

Para definir vários rótulos para descrever a relação entre dois registros, você pode incluir vários valores de rótulos de associação em uma célula, separados por ponto e vírgula (por exemplo, Gerente; Contato de cobrança).

Se você estiver importando rótulos de associação em uma importação de vários arquivos, será preciso incluir a coluna de Rótulo de associação e um identificador exclusivo para o objeto que está associando no mesmo arquivo.
Se você estiver importando pares de rótulos:
- Para associações entre objetos, inclua apenas um dos rótulos na coluna Rótulo de associação. Os rótulos serão atribuídos ao objeto correto durante o processo de importação.
- Para associações de um mesmo objeto, o registro na coluna [Identificador exclusivo] associado receberá o rótulo adicionado no processo de importação ou incluído na coluna de rótulo do arquivo. O outro registro na linha receberá o outro rótulo do par.

Arquivos de exemplo

No início do processo de importação, você pode gerar um arquivo de exemplo com as propriedades necessárias para os objetos e atividades selecionados. Se você quiser revisar mais exemplos com propriedades adicionais, consulte este artigo com arquivos de exemplo.

Esse artigo foi útil? Sim Não

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