Como importar contatos, empresas e oportunidades do GoHighLevel?
Você conecta uma subconta (location) do GoHighLevel com um token de integração privada, escolhe o que trazer e a Clickmax copia os dados. A Clickmax só lê o GoHighLevel: 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 GoHighLevel: o token precisa ser de uma integração privada criada dentro da subconta. Um token da agência não lê contatos nem oportunidades.
- Cada workspace conecta uma subconta do GoHighLevel. Para trazer outra subconta, conecte a outra depois que a primeira importação terminar.
- Só pode haver uma importação em andamento por workspace.
Criar o token e copiar o ID da location
Faça isto no GoHighLevel, em outra aba, já dentro da subconta.
- Abra Configurações > Integrações privadas e clique em Criar nova integração.
- Dê um nome e marque estes escopos de leitura:
contacts.readonly,opportunities.readonly,users.readonlyelocations.readonlysão obrigatórios.locations/customFields.readonlytraz os campos personalizados,locations/tasks.readonlytraz as tarefas ebusinesses.readonlytraz as empresas.
- Crie a integração e copie o token. O GoHighLevel mostra o token uma vez só.
- Copie o ID da location em Configurações > Perfil da empresa (Business Profile).
Se faltar um escopo opcional, a conexão funciona e aqueles dados ficam de fora. A tela da integração mostra o que ficou de fora.
Conectar na Clickmax
- Abra Integrações > Explorar integrações e selecione o card GoHighLevel · importar dados.
- Em Conectar sua conta, cole o token em Token da integração privada e o ID em ID da location (subconta). Use Mostrar token para conferir o que colou.
- Clique em Conectar conta.
Conectada, a tela mostra o selo Conectado, o nome e o ID da subconta. Para trocar o token, cole o novo token e o ID da location e clique em Atualizar conexão. Desconectar remove a conexão; o que já foi importado continua na Clickmax.
Escolher o que trazer
Clique em Importar dados do GoHighLevel. Também dá para chegar aqui pela lista de contatos: na seta ao lado de Adicionar contato, escolha Importar contatos e, abaixo da área do arquivo, clique em GoHighLevel (no celular, toque antes em +N outros se ele não aparecer). Se a conta já estiver conectada, o chip mostra Conectado e a importação abre ali mesmo, sem sair de Contatos. A janela tem três passos: Mapear, Conferir e Importar.
No passo Mapear:
- Responsáveis: escolha o atendente da Clickmax de cada usuário do GoHighLevel. 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.
- Pipelines: cada pipeline do GoHighLevel pode virar um pipeline novo com as mesmas etapas (Criar pipeline novo) ou ficar de fora (Não importar). A Clickmax acrescenta duas etapas no fim de cada pipeline, Ganho e Perdido, para as oportunidades ganhas, perdidas e abandonadas.
- Campos, nas abas Contatos, Empresas e Oportunidades:
- Em contatos e oportunidades, cada campo do GoHighLevel pode virar um campo novo (Criar campo "…"), ir para um Campo que já existe na Clickmax ou ficar de fora (Não importar). Em oportunidades, aparecem só os campos personalizados: nome, valor, etapa, responsável e status vêm sempre.
- Em empresas, o campo vai para um Campo da Clickmax ou fica de fora.
- O que trazer: marque Notas e Tarefas. Listas, Ligações, reuniões e e-mails e Arquivos aparecem desabilitados, com o aviso O GoHighLevel não oferece estes dados pela API.
- Quando o contato já existe na Clickmax:
- Preencher só o que estiver vazio (padrão).
- Trocar pelos dados do GoHighLevel.
- 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 GoHighLevel e quantos contatos, campos e pipelines são novos. Depois clique em Importar.
Notas em contas grandes
O GoHighLevel só entrega as notas contato por contato: a importação faz uma chamada por contato para ler as notas. Em uma subconta com muitos contatos, isso leva mais tempo e usa boa parte do limite diário de chamadas da subconta. Se as notas não forem importantes, desmarque Notas.
O que vem e como fica na Clickmax
O que não vem
- Listas inteligentes (smart lists): o GoHighLevel não oferece essas listas pela API.
- Conversas e mensagens (SMS, WhatsApp, e-mail) e ligações.
- Arquivos, inclusive os de campos de upload.
- Funis, automações, calendários e agendamentos do GoHighLevel.
- Campos que apontam para outro registro.
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).
O GoHighLevel limita quantas chamadas cada subconta faz por dia, e esse limite é dividido entre todas as integrações da subconta. A importação deixa uma parte do limite livre para as outras integrações continuarem funcionando. Quando o limite acaba, a importação pausa e volta sozinha quando o GoHighLevel libera.
- 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
importacao-gohighlevel-pendencias.csvlista 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. - 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.