Ultima atualização: Março 8, 2023
Ao importar registros para o HubSpot, você pode encontrar erros. Veja como resolver erros detectados durante uma importação, baixar um arquivo de erro, visualizar detalhes do erro e corrigir problemas no arquivo de importação ou no Salesforce.
Antes de iniciar uma importação ou corrigir um arquivo com erros, saiba os termos e requisitos relevantes para importar no HubSpot.
Corrigr erros durante uma importação
Antes de concluir uma importação, o HubSpot verifica erros específicos nas três primeiras filas do arquivo. Se algum dos seguintes erros for detectado, ele será identificado durante o mapeamento das propriedades no processo de importação:
- Não foi possível encontrar o proprietário
- Não foi possível analisar a data
- Não foi possível analisar o número
- Falha na validação
- Domínio inválido
- E-mail inválido
- Opção de enumeração inválida
- ID de registro inválido
Para resolver esses erros na tela Mapear as colunas do seu arquivo para as propriedades do HubSpot:
- Passe o cursor do mouse sobre o ícone de exclamação e clique em Corrigir erros de importação na caixa pop-up.
- No painel direito, veja mais detalhes sobre o tipo de erro, incluindo qual coluna e linhas são impactadas.
- Se houver uma solução recomendada, a seção Corrigir este erro será exibida. Veja a solução recomendada e, dependendo do erro, selecione uma opção:
-
- Clique em Editar propriedade [nome]. O editor da propriedade será exibido no painel direito. Atualize a propriedade com base na recomendação e, em seguida, clique em Salvar.
- Se uma propriedade for somente leitura (por exemplo, certas propriedades padrão do HubSpot), você pode clicar em Visualizar propriedade [nome] para ver os detalhes da propriedade. Você não pode editar uma propriedade de somente leitura, então será necessário atualizar e reimportar seu arquivo para resolver o erro.
- Clique no menu suspenso para atualizar o formato (por exemplo, formato de Data ).
- Na seção Outras opções:
- Clique com o botão para expandir e visualizar cada opção adicional.
- Para ver mais detalhes sobre a propriedade que está mapeando, clique em Visualizar propriedade [nome].
- Para saber mais sobre o erro específico, clique em Saber mais sobre este erro.
- Depois de resolver um erro, haverá uma marca de verificação de na coluna Mapeado.
Observação: como o HubSpot só detecta erros nas três primeiras linhas, pode haver erros adicionais no resto do arquivo que não foram resolvidos.
Revisar erros após uma importação
Depois de concluir uma importação, você será levado automaticamente a um resumo da importação, incluindo uma visão geral de quaisquer erros. Você também pode revisar o resumo de uma importação concluída anteriormente.
- No cartão Resumo, exiba o número de linhas importadas, novos registros criados e registros existentes atualizados. Saiba mais sobre como analisar importações.
- Se a importação tiver erros, a seção Erros de importação aparecerá. Na tabela, veja as seguintes informações:
- Importar coluna do arquivo: o cabeçalho da coluna no seu arquivo que foi afetado pelo erro.
- Tipo de objeto: o objeto do CRM atribuído à coluna afetada.
- Propriedade do HubSpot: a propriedade no HubSpot que foi correspondida com a coluna afetada.
- Tipo de erro: o tipo de erro da coluna afetada. Saiba mais sobre todos os erros de importação.
- Impacto do erro: o número de linhas ou valores de propriedade que não foram importados como resultado do erro. Se uma linha não foi importada, isso significa que todas as colunas da linha afetada não puderam ser importadas. Se um valor não foi importado, isso significa que o valor na coluna dessa propriedade específica não pode ser importado, mas outras colunas na linha podem ser importadas.
- Para ver mais informações sobre um erro, passe o cursor do mouse sobre a linha e clique em Exibir detalhes.
- Para baixar a lista de erros em um arquivo, acima da tabela, clique em Baixar erros como arquivo.
- Extraia o arquivo CSV do arquivo compactado baixado e abra-o.
- No arquivo, identifique o código de erro na coluna Código de erro, o objeto do registro afetado na coluna Tipo de objeto, o motivo do erro na coluna Motivo e os valores de propriedade do registro nas colunas adicionais.
Depois de identificar os erros de importação, saiba como resolver erros específicos.
Importar erros do arquivo
A seguir, uma lista alfabética de códigos de erro, detalhes de erro e possíveis etapas para resolução. Em alguns casos, os registros com erros serão importados e poderão ser corrigidos no HubSpot ou corrigindo o arquivo de importação e fazendo uma nova importação. Em outros casos, os registros não serão importados e o arquivo de importação precisará ser corrigido antes da fazer uma nova importação.
Observação: os códigos de erro no arquivo baixdo conterão letras maiúsculas e caracteres sublinhados, mas serão listados como texto normal neste artigo. Por exemplo, o erro aparecerá como AMBIGUOUS_ENUMERATION_OPTION no arquivo, mas você vai encontrá-lo como a Opção de enumeração ambígua na tabela abaixo.
Opção de enumeração ambígua
O que significa o erro
O mesmo registro corresponde a mais de uma das opções existentes definidas para uma propriedade de enumeração.Isso se aplica a propriedades de seleção múltipla, seleção de menu suspenso, botão de opção e caixa de seleção.
Você também pode ver este erro se o valor no arquivo for o rótulo da opção de propriedade, e não o seu valor interno. Isso se aplica às opções de propriedade de enumeração em que o rótulo é diferente do valor interno.
Os registros afetados foram importados, mas a propriedade de enumeração não contém um valor.
Como resolver o erro
Você também pode atualizar manualmente o valor da propriedade nos registros afetados.
Não foi possível encontrar o proprietário
O que significa o erro
O arquivo de importação contém um proprietário de registro que não corresponde a um usuário no HubSpot. Os registros afetados foram importados, mas o campo Proprietário não contém um valor.
Como resolver o erro
Atualize os dados na coluna Proprietário do arquivo de importação para incluir o nome e sobrenome ou o e-mail de um usuário da sua conta. Se a pessoa que deseja atribuir o registro ainda não é um usuário na conta, adicione-a como usuário e depois importe-a novamente com seu nome ou e-mail como aparece na conta.
Não foi possível analisar a data
O que significa o erro
O arquivo de importação contém valores de data que não correspondem ao formato selecionado durante o processo de importação.Os registros afetados foram importados, mas a propriedade de data não contém um valor.
Como resolver o erro
Atualize o arquivo de importação com o valor correto e importe-o novamente, ou atualize o valor da propriedade manualmente nos registros afetados.
Não foi possível analisar o número
O que significa o erro
O arquivo de importação contém um valor para uma propriedade numérica com caracteres não numéricos. Os registros afetados foram importados, mas a propriedade numérica não contém um valor.
Como resolver o erro
Atualize o arquivo de importação com o valor numérico correto e importe-o novamente, ou atualize o valor da propriedade manualmente nos registros afetados.
Não foi possível analisar a linha
O que significa o erro
O arquivo de importação contém uma linha com dados que não podem ser processados. Se for uma propriedade obrigatória, os registros não foram importados. Se não for uma propriedade obrigatória, os registros foram importados, mas essa propriedade não contém um valor.
Como resolver o erro
Verifique se o valor dos dados corresponde ao formato correto para a propriedade que você está importando, corrija quaisquer erros e depois importe novamente o arquivo. Você também pode atualizar o valor da propriedade manualmente nos registros afetados.
Não foi possível analisar o prazo
O que significa o erro
O arquivo de importação contém um valor para um período de tempo que não corresponde a um formato de prazo aceito. Os registros afetados ainda foram importados, mas a propriedade de prazo não contém um valor.
Como resolver o erro
Atualize os valores do prazo no arquivo para serem um número inteiro de meses ou em Formato de duração ISO8601 (por exemplo, um período de três anos, seis meses, quatro dias, seria P3Y6M4D), depois importe o arquivo novamente. Você também pode atualizar o valor da propriedade manualmente nos registros afetados.
Duplicar ID alternativo
O que significa o erro
A mesma ID alternativa foi usada várias vezes nos arquivos. Os dados foram importados, mas pode haver duplicatas do mesmo registro no HubSpot. Se você estava tentando fazer uma associação, seus registros não foram associados.
Como resolver o erro
- Para evitar duplicatas, use E-mail para contatos, Nome do domínio da empresa para empresas ou ID do registro para qualquer objeto.
- Para associar registros, use o E-mail, Nome do domínio da empresa, ID do registro ou escolha uma propriedade em massa para a qual um valor é exclusivo para os muitos registros associados a ela (por exemplo, Nome da empresa como uma propriedade, que será associada a muitos contatos que trabalham na mesma empresa). Consulte os arquivos de importação de amostra para obter mais orientações.
Duplicar ID de associação
O que significa o erro
A ID de associação que você escolheu para associar seus registros não é exclusiva.
Como resolver o erro
Escolha um cabeçalho de coluna diferente para agir como coluna comum entre seus dois arquivos. Para obter melhores resultados, escolha uma propriedade em massa para a qual um valor seja exclusivo para os muitos registros associados a ela (por exemplo, Nome da empresa como uma propriedade, que será associada a muitos contatos que trabalham na mesma empresa). Consulte os arquivos de importação de amostra para obter mais orientações. Depois de selecionar um novo ID de associação, importe novamente os arquivos.
Duplicar ID de registo
O que significa o erro
A mesmo ID de registro foi usada várias vezes nos arquivos. Os registros afetados não foram atualizados ou associados no HubSpot.
Como resolver o erro
Atualize seu arquivo de importação para que haja apenas uma linha com esse ID de registro. Mantenha a linha com as informações mais atualizadas que você deseja incluir no HubSpot. Depois de remover as duplicatas, importe novamente os arquivos.
Duplicar conteúdo da linha
O que significa o erro
O HubSpot detectou que o arquivo de importação contém objetos duplicados. A importação não criou um novo registro.
Como resolver o erro
Remova o objeto duplicado no arquivo de importação e importe-o novamente.
Duplicar um valor exclusivo de propriedade
O que significa o erro
O mesmo valor exclusivo foi usado várias vezes nos arquivos. Os dados foram importados, mas pode haver duplicatas do mesmo registro no HubSpot. Se você estava tentando fazer uma associação, seus registros não foram associados.
Como resolver o erro
- Para evitar duplicatas, use E-mail para contatos, Nome do domínio da empresa para empresas ou ID do registro para qualquer objeto.
- Para associar registros, use o E-mail, Nome do domínio da empresa, ID do registro ou escolha uma propriedade em massa para a qual um valor é exclusivo para os muitos registros associados a ela (por exemplo, Nome da empresa como uma propriedade, que será associada a muitos contatos que trabalham na mesma empresa). Consulte os arquivos de importação de amostra para obter mais orientações.
Falha ao criar associação
O que significa o erro
O HubSpot não consegue associar seus registros em seu formato atual. Os registros foram importados, mas não associados.
Como resolver o erro
Verifique se você cumpriu os requisitos de arquivo para associar seus registros. Se estiver importando em um arquivo, talvez seja necessário adicionar um identificador exclusivo para cada objeto. Se estiver importando em dois arquivos, você pode precisar selecionar uma coluna comum diferente para associar corretamente. Faça as alterações nos arquivos e importe-os novamente ou associe manualmente seus registros.
Falha de não adesão do contato
O que significa o erro
A HubSpot não conseguiu optar por não receber determinados contatos no arquivo de não adesão.Como resolver o erro
Falha ao processar objeto com valores de propriedade vazios
O que significa o erro
O arquivo contém valores em branco para várias colunas e o HubSpot não conseguiu processar o registro. Os dados nessa linha não foram importados.
Como resolver o erro
Preencha os valores de propriedade ausentes do arquivo de importação e importe novamente o arquivo.
Falha na validação da fase de E-mail, Negócio/Tíquete ou Pipeline de negócios/tíquete
O que significa o erro
Como resolver o erro
Arquivo não encontrado
O que significa o erro
O arquivo selecionado não foi encontrado. Seus dados não foram importados.
Como resolver o erro
Verifique se você salvou o arquivo no seu computador e que ele é o tipo de arquivo correto. Depois de fazer isso, carregue novamente o arquivo.
E-mail de lista de proibições de GDPR
O que significa o erro
O arquivo de importação contém um ou mais e-mails que foram bloqueados de comunicação devido ao GDPR. Esses contatos não foram importados.
Como resolver o erro
O arquivo de importação ainda importará seus outros contatos, mas você não pode adicionar os contatos bloqueados através de importação. Você pode adicionar esses contatos manualmente, mas eles serão cancelados automaticamente da comunicação de marketing.
Número incorreto de colunas
O que significa o erro
O arquivo de importação contém pelo menos uma coluna sem cabeçalho. Os dados das colunas sem cabeçalhos não foram importados.
Como resolver o erro
Confirme se os dados nas colunas devem ou não ser importados, adicione cabeçalhos apropriados ou remova as colunas e depois importe novamente o arquivo.
ID alternativo inválido
O que significa o erro
O arquivo de importação contém um valor inválido importado como um endereço de e-mail, nome de domínio ou ID do registro. A importação não criou ou atualizou o registro.
Como resolver o erro
Atualize seu arquivo de importação com o e-mail correto, nome de domínio ou valor de ID de registro e importe-o novamente.
Identificador de associação inválido
O que significa o erro
O arquivo de importação não contém um valor exclusivo adequado para associar seus registros. Os dados foram importados, mas os registros resultantes não foram associados no HubSpot.
Como resolver o erro
Atualize seu arquivo de importação para incluir um identificador de associação válido (por exemplo, E-mail para contatos, Nome de domínio da empresa para empresas ou IDs de registro) e importe-o novamente. Saiba como configurar os arquivos corretamente para importar e associar vários objetos.
Opção de enumeração inválida
O que significa o erro
O arquivo de importação contém um valor que não corresponde a uma opção existente em uma propriedade de enumeração. Isso se aplica a propriedades do tipo de caixa de seleção, seleção múltipla, seleção de menu suspenso e seleção de botão. Os registros afetados ainda foram importados, mas a propriedade de enumeração não contém um valor.
Como resolver o erro
Identifique o valor incorreto comparando seu arquivo de importação em relação à propriedade no HubSpot. Você pode escolher atualizar o valor no arquivo de importação para corresponder a uma opção existente ou adicionar o valor como uma opção personalizada à sua propriedade. Depois de terminar, importe novamente o arquivo ou atualize o valor da propriedade manualmente nos registros afetados.
Tipo de arquivo inválido
O que significa o erro
O arquivo de importação é o tipo de arquivo incorreto para importar no HubSpot. Os dados não foram importados.
Como resolver o erro
Converta seu arquivo para .csv, .xls, ou .xlsx e importe novamente. Revise os requisitos de arquivos adicionais para importar no HubSpot.
Tamanho do número inválido
O que significa o erro
O arquivo de importação contém um valor numérico muito pequeno ou muito grande. As linhas afetadas foram importadas, mas a propriedade numérica não contém um valor.
Como resolver o erro
Confirme os requisitos de formato da sua propriedade específica ou o tipo de propriedade, atualize o arquivo para corresponder ao formato correto e importe-o novamente. Você também pode atualizar manualmente o valor da propriedade nos registros afetados.
ID de registro inválido
O que significa o erro
Durante a importação, a caixa de seleção para atualizar os registros existentes usando IDs de registro estava marcada. No entanto, o ID de registro listado no arquivo não corresponde a um ID existente no HubSpot. Os registros não foram importados.
Como resolver o erro
Verifique se os IDs de registro estão corretos. Pode ser necessário exportar seus registros existentes para obter IDs de registro corretos. Se você não estiver atualizando ou associando objetos existentes no HubSpot, não marque a caixa de seleção durante o processo de importação.
Propriedade necessária inválida
O que significa o erro
Uma propriedade obrigatória no arquivo de importação contém um valor inválido. Os dados nessa linha não foram importados.
Como resolver o erro
Confirme os requisitos de formato da sua propriedade específica ou o tipo de propriedade, atualize o arquivo para corresponder ao formato correto e importe-o novamente.
Contagem de planilha inválida
O que significa o erro
O arquivo de importação contém mais de uma planilha. Seus dados não foram importados.
Como resolver o erro
Remova quaisquer planilhas adicionais do seu arquivo de importação e importe novamente. Revise os requisitos de arquivos adicionais para importar no HubSpot.
Planilha inválida
O que significa o erro
O arquivo de importação não é um arquivo de planilha válido. Seus dados não foram importados.
Como resolver o erro
Converta seu arquivo para .csv, .xls, ou .xlsx e importe novamente. Revise os requisitos de arquivos adicionais para importar no HubSpot.
Limite excedido
O que significa o erro
O HubSpot não consegue criar o registro devido a um limite. O arquivo pode ser muito grande ou pode ter atingido um limite da conta, como atingir o número máximo de listas. Seus dados não foram importados.
Como resolver o erro
Confirme se seu arquivo é menor que 150 MB, 1.000 colunas e 1.048.576 linhas. O número de linhas que você pode importar todos os dias também é limitado pelas assinaturas da sua conta:
- Se estiver usando as ferramentas gratuitas da HubSpot, você pode importar até 500.000 linhas por dia.
- Para todas as outras assinaturas, você pode importar até 10.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. Se o arquivo for maior, separe seus dados em vários arquivos. Em seguida, reimporte ao longo de vários dias. Se o arquivo for do tamanho correto, saiba mais sobre sua assinatura do HubSpot e suas limitações.
Várias empresas com esse domínio
O que significa o erro
O arquivo de importação contém em um valor Nome do domínio da empresa que corresponde a várias empresas na sua conta da HubSpot. A importação não atualizou o registro de empresa.
Como resolver o erro
Pesquise o valor Nome do domínio da empresa específico na página inicial de empresas para encontrar os domínios duplicados. Mescle os registros da empresa ou exclua um deles, em seguida, importe novamente o arquivo.
Vários proprietários encontrados
O que significa o erro
O arquivo de importação contém um valor de Proprietário que corresponde a mais de um usuário na conta. Isso geralmente ocorre para nomes (por exemplo, há dois usuários John Doe na sua conta da HubSpot e o arquivo de importação continha o nome "John Doe"). Os registros afetados foram importados, mas a propriedade Proprietário não contém um valor.
Como resolver o erro
Substitua o nome do proprietário pelo endereço de e-mail em seu arquivo de importação e importe-o novamente. Você também pode atualizar manualmente o valor da propriedade Proprietário nos registros afetados.
Fora de intervalo de prazo válido
O que significa o erro
O arquivo de importação contém um valor para um período de tempo que está fora do intervalo de prazo aceito. Os registros afetados foram importados, mas a propriedade de prazo não contém um valor.
Como resolver o erro
Atualize os valores do prazo no arquivo para estarem dentro do período aceito (um número inteiro maior ou igual a um mês) e depois importe novamente o arquivo. Você também pode atualizar o valor da propriedade manualmente nos registros afetados.
Fora do intervalo de tempo válido
O que significa o erro
O arquivo de importação contém um valor para um período de tempo que está fora do intervalo de tempo aceito. Os registros afetados foram importados, mas a propriedade de período não contém um valor.
Como resolver o erro
Atualize os valores no arquivo para estarem dentro do período aceito (menos de 1.000 anos) e depois importe novamente o arquivo. Você também pode atualizar o valor da propriedade manualmente nos registros afetados.
A definição da propriedade não foi encontrada
O que significa o erro
O arquivo de importação contém um cabeçalho de coluna que não corresponde a uma propriedade do HubSpot. Os dados nessa coluna não foram importados.
Como resolver o erro
Durante a importação, corresponda as colunas corretamente, selecionando uma propriedade existente ou criando uma nova propriedade na página de propriedades Mapear colunas no arquivo para[objeto]. Você também pode optar por ignorar a importação de colunas não correspondentes.
Valor da propriedade não encontrado
O que significa o erro
No arquivo de importação está faltando um valor para uma propriedade necessária. Os dados nessa linha não foram importados.
Como resolver o erro
Atualize o arquivo de importação para incluir um valor para a propriedade obrigatória, depois importe-o novamente.
ID de registro de associação desconhecido
O que significa o erro
Durante a importação, a caixa de seleção para atualizar os registros existentes usando IDs de registro estava marcada. No entanto, as IDs de registro obrigatórias não foram incluídos nos arquivos. Os dados foram importados, mas os registros resultantes não estão associados no HubSpot.
Como resolver o erro
Atualize seu arquivo de importação para incluir os IDs de registro e importe-o novamente. Pode ser necessário exportar seus registros existentes para obter IDs de registro corretos. Saiba como configurar os arquivos corretamente para importar e associar vários objetos.
Solicitação inválida desconhecida
O que significa o erro
O arquivo de importação contém um ID de registro inválido que não corresponde a nenhum registro existente na sua conta da HubSpot. A importação não atualizou o registro, pois os dados não correspondem a nenhum registro existente.
Como resolver o erro
Verifique se você tem o ID de registro correto. Se você encontrar um ID incorreto, atualize seu arquivo de importação com o ID de registro correto e importe-o novamente.
Erro desconhecido
O que significa o erro
O HubSpot não consegue processar o arquivo devido a um erro desconhecido. Seus dados não foram importados.
Como resolver o erro
Confirme se o arquivo atende a todos os requisitos. Tente importar novamente após limpar o cache do navegador ou usar outro navegador. Se você ainda estiver vendo um erro, publique na Comunidade (todos os usuários) ou entre em contato com a equipe de suporte(somente conta do Starter, Professional e Enterprise).
Erros de importação do Salesforce
- Acesse os registros:
- Contatos: Na sua conta da HubSpot, navegue até Contatos > Contatos.
- Empresas: Na sua conta da HubSpot, navegue até Contatos > Empresas.
- Negócios: Na sua conta da HubSpot, navegue até Vendas > Negócios.
- Tickets: Na sua conta da HubSpot, navegue até Serviço > Tíquetes.
- Objetos personalizados: na sua conta da HubSpot, acesse Contatos > Contatos, em seguida, clique no menu suspenso no canto superior esquerdo e selecione o nome do objeto personalizado.
- Produtos: Na sua conta da HubSpot, clique no ícone de configurações settings na barra de navegação principal. No menu da barra lateral esquerda, acesse Objetos > Produtos e orçamentos.
- No canto superior direito, clique em Importar. Se você estiver na página de índice de produtos, clique no menu suspenso Ações e, em seguida, selecione Importar.
- Passe o cursor do mouse sobre a importação do Salesforce que tem erros e clique em Exibir erros de importação.
- Na tabela Erros de importação, passe o cursor do mouse sobre um erro e clique em Exibir detalhes para ver mais informações.
- O painel direito mostrará uma descrição do erro, juntamente com as informações de resolução. Você também verá uma lista de registros afetados pelo erro. Clique em um link de registro para acessar o registro e fazer alterações conforme necessário.
