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.
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.
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.
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.
Dependendo do tipo de campo 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 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 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ê 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:
|
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, 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.
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.
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 em configurações de propriedade.
Observe: a propriedade de nome de domínio Empresa só aceita valores até o domínio de nível superior (por exemplo, .com, .edu). Os valores com strings após ele (por exemplo, .edu/home) serão automaticamente removidos quando você importar.
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.
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.
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 registros existentes e usar a ID do Registro como um identificador exclusivo, ou usar a propriedadecustom que requer valores exclusivos. Para contatos, você também pode usar Email. 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:
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 as mesmas associações de objeto, haverá requisitos adicionais.
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.
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 importações de mesmo objeto:
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.
Para criar associações de empresas matrizes-filhas via importação, saiba mais sobre a importação de empresas-filhas.
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.
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.