DocTransform
Todos os guias de importação

O HubSpot não importa o seu ficheiro de contactos?

Corrija os erros que o HubSpot mostra ao importar contactos por CSV e depois importe limpo todas as semanas.

Erros mostrados pelo HubSpot

Falta uma propriedade obrigatória

Propriedades necessárias ausentes
Central de ajuda da HubSpot

Um valor de propriedade exclusiva está duplicado

Duplicar um valor exclusivo de propriedade
Central de ajuda da HubSpot

Uma data não corresponde ao formato escolhido

Não foi possível analisar a data
Central de ajuda da HubSpotComo corrigir este erro

O que o importador do HubSpot verifica

  • Toda propriedade que o seu portal marcar como obrigatória, Email incluído, precisa de um valor.

    assinalamos uma célula vazia assim que marca a coluna como obrigatória: menu ⋯ da coluna → Editar coluna… → Mais opções → Campo obrigatório; o filtro Precisa de carinho sobre a grelha lista cada vazio

    HubSpot ignora a linha

    Central de ajuda da HubSpot

    Última verificação: 25 de outubro de 2026

  • Uma propriedade marcada como exclusiva, como Email, não pode repetir-se dentro do ficheiro.

    O DocTransform corrige isto: escreva

    Coloque Email em minúsculas e remova as linhas com um Email duplicado

    Ou à mão

    clique no cabeçalho da coluna Email → minúsculas, depois Remover duplicatas; a linha do contacto duplicado é removida

    HubSpot importa de forma errada, sem erro

    Central de ajuda da HubSpot

    Última verificação: 25 de outubro de 2026

  • Um número de telefone («Phone Number») deve ser escrito como +[código do país][número].

    O DocTransform corrige isto: escreva

    Escreva Phone number como E.164

    Ou à mão

    abra Saúde → Telefones escritos de várias formas → Reescrever 4 valores (o botão mostra quantos números converte); cada número legível sai como +[código do país][número], e um que não consiga ler fica como está

    HubSpot importa de forma errada, sem erro

    Central de ajuda da HubSpot

    Última verificação: 25 de outubro de 2026

  • O ficheiro deve ser uma única folha CSV, XLSX ou XLS com uma linha de cabeçalho, menos de 1000 colunas e codificado em UTF-8 para caracteres não ingleses.

    HubSpot recusa o arquivo

    Central de ajuda da HubSpot

    Última verificação: 25 de outubro de 2026

  • O ficheiro precisa de uma coluna chamada Email.

    O DocTransform corrige isto: abra o menu ⋯ da coluna → Editar coluna… → clique no nome no alto do painel, troque-o por Email e pressione Enter

    HubSpot recusa o arquivo

    Central de ajuda da HubSpot

    Última verificação: 25 de outubro de 2026

  • Cada Email deve ser um endereço completo, como nome@example.com.

    assinalamos assim que a coluna for marcada como obrigatória (menu ⋯ da coluna → Editar coluna… → Mais opções → Campo obrigatório; o filtro Precisa de carinho sobre a grelha lista cada linha); clicar no cabeçalho da coluna Email → Remover espaços, depois minúsculas, remove espaços e corrige maiúsculas, mas um endereço mal escrito é corrigido por si

    HubSpot ignora a linha

    Central de ajuda da HubSpot

    Última verificação: 25 de outubro de 2026

  • Um Date of birth deve ser escrito como o HubSpot o lê, por exemplo AAAA-MM-DD.

    O DocTransform corrige isto: abra o menu ⋯ da coluna Date of birth → Formatar datas… → saída AAAA-MM-DD (2024-12-31) → Salvar regra

    HubSpot importa de forma errada, sem erro

    Central de ajuda da HubSpot

    Última verificação: 25 de outubro de 2026

  • Um Date of birth como 03/04/2024 pode ser lido com o dia e o mês trocados.

    O DocTransform corrige isto: abra o menu ⋯ da coluna Date of birth → Formatar datas… → escolha a ordem em que as datas estão escritas, saída AAAA-MM-DD → Salvar regra

    HubSpot importa de forma errada, sem erro

    Central de ajuda da HubSpot

    Última verificação: 25 de outubro de 2026

  • Um Lead Status deve ser uma das opções que o seu portal lista, ou o HubSpot deixa-o em branco.

    O DocTransform corrige isto: abra o menu ⋯ da coluna Lead Status → Localizar e substituir…, procure o valor, Substituir por a opção do seu portal, Célula inteira → Substituir tudo

    HubSpot importa de forma errada, sem erro

    Central de ajuda da HubSpot

    Última verificação: 25 de outubro de 2026

  • Os valores múltiplos de Interests são separados por ponto e vírgula, sem espaço ao lado.

    O DocTransform corrige isto: abra o menu ⋯ da coluna Interests → Localizar e substituir…, procure uma vírgula e o espaço depois dela, Substituir por ;, Corresponder a parte da célula → Substituir tudo

    HubSpot importa de forma errada, sem erro

    Central de ajuda da HubSpot

    Última verificação: 25 de outubro de 2026

  • Uma célula com mais de 1 MB faz o HubSpot ignorar a sua linha; encurte os textos muito longos no ficheiro de origem.

    HubSpot ignora a linha

    Central de ajuda da HubSpot

    Última verificação: 25 de outubro de 2026

Antes e depois

8.204 contatos

