#Como importar contatos, empresas e oportunidades do HubSpot?

Você conecta o HubSpot com uma chave de serviço, escolhe o que trazer e a Clickmax copia os dados. A Clickmax só lê o HubSpot: nada muda lá. A importação não dispara automações, disparos nem webhooks, e você pode repetir depois sem duplicar registros.

Antes de começar

• Para importar: papel de workspace Proprietário ou Administrador, ou Membro com cargo que tenha a permissão Importar de outro CRM. Para conectar a conta, o cargo também precisa de acesso a Integrações. Veja papéis e permissões.
• No HubSpot: ser superadmin ou ter acesso a Ferramentas de desenvolvedor.
• Cada workspace conecta uma conta do HubSpot.
• Só pode haver uma importação em andamento por workspace.

#Criar a chave de serviço no HubSpot

Faça isto no HubSpot, em outra aba.

1. Abra Desenvolvimento > Chaves > Chaves de serviço e clique em Criar chave de serviço.
2. Marque estas permissões, que são obrigatórias: crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read e crm.objects.owners.read.
3. Para trazer também listas, e-mails e arquivos, marque estas: crm.lists.read (listas), sales-email-read (e-mails) e files (arquivos). Sem elas, esses dados ficam de fora e a Clickmax avisa quais.
4. Crie a chave e copie.

Um token de app privado que você já tenha também funciona no lugar da chave de serviço.

#Conectar na Clickmax

1. Abra Integrações > Explorar integrações e selecione o card HubSpot · importar dados.
2. Em Conectar sua conta, cole a chave em Chave de serviço do HubSpot. Use Mostrar chave para conferir o que colou.
3. Clique em Conectar conta.

Conectada, a tela mostra o selo Conectado e a conta do HubSpot. Para trocar a chave, cole a nova e clique em Atualizar chave. Desconectar remove a conexão; o que já foi importado continua na Clickmax.

#Escolher o que trazer

Clique em Importar dados do HubSpot. Também dá para chegar aqui pela lista de contatos: na seta ao lado de Adicionar contato, escolha Importar do HubSpot. A janela tem três passos: Mapear, Conferir e Importar.

No passo Mapear:

1. Responsáveis: escolha o atendente da Clickmax de cada responsável do HubSpot. Quem ficar sem par entra sem responsável, ou com o Responsável padrão se você escolher um. A importação não cria atendentes nem envia convites.
2. Pipelines: cada pipeline do HubSpot pode virar um pipeline novo com as mesmas etapas (Criar pipeline novo) ou ficar de fora (Não importar).
3. Campos, nas abas Contatos, Empresas e Oportunidades:
   • Em contatos e oportunidades, cada campo do HubSpot pode virar um campo novo (Criar campo "…"), ir para um Campo que já existe na Clickmax ou ficar de fora (Não importar).
   • Em empresas, o campo vai para um Campo da Clickmax ou fica de fora. As propriedades personalizadas de empresa são guardadas pela importação (Guardar no histórico da empresa), mas ainda não aparecem na Clickmax.
4. O que trazer: marque Listas, Notas, Tarefas, Ligações, reuniões e e-mails e Arquivos anexados às notas. Opções para as quais a chave não tem permissão aparecem desabilitadas, com o aviso A chave não tem permissão para isso.
5. Quando o contato já existe na Clickmax:
   • Preencher só o que estiver vazio (padrão).
   • Trocar pelos dados do HubSpot.
   • Não mexer no contato.

A Clickmax identifica contatos repetidos por e-mail, telefone ou CPF, com as mesmas regras da importação por planilha.

Clique em Continuar. No passo Conferir, veja os números do HubSpot e quantos contatos, campos e pipelines são novos. Depois clique em Importar.

#O que vem e como fica na Clickmax

#O que não vem

• Produtos das oportunidades (itens de linha).
• As regras das listas ativas.
• Workflows, sequências, modelos de e-mail, formulários, tickets, cotações e objetos personalizados do HubSpot.
• Arquivos acima de 25 MB.
• Propriedades personalizadas de empresa: a importação guarda, mas elas ainda não aparecem na Clickmax.

#Acompanhar, parar e repetir

Você pode fechar a janela: a importação continua e, ao voltar, você vê o andamento por tipo (Lidos, Criados, Já existiam, Ignorados, Falharam).

• Parar: clique em Parar importação. O que já entrou continua na Clickmax.
• Itens que não entraram: clique em Baixar itens não importados. A planilha lista o tipo e o motivo de cada item, com a situação falhou, ignorado ou aviso. aviso quer dizer que o item entrou, mas uma associação (por exemplo, a empresa de um contato) ficou de fora. A planilha mostra até 100.000 linhas; se houver mais, a última linha avisa o total.
• Repetir: importar de novo não duplica nada. Contatos e empresas são atualizados conforme a opção que você escolher em Quando o contato já existe na Clickmax. Oportunidades e históricos que já vieram não são reescritos.

Quando terminar, apague a chave de serviço no HubSpot: cada conta do HubSpot tem um limite de chaves.

#Erros comuns

#Relacionados

• Migrar para a Clickmax
• Migrar a base de contatos