For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/integrations/import-from-gohighlevel.md.
  • Português
  • 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.

    1. Abra Configurações > Integrações privadas e clique em Criar nova integração.
    2. Dê um nome e marque estes escopos de leitura:
      • contacts.readonly, opportunities.readonly, users.readonly e locations.readonly são obrigatórios.
      • locations/customFields.readonly traz os campos personalizados, locations/tasks.readonly traz as tarefas e businesses.readonly traz as empresas.
    3. Crie a integração e copie o token. O GoHighLevel mostra o token uma vez só.
    4. 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

    1. Abra Integrações > Explorar integrações e selecione o card GoHighLevel · importar dados.
    2. 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.
    3. 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:

    1. 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.
    2. 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.
    3. 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.
    4. 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.
    5. 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

    No GoHighLevelNa Clickmax
    ContatoContato
    Empresa (Business)Empresa, ligada aos contatos dela
    OportunidadeOportunidade, na mesma etapa. As ganhas ficam na etapa Ganho; as perdidas e as abandonadas, na etapa Perdido, com a data da última mudança de status. As perdidas mantêm o motivo da perda; as abandonadas sem motivo recebem o motivo Abandonado.
    Pipeline e etapasPipeline com as mesmas etapas, mais Ganho e Perdido
    UsuárioResponsável, conforme o passo Responsáveis
    Tag do contatoTag GoHighLevel: <tag>
    Nota do contatoLinha do tempo do contato, marcada como Importado do GoHighLevel
    TarefaTarefa, com a data de vencimento. As concluídas entram como concluídas.

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

    SituaçãoO que significa
    Lendo os dados do GoHighLevel...A Clickmax está lendo o GoHighLevel.
    Pronto para importarA leitura terminou.
    Importando para a Clickmax...Os dados estão entrando.
    O GoHighLevel limitou as chamadas. A importação volta às …Não precisa fazer nada. A importação continua sozinha no horário mostrado.
    A chave do GoHighLevel parou de funcionar…Clique em Reconectar o GoHighLevel, cole um token válido e o ID da location e clique em Continuar importação. Ela segue de onde parou.
    Importação concluída.Terminou.
    A importação falhou.Veja Erros comuns.
    Importação parada.Você parou a importação.

    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.csv 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.
    • 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.

    Erros comuns

    MensagemO que fazer
    O GoHighLevel recusou o token. Confira se copiou o token inteiro e se ele é de uma integração privada da subconta.Copie o token de novo. Confira se a integração privada foi criada dentro da subconta, e não na agência.
    O GoHighLevel não encontrou essa location. Confira o ID da subconta.Copie o ID de novo em Configurações > Perfil da empresa da subconta.
    Faltam permissões no token do GoHighLevel: …Crie uma integração privada nova com os escopos obrigatórios e cole o token novo.
    O GoHighLevel atingiu o limite diário de chamadas desta subconta. Tente de novo amanhã.Espere o dia seguinte e tente de novo.
    O GoHighLevel está limitando as chamadas desta subconta. Tente em 1 minuto.Espere um minuto e tente de novo.
    A chave do GoHighLevel foi revogada ou expirou. Reconecte em Integrações.Cole um token válido e o ID da location em Atualizar conexão. Se havia uma importação em andamento, clique em Continuar importação.
    Já existe uma importação em andamento. Aguarde ou cancele antes.Acompanhe a importação atual ou clique em Parar importação.
    Não foi possível falar com o GoHighLevel agora. Tente de novo em alguns minutos.Indisponibilidade do lado do GoHighLevel. Tente de novo mais tarde.

    Relacionados