newsletter_signups.xlsx
EmailFirst namePhone numberEmail subscriptions
Ines@SolyMar.example1Ines Ruiz+34 600-123-4562Newsletter, Events3
ines@solymar.example4Ines Ruiz+34600123456Webinars
marc.bloch@nordic.exampleMarc Bloch+46701234567Newsletter
julia.novak@praha.exampleJulia Novak+420.601.234.567Events
tomas.silva@lisboa.exampleTomas Silva+351 912 345 6785Newsletter, Webinars
anna.keller@wien.exampleAnna Keller+436601234567Webinars
leo.martin@paris.exampleLeo Martin+33 6 12 34 56 78Newsletter

    Corrija no DocTransform

    À mão: 14 passosDocTransform: 1 frase

    1. 1. Carregue newsletter_signups.xlsx no DocTransform.
    2. 2. Escreva

      Coloque Email em minúsculas, remova as linhas com um Email duplicado, substitua a vírgula seguida de um espaço em Email subscriptions por um ponto e vírgula e escreva Phone number como E.164

      e pressione Enviar. Confira os passos que ele adiciona; Desfazer desfaz todos.
      Ou à mão

      Aplique as correções: clique no cabeçalho da coluna Email → minúsculas, depois Remover duplicatas para remover o contacto duplicado; abra o menu ⋯ da coluna Email subscriptions → Localizar e substituir…, procure uma vírgula e o espaço a seguir, substitua por ;, Corresponder a parte da célula → Substituir tudo para juntar os temas que o HubSpot espera. Depois abra Saúde → Telefones escritos de várias formas → Reescrever 4 valores para escrever cada número de telefone como +[código do país][número].

    3. 3. Descarregue o ficheiro limpo como CSV, pronto para o importador do HubSpot.
    “Coloque Email em minúsculas, remova as linhas com um Email duplicado, substitua a vírgula seguida de um espaço em Email subscriptions por um ponto e vírgula e escreva Phone number como E.164” digitada no DocTransform; quatro passos aplicados, uma linha duplicada removida, os temas de Email subscriptions separados por ponto e vírgula, os números de telefone escritos em E.164 com o código do país; Desfazer visível
    1. Escreva a alteração numa frase, com as suas próprias palavras.
    2. Aguarde cerca de 5 segundos enquanto os passos são escritos. Parar cancela.
    3. Confira cada passo e quantas células ou linhas ele altera.
    4. O arquivo está limpo. Não era o que queria? Um Desfazer reverte tudo.

    Guarde esta correção uma vez e volte a executá-la na exportação da próxima semana.

    Corrija à mão no Excel ou Sheets

    1. Clique com o botão direito no cabeçalho da coluna B e escolha Inserir para adicionar uma coluna auxiliar vazia ao lado de Email.
    2. Em B2, escreva =MINÚSCULAS(A2) e prima Enter.
    3. Faça duplo clique na alça de preenchimento no canto inferior direito de B2 para estender a fórmula até à última linha.
    4. Com as células preenchidas da coluna B ainda selecionadas, prima Ctrl+C para as copiar.
    5. Selecione A2, escolha Base → Colar → Colar Especial → Valores e clique em OK, para que Ines@SolyMar.example passe a ines@solymar.example.
    6. Clique com o botão direito no cabeçalho da coluna B e escolha Eliminar para remover a coluna auxiliar.
    7. Clique numa célula da tabela, escolha Dados → Remover Duplicados, clique em Desmarcar Tudo, marque Email e clique em OK para remover a linha repetida de Ines Ruiz.
    8. Clique no cabeçalho da coluna D (Email subscriptions) e escolha Base → Localizar e Selecionar → Substituir.
    9. Escreva uma vírgula e um espaço em Localizar, escreva ; em Substituir por e clique em Substituir Tudo, para que Newsletter, Events passe a Newsletter;Events.
    10. Selecione uma coluna que vai marcar como obrigatória no HubSpot e escolha Base → Localizar e Selecionar → Ir Para Especial → Células em branco → OK.
    11. Escreva à mão um valor em cada célula vazia realçada, e repita ambos os passos para cada coluna obrigatória.
    12. Clique com o botão direito no cabeçalho da coluna C (Phone number), escolha Formatar Células → Texto e clique em OK, para que o Excel mantenha o + inicial.
    13. Reescreva cada número de telefone à mão sem espaços nem pontuação, por exemplo +34 600-123-456 como +34600123456.
    14. Escolha Ficheiro → Guardar Como, selecione CSV UTF-8 (delimitado por vírgulas) (*.csv) e clique em Guardar; se o Excel avisar sobre várias folhas, clique em OK.

    Perguntas

    O DocTransform divide o meu ficheiro se ultrapassar os limites do HubSpot?
    Sim, por linhas. No Export Studio, escolha Dividir em arquivos → Por número de linhas… e defina quantas linhas cada ficheiro tem no máximo: descarrega um .zip e carrega os ficheiros um de cada vez. A divisão é por linhas, não por tamanho; ela não garante que um arquivo fique abaixo de um limite de tamanho: confira cada arquivo antes de enviá-lo.
    O DocTransform sabe que propriedades o HubSpot exige?
    Em parte. Conhece as verificações que o HubSpot publica para um ficheiro de contactos, listadas acima com a data da última verificação. As propriedades obrigatórias do seu próprio portal é você quem as indica: marque-as no painel de saúde, e ele assinala as células vazias.
    Posso reutilizar esta correção da próxima vez?
    Sim — guarde-a uma vez no DocTransform e volte a executá-la na exportação de contactos da próxima semana.
    Experimente esta frase grátis

    Plano grátis, sem cartão.

    Salesforce, HubSpot, Shopify, QuickBooks, Mailchimp, Pipedrive, WooCommerce, Klaviyo, Google Contacts, ActiveCampaign, Brevo, Zendesk, Square, Zoho CRM e Xero são marcas de seus respectivos donos. A DocTransform não é afiliada a elas.