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.
Contacts

Solução de problemas dos erros de importação

Ultima atualização: Abril 27, 2022

Disponível para

Todos os produtos e planos

Ao importar registros para o HubSpot, você pode encontrar erros. Veja como resolver um erro detectado 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.

Resolver 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:

Para resolver esses erros na tela Mapear as colunas do seu arquivo para as propriedades do HubSpot:

  • Passe o cursor do mouse sobre o exclamation ícone de exclamação e clique em Corrigir erros de importação na caixa pop-up.

import-error-preview

  • No painel direito, veja mais detalhes sobre o tipo de erro, incluindo qual coluna e linhas são impactadas.

fix-import-errors-pane

  • 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 direito 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 sucesso 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.

Baixar arquivo de erro

  • 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.
    • Tíquetes: Na sua conta da HubSpot, navegue até Serviço > Tíquetes.
    • Objetos personalizados: Na sua conta da HubSpot, acesse Contatos > Contatos, clique no menu suspenso, no canto superior esquerdo, e selecione o nome do objeto personalizado.
  • No canto superior direito, clique em Importar.
  • Passe o cursor do mouse sobre a importação do arquivo com erros, clique no menu suspenso Mais e selecione Baixar arquivo de erro.
  • Extraia o arquivo CSV do arquivo compactado baixado e abra o arquivo CSV.
  • No arquivo, identifique o código de erro no cabeçalho Código de erro, o objeto afetado no Tipo de objeto, o motivo do erro na coluna Motivo e os detalhes do objeto com erro nas colunas subsequentes.

Resolver um erro de arquivo de importação

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 conterá letras maiúsculas e caracteres sublinhados, mas estão listados em 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

Identifique o valor incorreto comparando seu arquivo de importação em relação à propriedade no HubSpot. Atualize o valor no arquivo de importação para corresponder apenas a uma opção existente, ou o valor interno da opção se o rótulo for diferente do seu valor interno. Depois de atualizar o valor, importe novamente o arquivo. 

Você também pode atualizar
manualmente o valor da propriedade nos registros afetados.
 
Se os registros precisarem corresponder a várias opções, saiba como formatar o arquivo para importar corretamente os dados para várias propriedades de caixa de seleção.

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

Escolha um cabeçalho de coluna diferente para agir como uma ID alternativa e depois importe novamente os arquivos.
  • Para evitar duplicatas, use E-mail para contatos, Nome do domínio da empresa para empresas ou ID [Objeto] para qualquer objeto. 
  • Para associar registros, use o E-mail, Nome do domínio da empresa, ID [Objeto] ou escolha uma propriedade em massa para a qual um valor é exclusivo para vários registros associados a ela (por exemplo,Nome da empresa como uma propriedade, que será associada à muitos contatos que trabalham na mesma empresa). Consulte os arquivos de importação de amostra para obter mais orientações.
Se você tiver várias empresas que usam o mesmo domínio, considere criar manualmente as empresas matriz e afiliada.

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 objeto

O que significa o erro

A mesma ID de [objeto] foi usada várias vezes nos arquivos. Os registros afetados não foram atualizados ou associados no HubSpot.

Como resolver o erro

Atualize o arquivo de importação para que haja apenas uma linha com esta ID de[objeto]. 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

Escolha um cabeçalho de coluna diferente para agir como um valor exclusivo e depois importe novamente os arquivos.
  • Para evitar duplicatas, use E-mail para contatos, Nome do domínio da empresa para empresas ou ID [Objeto] para qualquer objeto. 
  • Para associar registros, use o E-mail, Nome do domínio da empresa, ID [Objeto] ou escolha uma propriedade em massa para a qual um valor é exclusivo para vários registros associados a ela (por exemplo,Nome da empresa como uma propriedade, que será associada à muitos contatos que trabalham na mesma empresa). Consulte os arquivos de importação de amostra para obter mais orientações. 
Se você tiver várias empresas que usam o mesmo domínio, considere criar manualmente as empresas matriz e afiliada.

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

Confirme se você tem um valor de E-mail para todos os contatos na sua lista de não adesão. Se houver e-mails ausentes, adicione seu endereço de e-mail ao arquivo para optar pela não adesão do contato em receber e-mails. Você também pode criar contatos manualmente e retirá-los do registro de contatos.

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

O arquivo de importação contém um endereço de e-mail que não está de acordo com o formato de um endereço de e-mail típico (por exemplo, nome@domínio.com) ou um valor para a propriedade de Fase do negócio, Pipeline do negócio, Status do tíquete ou Pipeline do tíquete não corresponde a um nome de fase, status ou pipeline existente no HubSpot. A importação não criou ou atualizou os registros.
 

Como resolver o erro

Para contatos, atualize o arquivo de importação com o e-mail correto e importe-o novamente. Para negócios ou tíquetes, atualize o arquivo de importação com o nome da fase, do status e do pipeline corretos ou adicione a fase do negócio ou status do tíquete personalizado no HubSpot. Depois de terminar, importe o arquivo novamente.

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 [objeto]A importação não criou ou atualizou o registro.

Como resolver o erro

Atualize o arquivo de importação com o e-mail, o nome do domínio ou o valor da ID de [objeto] correto 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 o arquivo de importação para incluir um identificador de associação válido (por exemplo, E-mail para contatosNome de domínio da empresa para empresas ou IDs de [objeto]) 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 o valor da propriedade manualmente nos registros afetados.

ID de objeto inválido

O que significa o erro

Durante a importação, a caixa de seleção para atualizar os registros existentes usando IDs [objeto] estava marcada. No entanto, o ID [objeto] listado no arquivo não correspondia a um ID existente no HubSpot. Os registros não foram importados.

Como resolver o erro

Verifique se as IDs de [objeto] estão corretas. Pode ser necessário exportar seus registros existentes para obter as IDs de objeto corretas. 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 e tem menos de 250.000 linhas e 1.000 colunas. Se o arquivo for maior, separe seus dados em vários arquivos e importe novamente. 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.

Nenhum ID de objeto do identificador de associação

O que significa o erro

Durante a importação, a caixa de seleção para atualizar os registros existentes usando IDs [objeto] estava marcada. No entanto, as IDs de objeto obrigatórias não foram incluídas nos arquivos. Os dados foram importados, mas os registros resultantes não estão associados no HubSpot.

Como resolver o erro

Atualize o arquivo de importação para incluir as IDs de objeto, depois importe-o novamente. Pode ser necessário exportar seus registros existentes para obter as IDs de objeto corretas. Saiba como configurar os arquivos corretamente para importar e associar vários objetos.

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.

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 a IDde [objeto] correta. Se você encontrar uma ID incorreta, atualize o arquivo de importação com a ID de [objeto] correta e importe novamente o arquivo.

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.
    • Tíquetes: Na sua conta da HubSpot, navegue até Serviço > Tíquetes.
    • Objetos personalizados: Na sua conta da HubSpot, acesse Contatos > Contatos, 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.

salesforce-import-errors-view-details

  • 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. 
salesforce-import-error-details
Was this article helpful? *
This form is used for documentation feedback only. Learn how to get help with HubSpot.