Configurar arquivos de importação
Ultima atualização: Dezembro 3, 2024
Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:
Todos os produtos e planos |
Antes de importar dados para o HubSpot, revise os seguintes limites e requisitos. 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 um a propriedade padrão já existe para corresponder ao seu 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 do 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 sua assinatura do HubSpot e suas limitações.
Formatando 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 meta da importação.
Formatar valores com base no tipo de campo propriedade
Dependendo do tipo de campo propriedade , há requisitos de formatação específicos:
Tipo de Campo | Requisitos |
Seletor de data Selecionador 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. |
Selecionador 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 arquivos ou como um carimbo de data/hora UNIX em milissegundos em arquivos CSV ou um arquivo Excel com células no formato de número de texto do tipo . 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 carimbo de data/hora e como converter uma data no formato UNIX. |
Enumeração |
Os valores no arquivo de importação devem corresponder ao rótulo ou ao valor interno das opções definidas da propriedade. Para propriedades de enumeração padrão do HubSpot (por exemplo, Estágio do ciclo de vida , Indústria), 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:
|
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 em HubSpot ou como Sim para exibir como Não ou não marcado em HubSpot. |
Texto |
Se você definiu regras de validação, os valores importados devem 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:
|
Emails de contato adicionais ou domínios de empresa
Se você estiver importando contatos com mais de um endereço de email, inclua uma coluna Endereços de email adicionais com seus emails 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, não poderá definir um Email de novo contato ou o nome de domínio da nova empresa para um email ou domínio que seja um email/domínio adicional existente para 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 usar a ação de fluxo de trabalho Limpar valor de propriedade.Colaboradores de negócio
Se você estiver adicionando colaboradores a um negócio via importação, inclua um cabeçalho de colaborador de Negócio . Para cada célula, você deve incluir dois ou mais usuários, separados por ponto-e-vírgula (por exemplo, user1@example.com;user2@example.com).Termos do produto e frequências de cobrança
Ao importar um valor de propriedade de Período, 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 de quais objetos ou atividades você está importando, as seguintes propriedades são necessárias para criar registros e devem ser incluídas como cabeçalhos de colunas nos arquivos. Se você estiver atualizando registros, deverá incluir um identificador exclusivo (por exemplo, ID de Registro, Email, 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 de contatos, empresas, ofertas, tickets, chamadas, emails, reuniões , bilhetes e tarefas. Você também pode exibir todas as propriedades e seus valores nas configurações da propriedade .
- Contatos: pelo menos um de Nome, Sobrenome, ou
- Empresas: pelo menos um dos Nomes ou Nomes 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 Pipeline , e
- Produtos: se você estiver criando produtos, Preço unitário e Nome.
- Itens de linha: Nome, Quantidade, Preço e o ID do registro do negócio associado ou o nome do negócio. Inclua a ID do produto se você também estiver associando o item de linha a um produto, que será mapeado como uma propriedade de 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 associar os itens de linha a um negócio no HubSpot.
- Chamadas: Observações da chamada. Ao importar novas chamadas, também é recomendado incluir Data 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 Data da atividade. Os valores de hora de início, hora de término e data de atividade devem ser formatados como propriedades de data-hora.
- Observações: Corpo da observação.
- Tarefas: Título da tarefa e Data de conclusão. A data de conclusão deve ser formatada como uma propriedade de data e hora.
Observe: embora não seja obrigatório, é recomendável incluir Data da atividade ao importar novas atividades para especificar a data e 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 registros existentes e evitar registros duplicados, seus arquivos devem incluir uma propriedade de identificador exclusiva para cada objeto. Para todos os objetos, você pode exportar registros existentes e usar a Identificação de Registro como um identificador exclusivo, ou usar a propriedade custom que requer valores exclusivos. Para contatos, você também pode usar Email. Para empresas, você também pode usar o nome de domínio Empresa.
Se você estiver importando vários objetos e estiver incluindo IDs de registro, é recomendável diferenciar os cabeçalhos de coluna do arquivo para corresponder a ID com o objeto correto (por exemplo, uma coluna chamada ID do Registro - Contatos e outra chamada ID do Registro - Empresas).
Observe que o comportamento a seguir se aplica se o nome de domínio de Email ou 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 email secundário como o identificador exclusivo para contatos existentes que possuem um endereço de e-mail secundário listado no HubSpot. Se você usar um email secundário e não incluir a coluna ID do Registro no arquivo, o email secundário não substituirá o email principal. No entanto, se você incluir o email secundário e a ID de Registro como colunas em seu arquivo, o email secundário substituirá o email principal.
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árias atividades ou registros de outro objeto, inclua o identificador exclusivo do registro em várias linhas para cada registro que você deseja associar.
Por exemplo, Luke Danes é um gerente no Luke's Diner, mas um empreiteiro no The Dragonfly Inn. Para associá-lo a ambas as empresas, você precisaria incluir duas linhas para Luke Danes com as colunas Email (ou ID de Registro ), e o domínio da Companhia nome (ou ID de Registro ) para cada empresa.
registro Observação: se você não incluir identificadores exclusivos (por exemplo, Email, Nome de domínio da empresa, IDs), a importação criará registros duplicados em vez de associar cada um ao mesmo registro.
Se você estiver importando as mesmas associações 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. Consulte os arquivos de exemplo para obter mais ajuda sobre como importar e associar registros.
Mesmas associações de objeto
Você pode importar um arquivo para associar registros do mesmo objeto em massa. Durante o processo de importação, você precisará marque uma caixa de seleção para incluir as mesmas associações de objetos.
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 as mesmas importações de 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 Pai e Rory terá o rótulo combinado, Filha.
Associações pai/filho
Para criar associações de empresas matrizes-filhas via importação, saiba mais sobre a importação de empresas-filhas.
Rótulos de associações personalizados (somente para profissionais e empresas )
Para importar rótulos de associações , inclua uma coluna de Rótulo de associação. Você deve criar os rótulos das associações no HubSpot antes de importar.
- 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 um importação de vários arquivos , você precisa incluir o Etiqueta de associação coluna e um identificador exclusivo para o objeto que você está associando no mesmo arquivo.
- Se você estiver importando rótulos emparelhados:
- Para associações de objeto cruzado, 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 as mesmas associações de objeto, o registro na coluna Associado [identificador exclusivo] 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.