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-kommo.md.
  • Português
  • Como importar contatos, empresas e oportunidades do Kommo?

    Você conecta o Kommo com um token de longa duração e o endereço da conta, escolhe o que trazer e a Clickmax copia os dados. A Clickmax só lê o Kommo: nada muda lá. A importação não dispara automações, disparos nem webhooks, e você pode repetir depois sem duplicar registros.

    Esta página é sobre a importação de dados. O card Kommo de webhook, que recebe contatos com tags, é outra integração.

    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 Kommo: só um administrador da conta cria a integração e o token. O token lê os dados com as permissões de quem o criou.
    • Tenha em mãos o endereço da conta, o que aparece no navegador quando você abre o Kommo (por exemplo, suaempresa.kommo.com).
    • Cada workspace conecta uma conta do Kommo.
    • Só pode haver uma importação em andamento por workspace.

    Criar o token

    Faça isto no Kommo, em outra aba.

    1. Entre como administrador e abra Configurações > Integrações > Criar integração.
    2. Crie uma integração privada, sem URL de redirecionamento, e salve. Deixe os escopos como estão: o Kommo marca todos. Se desmarcar Acesso a arquivos, os arquivos ficam de fora da importação.
    3. Na aba Chaves e escopos, clique em Gerar token de longa duração, escolha a validade e copie o token. O Kommo mostra o token uma vez só.

    Escolha uma validade que cubra a importação inteira. Se o token expirar no meio, a importação para e espera um token novo.

    Conectar na Clickmax

    1. Abra Integrações > Explorar integrações e selecione o card Kommo · importar dados.
    2. Em Conectar sua conta, cole o token em Token de longa duração do Kommo. Use Mostrar token para conferir o que colou.
    3. Em Endereço da conta, cole o endereço da conta. Vale suaempresa, suaempresa.kommo.com ou o endereço completo copiado do navegador.
    4. Clique em Conectar conta.

    Conectada, a tela mostra o selo Conectado, o nome da conta e o endereço dela. Se a integração não tem o escopo Acesso a arquivos, um aviso diz que os arquivos ficam de fora. Para trocar o token, cole o novo, informe o endereço 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 Kommo. 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 Kommo (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 Kommo. 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 funil do Kommo pode virar um pipeline novo com as mesmas etapas (Criar pipeline novo) ou ficar de fora (Não importar). As etapas Venda ganha e Venda perdida de cada funil viram as etapas de ganho e de perda do pipeline. Funis arquivados também aparecem.
    3. Campos, nas abas Contatos, Empresas e Oportunidades:
      • Em contatos e oportunidades, cada campo do Kommo 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, Tarefas, Ligações, reuniões e e-mails e Arquivos. No Kommo, Ligações, reuniões e e-mails traz as ligações registradas, e Arquivos traz os arquivos anexados às notas. Sem o escopo Acesso a arquivos, Arquivos aparece desabilitado, com o aviso A chave não tem permissão para isso. Listas aparece desabilitado, com o aviso O Kommo 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 Kommo.
      • 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 Kommo e quantos contatos, campos e pipelines são novos. Depois clique em Importar.

    O que vem e como fica na Clickmax

    No KommoNa Clickmax
    ContatoContato, ligado à empresa dele
    Tag do contatoTag Kommo: <tag>
    EmpresaEmpresa
    LeadOportunidade, ligada aos contatos e à empresa do lead. Os leads em Venda ganha entram como ganhos; os em Venda perdida, como perdidos, com o motivo da perda. Os demais ficam na mesma etapa em que estão no Kommo.
    Funil e etapasPipeline com as mesmas etapas
    UsuárioResponsável, conforme o passo Responsáveis
    Nota de lead, contato ou empresaLinha do tempo, marcada como Importado do Kommo
    Ligação registrada (recebida ou feita)Atividade de ligação na linha do tempo, com a duração
    Tarefa, inclusive reuniãoTarefa, com a data. As concluídas entram como concluídas.
    Arquivo anexado a uma nota, de até 25 MBArquivo da oportunidade ou link na nota

    O que não vem

    • Listas (catálogos) do Kommo: não são listas de contatos.
    • Conversas e chats.
    • Leads excluídos.
    • Produtos dos leads.
    • Arquivos acima de 25 MB, e todos os arquivos se a integração não tiver o escopo Acesso a arquivos.

    Limite de chamadas do Kommo

    O Kommo aceita até 7 chamadas por segundo e bloqueia o acesso por um tempo quando esse limite é passado. A Clickmax faz no máximo 5 chamadas por segundo para ficar abaixo dele. Por isso, contas grandes levam mais tempo para importar. Se o Kommo bloquear mesmo assim, a importação pausa por 30 minutos e volta sozinha.

    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 Kommo...A Clickmax está lendo o Kommo.
    Pronto para importarA leitura terminou.
    Importando para a Clickmax...Os dados estão entrando.
    O Kommo 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 Kommo parou de funcionar…O token expirou ou foi revogado. Gere um token novo no Kommo, clique em Reconectar o Kommo, cole o token 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.
    • 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-kommo-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. Conecte a mesma conta do Kommo da primeira importação.

    Erros comuns

    MensagemO que fazer
    Cole o token de longa duração do KommoO campo do token está vazio. Cole o token.
    Informe o endereço da sua conta Kommo, como suaempresa.kommo.comCopie o endereço que aparece no navegador quando você abre o Kommo. Só endereços kommo.com são aceitos.
    O Kommo recusou o token. Confira se copiou o token inteiro e se ele não expirou.Confira se o token é da mesma conta do endereço informado. Se ele expirou, gere outro em Chaves e escopos.
    O Kommo está limitando as chamadas desta conta. Tente em alguns minutos.Espere alguns minutos e tente de novo.
    A chave do Kommo foi revogada ou expirou. Reconecte em Integrações.Gere um token novo e cole 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 Kommo agora. Tente de novo em alguns minutos.Indisponibilidade do lado do Kommo, ou o endereço não é de uma conta. Confira o endereço e tente de novo mais tarde.

    Relacionados